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 girano senza installazione sul client, mentre le mod con Forge o Fabric spesso devono essere presenti in modo identico sia sul server sia sui PC dei giocatori. Sono decisivi 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 file, stabilisci quale obiettivo vuoi raggiungere. Se vuoi aggiungere permessi, punti home, regioni protette, economy, moderazione o strumenti di amministrazione, i plugin Paper/Spigot sono quasi sempre la scelta adatta. Se invece vuoi introdurre nuovi blocchi, biomi, sistemi tecnici, mob o meccaniche di gioco più profonde, di norma ti servono mod Forge o Fabric.
| Funzione | Plugin (Paper/Spigot) | Mod (Forge/Fabric) |
|---|---|---|
| Installazione | Semplice: JAR in /plugins | JAR in /mods |
| Client necessario? | No | Sì, servono le stesse mod |
| Performance | Migliore | Variabile |
| Compatibilità | Alta | Può creare conflitti |
| Esempi | EssentialsX, WorldEdit | OptiFine, Biomes O Plenty |
La documentazione ufficiale di Paper descrive Paper come software server per Minecraft: Java Edition e, per i plugin, rimanda tra le altre cose all’ecosistema PaperMC. Una fonte primaria naturale per i plugin Paper è quindi Hangar di PaperMC. Per una gestione aggiuntiva dei plugin è utile anche la guida interna più approfondita Installare e gestire plugin Minecraft nel pannello.
Requisiti prima dell’installazione
Controlla prima la versione di Minecraft installata sul tuo server. Un plugin o una mod deve essere compatibile con questa versione e con il software server scelto. Un file per un’altra major version a volte può anche avviarsi, ma non va considerato stabile.
Arresta il server prima di sostituire file JAR. Crea o verifica un backup aggiornato di mondo, configurazione e cartella dei plugin o delle mod. Soprattutto nei setup Forge e Fabric, un singolo conflitto di versioni può impedire l’avvio completo del server.
Fai attenzione anche alle dipendenze. Alcuni plugin richiedono librerie aggiuntive o plugin di base come Vault. Alcune mod richiedono Fabric API, Cloth Config o altre librerie per mod. Di solito queste indicazioni sono riportate sulla pagina del progetto della rispettiva estensione.
Installare plugin con Paper o Spigot
- Scarica il plugin da Hangar o Modrinth.
- Vai nella dashboard del tuo server su game-serverhosting.
- Apri la scheda Mod & Plugin.
- Cerca il plugin desiderato e clicca su Installa, se è disponibile nel pannello.
- 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 che il server è stato avviato una volta con il plugin, altrimenti spesso mancano i valori predefiniti.
I plugin consigliati per iniziare restano i classici 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 – Sistema economy
CoreProtect – Log dei blocchi / anti-grief
Dopo l’installazione non testare solo se il server si avvia. Verifica 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 spesso riguarda i permessi o dipendenze mancanti.
Installare mod con Forge o Fabric
- Assicurati che il tuo server usi Forge o Fabric.
- Scarica la mod da Modrinth o CurseForge.
- Carica il JAR nella cartella
/mods. - Importante: tutti i giocatori devono avere installate le stesse mod.
- Riavvia il server.
Con le mod, l’allineamento delle versioni è particolarmente importante. Server, client dei giocatori, modloader e file delle mod devono combaciare. Se un giocatore vede una lista di mod o un errore di registry durante la connessione, di solito manca una mod sul client, è installata in una versione diversa oppure il client usa il loader sbagliato.
Installa le nuove mod per gradi. Avvia il server dopo poche modifiche e controlla la console. Così trovi i conflitti più velocemente, invece di non sapere più, dopo 30 nuovi file, 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 Valheim con BepInEx o con mod 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 sulla versione. Non ogni avviso è critico, ma devi correggere blocchi di avvio, plugin disattivati e classi mancanti.
In gioco controlla poi funzioni concrete: il mondo si carica correttamente? I giocatori possono entrare? I nuovi comandi funzionano? Vengono mostrati nuovi blocchi, item o menu? Con i plugin testa anche permessi e gruppi. Con le mod, almeno un giocatore dovrebbe connettersi con lo stesso identico modpack.
Troubleshooting degli errori frequenti
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 oppure due estensioni sovrascrivono la stessa funzione.
Conflitto tra mod: rimuovi le mod singolarmente o in piccoli gruppi per trovare il conflitto. Inizia dagli ultimi file installati 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/Fabric, il lato client deve quasi sempre usare le stesse mod.
Lag dopo l’installazione: usa /spark profiler, se Spark è installato, per controllare se un plugin o una mod consuma una quantità anomala di tempo. Disattiva le estensioni che non ti servono e testa di nuovo con azioni realistiche dei giocatori.
Verifica, limiti e ritorno sicuro
La guida “Installare mod e plugin di Minecraft – Guida semplice” vale per il tipo di server descritto nell’articolo e per lo stato delle versioni visibile al momento della verifica. Nomi dei menu, versioni disponibili, compatibilità di mod o plugin e risorse necessarie possono cambiare dopo gli aggiornamenti. Non trasferire quindi valori a un’altra versione di gioco, loader o server senza verificarli.
Prima di modificare mondo, salvataggio, configurazione o estensioni, crea un backup dei file interessati. Poi modifica solo un passaggio coerente alla volta e verificalo con la stessa versione client e server con cui vorrai giocare in seguito.
| Punto di controllo | Risultato atteso | Interruzione e ritorno |
|---|---|---|
| Avvio del server | Il server raggiunge lo stato operativo senza nuovi messaggi di errore. | In caso di errori di avvio, annulla la modifica e ripristina l’ultimo backup. |
| Test di connessione | Un account di test riesce a connettersi tramite l’indirizzo mostrato nel pannello. | In caso di errori di versione o connessione, ricontrolla versione, porta e autorizzazioni. |
| Test funzionale | La funzione modificata lavora correttamente senza danneggiare dati esistenti del mondo o di gioco. | In caso di effetti collaterali, arresta il server e ripristina i file salvati. |
Un singolo test riuscito non è una garanzia di prestazioni o disponibilità. Dimensione del mondo, mod, plugin, numero di giocatori, percorso di rete e carico simultaneo possono cambiare il risultato. Documenta versione, modifica e risultato del test, così potrai capire eventuali differenze future.
FAQ
Posso usare plugin Paper e mod Forge insieme?
Non in un normale setup standard. I plugin Paper/Spigot e le mod Forge/Fabric appartengono a ecosistemi server diversi. Scegli la piattaforma adatta al tuo obiettivo.
I giocatori devono installare i plugin?
Con i classici plugin Paper o Spigot di solito no. I giocatori si connettono con un normale client Minecraft. Le eccezioni possono essere funzioni aggiuntive lato client o resource pack usati opzionalmente da un plugin.
Perché il mio server non si avvia più dopo una mod?
Di solito una versione non combacia, manca una dipendenza o due mod sono incompatibili. Leggi il primo messaggio di errore rilevante nella console e prova a rimuovere l’ultima mod installata.
Dove vanno messi i file JAR?
I plugin vanno in /plugins, le mod in /mods. La cartella corretta non dipende solo dal tipo di file, ma dal software server: Paper/Spigot usa plugin, Forge/Fabric usa mod.
Dovrei installare molte estensioni in una volta sola?
No. Installale a piccoli passi e testa dopo ogni riavvio. Questo rende gli errori tracciabili e impedisce che, in caso di conflitti, tu debba controllare tutti i file contemporaneamente.