Come usare: generatore di plugin.yml per Spigot e Paper
plugin.yml è il piccolo file YAML che dice a Spigot, Paper e Purpur come caricare il tuo plugin: nome, classe principale, versione, API target, comandi e permessi. Questo generatore compila i campi usuali così non devi scrivere a mano YAML fragile dopo ogni rinomina del progetto. Non scrive Java, non compila un jar, né corregge un percorso di classe principale errato.
Inserisci il nome del plugin, la classe principale, la versione, autori opzionali, descrizione, sito web, api-version, liste depend/softdepend, poi comandi e permessi se ti servono. La pagina genera un plugin.yml che puoi scaricare o incollare in src/main/resources. Questo rende rapide sia la prima configurazione sia le correzioni del tipo "mi serve solo un altro comando in /help".
Non scrive il codice del tuo plugin. Se un comando è elencato qui ma non è mai registrato in Java, i giocatori vedranno una voce rotta. Se la classe principale non corrisponde al pacchetto che hai compilato, il server rifiuterà di abilitare il plugin. Tratta il file come metadati, non come un installatore magico.
api-version dovrebbe essere vicino alla versione di Minecraft contro cui compili, così Paper può avvisare su API incompatibili. depend e softdepend aiutano solo se quei plugin esistono davvero sul server di destinazione. Nomi sbagliati qui non scaricano nulla; cambiano solo l'ordine di caricamento e il comportamento di abilitazione.
Ogni comando può avere una descrizione, una riga di utilizzo e un nodo permesso. Ogni permesso può impostare un default (op, true, false, not op). Mantieni i nomi stabili una volta che giocatori e gruppi LuckPerms iniziano a usarli; rinominare un nodo dopo significa migrare le configurazioni sui server live.
In un normale progetto Maven o Gradle il file sta sotto resources così finisce alla radice del jar come plugin.yml. Dopo una ricompilazione, conferma che il jar contenga ancora quel file prima di dare la colpa al generatore. I pannelli di hosting che caricano "cartelle di plugin" hanno comunque bisogno di un jar vero per i plugin stile Spigot.
FAQ su Plugin Yml
Questo scrive Java per me?
No. Solo plugin.yml. Devi comunque scrivere codice, compilare e distribuire il jar da solo.
Paper o Spigot?
I campi di base sono della stessa famiglia. Imposta api-version alla versione che supporti e testa sul tuo jar reale.
Dove metto il file?
Di solito in src/main/resources/plugin.yml così finisce alla radice del jar.
Perché il plugin non si abilita?
Classe principale sbagliata, depend mancante o errore di caricamento in onEnable. Controlla il log del server dopo che il file sembra corretto.
Posso modificare il YAML dopo il download?
Sì. Il generatore è un punto di partenza. Tieni una copia in git con il resto del progetto.