Guida

Come creare un plugin Paper

Aggiornato il 7 ottobre 2026

Paper è il software per server Minecraft più usato per i plugin: esegue i plugin Spigot e ci aggiunge sopra un'API più ampia e più veloce. Un plugin Paper è un progetto Java (o Kotlin) compilato su paper-api. Ecco cosa serve, a mano o con un'IA che lo compila per te.

Un esempio da cui partire.

Generalo con Codexe

Passo per passo

  1. 1.Scegli la versione di Minecraft

    Usa la versione del tuo server. È lei a decidere la versione di Java: Java 17 prima della 1.20.5, Java 21 dalla 1.20.5, Java 25 per la 26.x.

  2. 2.Crea il progetto

    Un progetto Gradle o Maven con la dipendenza paper-api per quella versione, dal repository di PaperMC, con scope provided/compileOnly.

  3. 3.Scrivi la classe principale

    Una classe che estende JavaPlugin, con onEnable() per registrare comandi e listener.

  4. 4.Descrivi il plugin al server

    plugin.yml (name, version, main, api-version, commands, permissions). Paper supporta anche paper-plugin.yml, con regole di caricamento proprie.

  5. 5.Compila e prova

    Compila il .jar, mettilo nella cartella plugins/ di un server Paper di prova, avvialo e controlla che la console non mostri errori.

Paper o Spigot?

Il codice scritto per la Spigot API gira su Paper, ma non il contrario: Paper aggiunge eventi e metodi (per esempio i componenti di testo Adventure e molte API asincrone) che Spigot non ha. Scrivi per Paper se il tuo server usa Paper; scrivi per Spigot se il plugin deve girare anche su server Spigot.

La via rapida

Su Codexe, scegli un plugin Bukkit/Spigot/Paper, scrivi "Paper" e la versione nella richiesta e descrivi cosa fa. Codexe prepara il progetto con la versione di Java giusta, lo compila, corregge gli errori di build e ti fa entrare in un server Paper di prova con il plugin installato.

Problemi comuni

  • UnsupportedClassVersionError: il plugin è stato compilato con una versione di Java più recente di quella del server.
  • NoSuchMethodError / NoClassDefFoundError: il plugin usa un'API che non esiste nella versione del server, oppure una dipendenza non è stata inclusa (shading) nel .jar.
  • Il plugin si carica ma i comandi non fanno niente: il comando manca nel plugin.yml oppure l'executor non è registrato.

Domande

I plugin Paper funzionano su Purpur o Folia?

Purpur è un fork di Paper, quindi i plugin Paper ci girano. Folia cambia la gestione dei thread: per girare su Folia un plugin deve essere scritto per il suo scheduler a regioni.

Posso scrivere un plugin Paper in Kotlin?

Sì. Codexe può generare un progetto Gradle in Kotlin con build.gradle.kts per la stessa Paper API.

Crea subito un plugin Paper

Questo prompt si apre pronto da inviare:

“Un plugin per Paper 1.21.4 chiamato Bounties: /bounty set <player> <amount> con l'economia di Vault, chi uccide il bersaglio riceve la ricompensa, /bounty list mostra le prime 10 taglie, le taglie restano salvate dopo i riavvii, messaggi in config.yml.”

Generalo con Codexe
Come creare un plugin Paper (Minecraft) | Codexe