Come installare mod sul tuo server Minecraft (Forge/Fabric)

[main/INFO]: Forge mod loading, version 47.2.0
[main/INFO]: MinecraftForge v47.2.0 Initialized

[main/INFO]: Loading Minecraft 1.20.1 with Fabric Loader 0.15.0
[main/INFO]: Loading 4 mods

---

Come scaricare un mod su Modrinth

1. Vai su modrinth.com/mods
2. Utilizza i filtri :
   • Loaders : Forge o Fabric
   • Versions : La tua versione Minecraft
   • Environment : Server (per mod solo server)
3. Clicca sul mod
4. Scheda Versions → Scarica il .jar

---

⚠️ Fabric API (Obbligatorio per Fabric)

Se utilizzi Fabric, devi obbligatoriamente installare Fabric API :

1. Scarica Fabric API su curseforge.com/minecraft/mc-mods/fabric-api
2. Scegli la versione corrispondente al tuo Minecraft
3. Posiziona il file nella cartella mods/

🚨 Senze Fabric API, la maggior parte dei mod Fabric non funzionerà!

---

📤 Passo 3 : Aggiungere i Mod al Server

Metodo 1 : Tramite il Gestore di File OuiPanel

1. In OuiPanel, vai su Gestore di file
2. Naviga verso la cartella mods
   • Se la cartella non esiste, creala
3. Clicca su Upload (o trascina e rilascia)
4. Seleziona i tuoi file .jar
5. Attendi la fine del caricamento.

⚠️ Limite : 100 MB per file. Per file più grandi, utilizza SFTP.

---

Metodo 2 : Tramite SFTP (File voluminosi)

Per mod o modpack voluminosi (> 100 MB), utilizza SFTP :

1. In OuiPanel, vai su Configurazione → Accesso SFTP
2. Annota le informazioni di accesso :
   • Host
   • Porta
   • Nome utente
   • Password
3. Scarica FileZilla o WinSCP
4. Collegati con le tue credenziali
5. Naviga verso la cartella mods/
6. Trasferisci i tuoi file .jar

---

Metodo 3 : Tramite il Mods Manager (Premium)

Se hai un'offerta Premium, puoi utilizzare il Mods Manager integrato :

1. In OuiPanel, vai su Mods Manager
2. Cerca il mod desiderato
3. Clicca su Installa

💡 Questo metodo scarica automaticamente la versione corretta del mod.

---

Metodo 4 : Importa da un URL

1. Nel Gestore di file, naviga verso mods/
2. Clicca su Importa URL
3. Incolla il link diretto al file .jar del mod
4. Clicca su Scarica

---

🔄 Passo 4 : Riavviare il Server

Dopo aver aggiunto i tuoi mod :

1. Vai nella Console
2. Clicca su Arresta per fermare correttamente il server
3. Attendi l'arresto completo
4. Clicca su Avvia

---

Verificare il caricamento dei mod

Nella console, dovresti vedere i tuoi mod caricarsi :

Forge :

[main/INFO]: Found mod file create-1.20.1-0.5.1.jar
[main/INFO]: Found mod file jei-1.20.1-forge-15.2.0.jar
[main/INFO]: Forge mod loading complete, 12 mods loaded

Fabric :

[main/INFO]: Loading 8 mods:
    - fabricloader 0.15.0
    - fabric-api 0.92.0
    - lithium 0.12.0
    - sodium 0.5.8

---

🎮 Mod Popolari Raccomandati

🔧 Mod di Ottimizzazione (Server)

Mod	Loader	Descrizione
Lithium	Fabric	Ottimizza le prestazioni generali
Starlight	Fabric/Forge	Ottimizza il calcolo della luce
FerriteCore	Fabric/Forge	Riduce l'uso di RAM
Chunky	Fabric/Forge	Pre-generazione di chunk
Spark	Fabric/Forge	Profiler delle prestazioni

---

🏗️ Mod di Contenuto (Popolari)

Mod	Loader	Descrizione
Create	Forge/Fabric	Macchine e automazione steampunk
Biomes O'Plenty	Forge/Fabric	Nuovi biomi
Just Enough Items (JEI)	Forge	Visualizzatore di ricette
Applied Energistics 2	Forge/Fabric	Stoccaggio digitale
Tinkers' Construct	Forge	Fabbricazione di strumenti personalizzati
Mekanism	Forge	Tecnologia e energia
Ice and Fire	Forge	Draghi e creature mitiche

---

🎨 Mod Solo Lato Server

Questi mod devono essere installati solo sul server :

Mod	Loader	Descrizione
LuckPerms	Fabric/Forge	Gestione delle autorizzazioni
WorldEdit	Fabric/Forge	Modifica del terreno
Chunky	Fabric/Forge	Pre-generazione del mondo
Simple Voice Chat	Fabric/Forge	Chat vocale in-game
BlueMap	Fabric/Forge	Mappa web 3D

---

🎒 Pacchetto di Mod Performance (Fabric)

Per un server ottimizzato, installa questi mod insieme :

mods/
├── fabric-api-0.92.0+1.20.1.jar     (Obbligatorio)
├── lithium-mc1.20.1-0.11.2.jar      (Prestazioni generali)
├── starlight-1.1.2+fabric.jar       (Luce)
├── ferritecore-6.0.0-fabric.jar     (RAM)
├── krypton-0.2.3.jar                (Rete)
└── chunky-1.3.92.jar                (Pre-generazione)

---

📁 Struttura della Cartella Mods

Ecco come dovrebbe apparire la tua cartella dopo l'installazione :

/
├── mods/
│   ├── fabric-api-0.92.0+1.20.1.jar
│   ├── lithium-mc1.20.1-0.11.2.jar
│   ├── create-1.20.1-0.5.1.jar
│   └── jei-1.20.1-forge-15.2.0.jar
├── config/                           (Config dei mod - auto-generate)
├── world/
├── server.properties
└── forge-1.20.1-47.2.0.jar          (o fabric-server-launch.jar)

---

⚠️ Compatibilità Client/Server

Tipi di mod

Tipo	Installazione	Esempi
Solo server	Solo server	LuckPerms, Chunky, WorldEdit
Solo client	Solo client	Optifine, Shaders, Minimaps
Entrambi	Server E client	Create, JEI, Applied Energistics

🚨 Importante : Se un mod deve essere installato lato client, tutti i giocatori devono averlo!

---

Verificare se un mod è richiesto lato client

Su CurseForge o Modrinth, verifica la dicitura :

• Server = Solo server
• Client = Solo client
• Both / Server & Client = Entrambi richiesti

---

🔧 Risoluzione dei Problemi

Il server non si avvia

Errore	Causa	Soluzione
java.lang.NoClassDefFoundError	Dipendenza mancante	Installa i mod richiesti (es: Fabric API)
Mod X requires Minecraft 1.20.1	Versione incompatibile	Scarica la versione corretta del mod
Duplicate mod ID	Stesso mod duplicato	Rimuovi il duplicato nella cartella mods/
OutOfMemoryError	Non abbastanza RAM	Aumenta la RAM o riduci i mod

---

Errore "Forge/Fabric mismatch"

Error: Mod X requires Forge, but Fabric is installed

Soluzione : Hai installato un mod per il caricatore sbagliato. Scarica la versione corretta (Forge o Fabric).

---

Conflitto di mod

Se il server si arresta dopo aver aggiunto un mod :

1. Arresta il server
2. Rimuovi il ultimo mod aggiunto dalla cartella mods/
3. Riavvia il server
4. Se funziona, il mod era incompatibile
5. Cerca una versione alternativa o un mod simile

---

Trovare la causa di un crash

1. Vai nella Console di OuiPanel
2. Cerca le righe contenenti ERROR o FATAL
3. Identifica il mod menzionato
4. Soluzioni possibili :
   • Aggiorna il mod
   • Controlla le dipendenze
   • Rimuovi il mod incompatibile

---

Mod incompatibili noti

Mod A	Mod B	Problema
Optifine	Sodium	Fare lo stesso lavoro (client)
Alcuni mod	Mohist	Incompatibilità ibrida
Mod vecchi	Nuove versioni	APIs cambiate

---

💡 Buone Pratiche

Da fare ✅

Pratica	Motivo
Fare un backup prima di aggiungere mod	Essere in grado di tornare indietro
Testare i mod uno per uno	Identificare facilmente i problemi
Controllare le versioni	Evita le incompatibilità
Leggere le pagine dei mod	Conoscere le dipendenze
Aggiornare regolarmente	Correzioni di bug e sicurezza

---

Da evitare ❌

Pratica	Rischio
Installare troppi mod in una volta	Difficile da debug
Mischiare Forge e Fabric	Incompatibile
Scaricare da siti non ufficiali	Malware
Ignorare i prerequisiti	Crash
Trascurare la RAM	Server lento o crash

---

📊 RAM Raccomandata

Numero di mod	RAM minima	RAM raccomandata
1-10 mod	2 GB	3-4 GB
10-30 mod	4 GB	6 GB
30-50 mod	6 GB	8 GB
50-100 mod	8 GB	10-12 GB
Grande modpack	10 GB+	12-16 GB

---

📝 Riepilogo

INSTALLARE MOD SU OUIPANEL :

1. INSTALLARE IL MOD LOADER
   ├── OuiPanel → Gestore Versioni
   ├── Scegliere Forge o Fabric
   ├── Selezionare la versione di Minecraft
   └── Cliccare su Installa

2. SCARICARE I MOD
   ├── CurseForge o Modrinth
   ├── Filtrare per versione E mod loader
   ├── Scaricare i file .jar
   └── ⚠️ Fabric API obbligatorio per Fabric !

3. CARICARE I MOD
   ├── OuiPanel → Gestore file
   ├── Navigare verso /mods/
   ├── Caricare i file .jar
   └── (o utilizzare SFTP per file di grandi dimensioni)

4. RIAVVIARE
   ├── Console → Arrestare
   ├── Attendere l'arresto completo
   └── Avviare

REGOLE DI COMPATIBILITÀ :
├── Versione Minecraft = Versione del mod
├── Mod Loader = Tipo di mod (Forge ≠ Fabric)
├── Fabric API = Obbligatorio per Fabric
└── Client/Server = Controllare i requisiti

RISOLUZIONE RAPIDA DEI PROBLEMI :
├── Crash all'avvio → Controllare le versioni
├── Mod non caricato → Controllare le dipendenze
├── Conflitto → Rimuovere l'ultimo mod aggiunto
└── OutOfMemory → Aumentare la RAM

---

📚 Risorse Utili

Risorsa	URL
CurseForge	curseforge.com/minecraft/mc-mods
Modrinth	modrinth.com/mods
Forge	files.minecraftforge.net
Fabric	fabricmc.net
Wiki Fabric	fabricmc.net/wiki