Piattaforme

Plugin Spigot e Paper

Come ottenere da Codexe il miglior plugin Bukkit, Spigot o Paper in Java o Kotlin: cosa chiedere, versioni, plugin.yml, dipendenze, la build e i problemi comuni.

Aggiornato 30 settembre 2026

In questa pagina

Cosa mettere nella richiesta
Cosa genera Codexe
Versioni e Java
Build e verifica
Installazione
Problemi comuni

I tipi Bukkit/Spigot/Paper producono un plugin per server che gira su Paper, Spigot e sui loro fork. Scegli Java (progetto Maven) o Kotlin (progetto Gradle con build.gradle.kts).

Per giocare il tuo plugin in gioco, avvia un server di prova privato con Provalo subito.

Quando invii la richiesta, Codexe ti chiede per quale versione di Minecraft è il plugin, dalla 1.8.8 alla 26.3. Il codice viene scritto per l'API e il livello di Java di quella versione, e il server di prova gira su quella versione. I progetti creati prima del 30 settembre 2026 mantengono la versione scritta nei loro file di build.

#Cosa mettere nella richiesta

Software del server e versione: "Paper 1.21.4" o "Spigot 1.20.1". Paper ha un'API più ampia di Spigot. Il codice scritto per Spigot gira su Paper, ma non il contrario, quindi chiedi Spigot se ti servono tutti e due.
Comandi con argomenti, chi può usarli e completamento con Tab.
Permessi con i loro valori predefiniti (true, op, false).
Le chiavi di config.yml che vuoi poter modificare.
Salvataggio dei dati: YAML, SQLite, MySQL o in memoria.
Integrazioni: Vault, PlaceholderAPI, LuckPerms, WorldGuard…, nominate esplicitamente così vengono aggiunte come dipendenze.

Richiesta in JavaRichiesta in Kotlin

Text

A Paper 1.21.4 plugin (Java) called Bounties.
- /bounty set <player> <amount>: takes money via Vault, adds it to the player's bounty.
- Killing a player with a bounty pays it to the killer.
- /bounty top shows the 10 highest bounties.
- Bounties stored in SQLite. Minimum bounty 100 (config.yml).
- Permission bounties.set (default true).

Text

A Paper 1.21.4 plugin in Kotlin called Bounties, same features as above.
Use Kotlin idioms (data classes, extension functions) but keep the Bukkit API usage standard.

#Cosa genera Codexe

Un progetto Maven (Java) o Gradle (Kotlin) con la dipendenza dell'API giusta.
La classe principale che estende JavaPlugin, più le classi per comandi, listener e salvataggio dei dati.
plugin.yml con la classe principale, api-version, comandi e permessi, e config.yml quando ci sono impostazioni.

YAML

name: Bounties
version: 1.0.0
main: eu.codexe.bounties.Bounties
api-version: '1.21'
depend: [Vault]
commands:
  bounty:
    description: Manage bounties
permissions:
  bounties.set:
    default: true

#Versioni e Java

Codexe legge la versione di Minecraft dal file di build e compila con Java 17 (prima della 1.20.5), Java 21 (dalla 1.20.5 in poi) o Java 25 (26.x). Se non indichi una versione, viene usata l'API Paper/Spigot 1.20.6.

#Build e verifica

Codexe compila il plugin prima di dichiararlo Pronto e controlla che il JAR contenga le classi e un plugin.yml (o paper-plugin.yml). Le build dei plugin di solito richiedono molto meno di un minuto. Vedi Compila.

#Installazione

Scarica il JAR, mettilo in plugins/, riavvia il server (non usare /reload) e controlla nella console che non ci siano errori all'avvio.

#Problemi comuni

Sintomo	Causa probabile
Il plugin non si carica, "main class not found"	`main:` in `plugin.yml` non corrisponde alla classe. Chiedi alla chat di correggerlo, oppure controlla dopo aver rinominato qualcosa a mano.
"Unsupported API version" su un server più vecchio	Il plugin punta a un'API più recente di quella del tuo server. Indica nella richiesta la versione esatta del tuo server.
Un comando non fa niente	Il comando manca in `plugin.yml`, oppure il giocatore non ha il permesso.
`NoClassDefFoundError` per Vault o simili	Il plugin da cui dipende non è installato sul server.
Si compila, ma una funzione non si comporta bene	Descrivi nella chat il comportamento esatto in gioco. La verifica controlla la build, non il gameplay.