Installare mod e plugin per Minecraft – Guida semplice

Ultimo controllo: 26 settembre 2026. Mod e plugin ampliano il tuo server Minecraft, ma non funzionano allo stesso modo: i plugin sono pensati per Paper o Spigot e di solito non richiedono alcuna installazione lato client, mentre le mod con Forge, NeoForge o Fabric spesso devono essere presenti in modo identico sia sul server sia sul PC dei giocatori. Contano soprattutto la versione di Minecraft, il software del server, le dipendenze e un test pulito dopo ogni riavvio.

Plugin o mod: scegliere la base giusta

Prima di caricare i file, stabilisci quale obiettivo vuoi raggiungere. Se vuoi aggiungere permessi, punti home, regioni protette, economia, moderazione o strumenti per gli admin, i plugin per Paper/Spigot sono di solito la strada giusta. Se vuoi inserire nuovi blocchi, biomi, sistemi tecnici, mob o meccaniche di gioco più profonde, di norma ti servono mod Forge, NeoForge o Fabric.

La documentazione ufficiale di Paper descrive Paper come software server per Minecraft: Java Edition e, per i plugin, rimanda tra l'altro all'ecosistema PaperMC. Una fonte primaria ovvia per i plugin Paper è quindi Hangar di PaperMC; la guida ufficiale all'installazione la trovi nella documentazione di Paper, che oltre a Hangar cita anche Modrinth. Per una gestione più completa dei plugin è utile anche la guida interna di approfondimento Installare e gestire i plugin di Minecraft nel pannello.

Requisiti prima dell'installazione

Controlla prima di tutto la versione di Minecraft installata sul tuo server. Un plugin o una mod deve essere adatto a questa versione e al software server scelto. Un file per un'altra versione principale a volte può anche avviarsi, ma non va considerato stabile. Da marzo 2026 Minecraft conta per anno e drop (26.1, 26.2, 26.3 …) invece di 1.21.x; l'ultima vecchia versione è stata la 1.21.11. Molte mod e molti plugin riportano quindi entrambe le notazioni nel loro elenco versioni: confrontale con precisione.

Controlla anche la versione di Java del tuo server. Minecraft dalla 1.18 alla 1.20.4 funziona con Java 17, dalla 1.20.5 alla 1.21.11 serve Java 21, e dalla versione 26.1 di Minecraft (marzo 2026) Java 25 è obbligatorio: Paper, NeoForge e Fabric lo richiedono allo stesso modo. Una mod o un plugin per una nuova versione del gioco non si avvia nemmeno con una versione di Java troppo vecchia. Inoltre, non aggiornare la versione di Minecraft di un server con mod finché ogni mod installata non riporta la nuova versione nel proprio elenco versioni: le mod di contenuto più grandi, dopo un nuovo drop, spesso impiegano da settimane a mesi.

Ferma il server prima di sostituire i file JAR. Crea o verifica un backup aggiornato di mondo, configurazione e cartella dei plugin o delle mod. Soprattutto con Forge, NeoForge e Fabric, un singolo conflitto di versione può impedire al server di avviarsi completamente.

Presta attenzione anche alle dipendenze. Alcuni plugin richiedono librerie aggiuntive o plugin di base come Vault. Alcune mod hanno bisogno di Fabric API, Cloth Config o altre librerie. Queste indicazioni di solito si trovano sulla pagina del progetto della rispettiva estensione.

Installare plugin con Paper o Spigot

1. Scarica il plugin da Hangar o Modrinth: controlla la piattaforma (Paper, Spigot, Purpur) e la versione di Minecraft nell'elenco versioni. Su Modrinth puoi filtrare per piattaforma a sinistra; alcuni progetti offrono la stessa funzione anche come mod Fabric, che per errore finisce nella cartella dei plugin.
2. Vai alla dashboard del tuo server su game-serverhosting.
3. Apri la scheda Mods & Plugins.
4. Cerca il plugin desiderato e clicca su Installa, se è disponibile nel pannello.
5. Riavvia il server.

In alternativa puoi caricare manualmente il file JAR nella cartella /plugins. Dopo il riavvio il plugin di solito crea automaticamente un file di configurazione nella propria sottocartella. Apri questo file solo dopo aver avviato il server una volta con il plugin, altrimenti spesso mancano i valori predefiniti.

I plugin consigliati per chi inizia restano i soliti strumenti di base, ma installa solo ciò che ti serve davvero:

• EssentialsX – funzioni di base (home, warp, kit)
• LuckPerms – sistema di permessi
• WorldGuard – protezione delle regioni
• Vault – ponte API per economia/permessi (richiede un plugin di economia, ad es. EssentialsX)
• CoreProtect – registro dei blocchi / anti-grief

Dopo l'installazione non limitarti a verificare che il server si avvii. Prova in gioco almeno un comando del plugin, l'assegnazione dei permessi e l'output della console. Se un plugin viene caricato ma i comandi sono bloccati, il problema di solito riguarda i permessi o dipendenze mancanti.

Installare mod con Forge, NeoForge o Fabric

Un breve inquadramento: NeoForge dal 2023 è il fork di Forge, portato avanti da quasi tutto il team originale. Per Minecraft 1.21 e versioni successive, la maggior parte delle ex mod Forge pubblica ormai solo build NeoForge; Forge resta la scelta giusta per i modpack più vecchi (ad esempio 1.12.2, 1.16.5 o 1.20.1). Fabric è un ecosistema a sé, leggero: le mod Fabric non funzionano né su Forge né su NeoForge.

1. Assicurati che il tuo server giri con Forge, NeoForge o Fabric, e precisamente con il loader per cui è stata creata la mod. Per Minecraft 1.21 e successivi NeoForge è il successore abituale di Forge; i file Forge e NeoForge non sono più intercambiabili dalla 1.20.2.
2. Scarica la mod da Modrinth o CurseForge, adatta al loader (Forge, NeoForge o Fabric) e alla versione di Minecraft. Un file NeoForge non funziona su un server Forge e viceversa.
3. Carica il JAR nella cartella /mods.
4. Controlla l'indicazione del progetto sul lato client/server. Le mod di gameplay condivise devono essere presenti in versioni compatibili su entrambi i lati; le mod solo server non servono ai giocatori, mentre le mod solo client non vanno sul server dedicato.
5. Riavvia il server.

Con le mod la corrispondenza delle versioni è particolarmente importante. Server, client del giocatore, modloader e file delle mod devono combaciare. Se un giocatore, mentre si connette, vede un elenco di mod o un errore di registry, di solito sul client manca una mod, è installata in un'altra versione o il client usa il loader sbagliato.

Installa le nuove mod gradualmente. Avvia il server dopo poche modifiche e controlla la console. In questo modo trovi i conflitti più in fretta, invece di non sapere più, dopo 30 file nuovi, quale mod impedisce l'avvio. Se lavori spesso con i modloader, procedure simili ti aiutano anche in altri giochi, ad esempio nella guida Installare mod di Valheim con BepInEx o per le mod di V Rising con BepInEx.

Verificare il risultato

Dopo il riavvio la console è il tuo primo punto di controllo. Cerca messaggi come ERROR, WARN, Could not load, Missing dependency o indicazioni sulle versioni. Non ogni avviso è critico, ma interruzioni all'avvio, plugin disattivati e classi mancanti vanno risolti.

In gioco verifica poi funzioni concrete: il mondo si carica correttamente? I giocatori riescono a entrare? I nuovi comandi funzionano? Vengono mostrati i nuovi blocchi, oggetti o menu? Con i plugin testa inoltre permessi e gruppi. Con le mod almeno un giocatore dovrebbe connettersi con lo stesso identico modpack.

Risoluzione dei problemi più comuni

Il plugin non viene caricato: controlla la versione di Minecraft e se il plugin è adatto a Paper/Spigot. Una mod Forge non funziona come plugin Paper, anche se entrambi i file sono JAR.

Il server non si avvia: controlla la console per i messaggi di errore. Spesso mancano dipendenze, un file è stato creato per un'altra versione di Minecraft o due estensioni sovrascrivono la stessa funzione.

Conflitto tra mod: rimuovi le mod una alla volta o in piccoli gruppi per trovare il conflitto. Inizia dai file installati per ultimi e riavvia dopo ogni modifica.

I giocatori non riescono a connettersi: confronta modloader, versione di Minecraft e file delle mod tra server e client. Con Forge, NeoForge e Fabric il lato client di solito deve usare le stesse mod e lo stesso loader.

Lag dopo l'installazione: usa /spark profiler start e, dopo alcuni minuti di gioco, /spark profiler stop, se spark è installato, per verificare se un plugin o una mod consuma una quantità di tempo anomala. Disattiva le estensioni che non ti servono e testa di nuovo con azioni realistiche dei giocatori.

Se nel log compare java.lang.NoClassDefFoundError

java.lang.NoClassDefFoundError: some/Mod/Class

Il percorso dopo i due punti cambia a ogni errore e indica la classe che mancava. Il messaggio significa: una mod voleva usare codice di un altro file e Java non l'ha trovato all'avvio. Strettamente collegata è java.lang.ClassNotFoundException, con lo stesso risultato.

Quasi sempre dietro c'è una di queste cause:

1. Manca una dipendenza. Molte mod richiedono una mod libreria, ad esempio una mod API o Library. Su Modrinth e CurseForge si trova nella pagina della mod sotto "Dependencies" o "Dipendenze".
2. La mod è creata per un'altra versione. Un file per Minecraft 1.20.1 non trova più le sue classi nella 1.21. Lo stesso succede quando mod e dipendenza provengono da versioni diverse.
3. Loader sbagliato. Una mod Fabric su un server NeoForge o un file Forge su NeoForge dalla 1.20.2 in poi fallisce spesso proprio con questo messaggio.
4. Una mod client si trova sul server. Le mod per grafica, menu o minimappe accedono a classi che esistono solo nel client di gioco. Sul server mancano.

Come trovare la mod responsabile

1. Apri latest.log o il crash report e leggi le righe subito sopra e sotto il messaggio. Di solito lì compare il nome della mod che doveva essere caricata.
2. Se il percorso della classe è isolato, spesso il suo inizio rivela il progetto. Se ad esempio inizia con dev/architectury/…, la classe appartiene ad Architectury API.
3. Installa la dipendenza mancante nella versione adatta alla versione di Minecraft e al loader, oppure sostituisci la mod interessata con il file corretto.
4. Se la mod proviene da un modpack client, rimuovila da /mods. Con i modpack usa possibilmente il server pack ufficiale, dove le mod solo client sono già state eliminate.
5. Riavvia e controlla se il messaggio è sparito. Se compare una nuova classe, manca ancora un'altra dipendenza.

Puoi anche incollare l'intero log nel nostro analizzatore di crash report di Minecraft. Evidenzia la riga rilevante.

FAQ

Posso usare contemporaneamente plugin Paper e mod Forge?

Non in una configurazione standard normale. I plugin Paper/Spigot e le mod Forge/NeoForge/Fabric appartengono a ecosistemi server diversi; il team di PaperMC è chiaro in proposito: o mod o plugin. I server ibridi come Mohist o Arclight promettono entrambi, ma sono considerati instabili e non sono supportati dagli sviluppatori di Paper e dei plugin. Scegli la piattaforma più adatta al tuo obiettivo.

I giocatori devono installare i plugin?

Con i classici plugin Paper o Spigot normalmente no. I giocatori si connettono con un normale client Minecraft. Le eccezioni possono essere funzioni aggiuntive lato client o resource pack che un plugin usa in modo opzionale.

Perché il mio server non si avvia più dopo una mod?

Di solito una versione non è adatta, manca una dipendenza o due mod sono incompatibili. Leggi il primo messaggio di errore rilevante nella console e rimuovi, a titolo di prova, l'ultima mod installata.

Dove vanno messi i file JAR?

I plugin vanno in /plugins, le mod in /mods. La cartella giusta non dipende dal solo tipo di file, ma dal software del server: Paper/Spigot usa plugin, Forge/NeoForge/Fabric usa mod. Con Paper il JAR deve trovarsi direttamente in /plugins: le sottocartelle non vengono scansionate.

Devo installare molte estensioni in una volta?

No. Installale a piccoli passi e testa dopo ogni riavvio. Così gli errori sono rintracciabili e, in caso di conflitti, non devi controllare tutti i file contemporaneamente.