Come installare i plugin su Paper, Spigot e Purpur

I plugin aggiungono funzioni al tuo server, come home, claim, ranghi o minigiochi, e girano solo sul server. I tuoi giocatori entrano con il gioco normale e non installano nulla. I plugin funzionano su Paper, Purpur, Spigot e, per i pochi che lo supportano, Folia. Se il tuo server usa Fabric, Forge o NeoForge ti servono invece le mod. Leggi Come installare le mod su Forge, Fabric e NeoForge. Per confrontare i due tipi, leggi I tipi di server Minecraft spiegati.

I plugin hanno pieno accesso al tuo server. Installa solo plugin da fonti di cui ti fidi e fai prima un backup. Leggi Come fare un backup, ripristinare e resettare il tuo mondo Minecraft.

Installa un plugin dalla scheda Modding

La scheda Modding cerca in più cataloghi di plugin contemporaneamente e mette il file nella cartella giusta al posto tuo.

1. Apri il tuo server nel pannello e clicca su Modding.
2. Clicca sulla scheda Plugin. Se non la vedi, il tuo tipo di server non esegue plugin. La scheda lo spiega e indica i tipi che li eseguono.
3. Scrivi il nome del plugin in Cerca plugin e premi Invio. Il menu Ordina per può ordinare i risultati per Più scaricati o Aggiornati di recente.
4. Usa i filtri a sinistra se ti servono. Fonte può essere Tutte le fonti, Modrinth, CurseForge, Hangar, SpigotMC o Polymart. Versione di Minecraft parte dalla versione del tuo server.
5. Clicca su Installa sulla riga che vuoi. Il pannello installa la build più recente per la versione mostrata nel filtro Versione di Minecraft, che parte dalla versione del tuo server. Per ottenere una build più vecchia, cambia quel filtro, oppure scarica tu il jar e caricalo, come descritto sotto. Scegli solo una versione che il tuo server può caricare.
6. Se il plugin ha bisogno di altri plugin per funzionare, si apre una finestra che li elenca, e il suo pulsante dice Installa 2 file o simile. Cliccalo per installare il plugin insieme a ciò che gli serve.
7. Riavvia il server perché carichi il plugin. Il pannello non lo riavvia al posto tuo dopo una singola installazione. Leggi Come avviare, fermare, riavviare e forzare l'arresto del tuo server.

I plugin vengono letti solo all'avvio del server, quindi un plugin che hai installato non fa nulla fino al riavvio.

Cosa significano i badge

Un plugin la cui scheda non nomina la tua versione di Minecraft si installa semplicemente, senza avvisi. Spesso funziona comunque, ma controlla la Console dopo il riavvio.

Un server Paper accetta i plugin indicati per Paper, Spigot o Bukkit. Un server Purpur accetta anche quelli, più i plugin indicati per Purpur. Un server Spigot accetta i plugin indicati per Spigot o Bukkit, quindi un plugin fatto solo per Paper non si installa su di esso.

Installa un plugin caricando il file

Usalo per un plugin che hai scaricato tu, per esempio uno che non è nei cataloghi.

1. Scarica il file .jar del plugin dalla sua pagina ufficiale. Hangar, il sito dei plugin di Paper, è il posto che consiglia la documentazione di Paper. Modrinth è un altro buon posto.
2. Apri il tuo server e clicca su Files.
3. Apri la cartella plugins.
4. Clicca su Carica e scegli il file .jar. Per molti file, usa SFTP. Leggi Come connetterti ai file del tuo server con SFTP.
5. Riavvia il server.

Metti il jar direttamente dentro plugins. La documentazione di Paper dice che i plugin nelle sottocartelle di plugins non vengono caricati. Alcuni plugin sono venduti su siti che non permettono download automatici. Quelli devi scaricarli nel tuo browser e caricarli tu.

Controlla che il plugin si sia caricato

1. Apri la scheda Console e guarda l'avvio. Cerca il nome del plugin e le righe segnate come errori. Il filtro Errori mostra solo quelle.
2. Quando il server è Online, scrivi plugins nella Console e premi Invio. Elenca i plugin che il server conosce. Leggi Come usare la console ed eseguire comandi.

Se il plugin manca o la Console mostra un errore che lo nomina, il plugin è probabilmente fatto per un'altra versione di Minecraft o ha bisogno prima di un altro plugin. Leggi la pagina del plugin per sapere cosa richiede.

Cambia le impostazioni di un plugin

La maggior parte dei plugin crea una cartella con il proprio nome dentro plugins la prima volta che gira, di solito con un config.yml. Aprila da Files, modificala, salva e riavvia il server. La pagina Impostazioni del pannello non elenca i file dei plugin. Elenca i file del server stesso, come Bukkit Settings, Spigot Settings e Purpur Settings, quando esistono.

Aggiorna e rimuovi i plugin

1. Apri Modding, poi Plugin, poi la vista Installati.
2. Un plugin con una build più recente mostra entrambe le versioni, come 2.9.1 → 2.12.1, e un pulsante Aggiorna. Una barra in alto offre di aggiornarli tutti insieme. L'aggiornamento sostituisce solo il file del plugin e lascia stare le sue impostazioni. Il vecchio file viene rimosso quando il nuovo è al suo posto.
3. Per rimuoverne uno, apri il suo menu ... e clicca su Disinstalla. Spunta Elimina anche la sua configurazione e i suoi dati solo se non userai più il plugin. Elimina la cartella del plugin, che contiene le sue impostazioni e ciò che ha salvato, come home o claim.
4. Riavvia il server perché la modifica si applichi.

Non tenere mai due versioni dello stesso plugin in plugins. Il server potrebbe rifiutarsi di caricare entrambe. Il pannello rimuove il vecchio file al posto tuo quando aggiorni, ma un file che hai caricato a mano lo devi rimuovere tu.

Se il server non si avvia dopo un plugin

1. Apri Files, poi plugins, ed elimina l'ultimo plugin che hai aggiunto. Lascia stare la sua cartella delle impostazioni nel caso volessi riavere il plugin.
2. Avvia il server. Se parte, la causa era il plugin.
3. Se continua a fallire, ripristina il backup che hai fatto prima. Leggi Come creare, scaricare e ripristinare i backup.

Per una checklist completa, leggi Come risolvere un server che non si avvia. I plugin e il lag sono trattati in Come ridurre il lag sul tuo server Minecraft.

Buoni plugin da cui iniziare

Sono plugin storici e molto usati, ognuno con la propria pagina su Modrinth o Hangar:

• LuckPerms gestisce ranghi e permessi. Leggi Come rendere operatore te stesso e gestire i permessi.
• EssentialsX aggiunge i comandi di tutti i giorni, come home e warp. Alcuni plugin hanno bisogno di un altro plugin installato accanto. Il pannello li elenca prima di installare.
• WorldEdit modifica rapidamente grandi parti del mondo, per chi costruisce.

Leggi la pagina di ogni plugin per le versioni di Minecraft che supporta prima di installarlo.