[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

---

Comment télécharger un mod sur Modrinth

1. Allez sur modrinth.com/mods
2. Utilisez les filtres :
   • Loaders : Forge ou Fabric
   • Versions : Votre version Minecraft
   • Environment : Server (pour mods serveur uniquement)
3. Cliquez sur le mod
4. Onglet Versions → Téléchargez le .jar

---

⚠️ Fabric API (Obligatoire pour Fabric)

Si vous utilisez Fabric, vous devez obligatoirement installer Fabric API :

1. Téléchargez Fabric API sur curseforge.com/minecraft/mc-mods/fabric-api
2. Choisissez la version correspondant à votre Minecraft
3. Placez le fichier dans le dossier mods/

🚨 Sans Fabric API, la plupart des mods Fabric ne fonctionneront pas !

---

📤 Étape 3 : Ajouter les Mods au Serveur

Méthode 1 : Via le Gestionnaire de Fichiers OuiPanel

1. Dans OuiPanel, allez dans Gestionnaire de fichiers
2. Naviguez vers le dossier mods
   • Si le dossier n'existe pas, créez-le
3. Cliquez sur Upload (ou glissez-déposez)
4. Sélectionnez vos fichiers .jar
5. Attendez la fin du téléversement.

⚠️ Limite : 100 Mo par fichier. Pour les fichiers plus gros, utilisez le SFTP.

---

Méthode 2 : Via SFTP (Fichiers volumineux)

Pour les mods ou modpacks volumineux (> 100 Mo), utilisez le SFTP :

1. Dans OuiPanel, allez dans Configuration → Accès SFTP
2. Notez les informations de connexion :
   • Hôte
   • Port
   • Nom d'utilisateur
   • Mot de passe
3. Téléchargez FileZilla ou WinSCP
4. Connectez-vous avec vos identifiants
5. Naviguez vers le dossier mods/
6. Transférez vos fichiers .jar

---

Méthode 3 : Via le Mods Manager (Premium)

Si vous avez une offre Premium, vous pouvez utiliser le Mods Manager intégré :

1. Dans OuiPanel, allez dans Mods Manager
2. Recherchez le mod souhaité
3. Cliquez sur Installer

💡 Cette méthode télécharge automatiquement la bonne version du mod.

---

Méthode 4 : Import depuis une URL

1. Dans le Gestionnaire de fichiers, naviguez vers mods/
2. Cliquez sur Import URL
3. Collez le lien direct vers le fichier .jar du mod
4. Cliquez sur Télécharger

---

🔄 Étape 4 : Redémarrer le Serveur

Après avoir ajouté vos mods :

1. Allez dans la Console
2. Cliquez sur Arrêter pour arrêter proprement le serveur
3. Attendez l'arrêt complet
4. Cliquez sur Démarrer

---

Vérifier le chargement des mods

Dans la console, vous devriez voir vos mods se charger :

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

---

🎮 Mods Populaires Recommandés

🔧 Mods d'Optimisation (Serveur)

Mod	Loader	Description
Lithium	Fabric	Optimise les performances générales
Starlight	Fabric/Forge	Optimise le calcul de lumière
FerriteCore	Fabric/Forge	Réduit l'utilisation de RAM
Chunky	Fabric/Forge	Pré-génération de chunks
Spark	Fabric/Forge	Profiler de performances

---

🏗️ Mods de Contenu (Populaires)

Mod	Loader	Description
Create	Forge/Fabric	Machines et automatisation steampunk
Biomes O'Plenty	Forge/Fabric	Nouveaux biomes
Just Enough Items (JEI)	Forge	Visualiseur de recettes
Applied Energistics 2	Forge/Fabric	Stockage numérique
Tinkers' Construct	Forge	Fabrication d'outils personnalisés
Mekanism	Forge	Technologie et énergie
Ice and Fire	Forge	Dragons et créatures mythiques

---

🎨 Mods Côté Serveur Uniquement

Ces mods n'ont besoin d'être installés que sur le serveur :

Mod	Loader	Description
LuckPerms	Fabric/Forge	Gestion des permissions
WorldEdit	Fabric/Forge	Édition de terrain
Chunky	Fabric/Forge	Pré-génération de monde
Simple Voice Chat	Fabric/Forge	Chat vocal in-game
BlueMap	Fabric/Forge	Carte web 3D

---

🎒 Pack de Mods Performance (Fabric)

Pour un serveur optimisé, installez ces mods ensemble :

mods/
├── fabric-api-0.92.0+1.20.1.jar     (Obligatoire)
├── lithium-mc1.20.1-0.11.2.jar      (Performances générales)
├── starlight-1.1.2+fabric.jar       (Lumière)
├── ferritecore-6.0.0-fabric.jar     (RAM)
├── krypton-0.2.3.jar                (Réseau)
└── chunky-1.3.92.jar                (Pré-génération)

---

📁 Structure du Dossier Mods

Voici à quoi doit ressembler votre dossier après installation :

/
├── 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/                           (Configs des mods - auto-générées)
├── world/
├── server.properties
└── forge-1.20.1-47.2.0.jar          (ou fabric-server-launch.jar)

---

⚠️ Compatibilité Client/Serveur

Types de mods

Type	Installation	Exemples
Serveur uniquement	Serveur seulement	LuckPerms, Chunky, WorldEdit
Client uniquement	Client seulement	Optifine, Shaders, Minimaps
Les deux	Serveur ET clients	Create, JEI, Applied Energistics

🚨 Important : Si un mod doit être installé côté client, tous les joueurs doivent l'avoir !

---

Vérifier si un mod est requis côté client

Sur CurseForge ou Modrinth, vérifiez la mention :

• Server = Serveur uniquement
• Client = Client uniquement
• Both / Server & Client = Les deux requis

---

🔧 Dépannage

Le serveur ne démarre pas

Erreur	Cause	Solution
java.lang.NoClassDefFoundError	Dépendance manquante	Installez les mods requis (ex: Fabric API)
Mod X requires Minecraft 1.20.1	Version incompatible	Téléchargez la bonne version du mod
Duplicate mod ID	Même mod en double	Supprimez le doublon dans mods/
OutOfMemoryError	Pas assez de RAM	Augmentez la RAM ou réduisez les mods

---

Erreur "Forge/Fabric mismatch"

Error: Mod X requires Forge, but Fabric is installed

Solution : Vous avez installé un mod pour le mauvais loader. Téléchargez la version correcte (Forge ou Fabric).

---

Conflit de mods

Si le serveur crash après avoir ajouté un mod :

1. Arrêtez le serveur
2. Retirez le dernier mod ajouté du dossier mods/
3. Redémarrez le serveur
4. Si ça fonctionne, le mod était incompatible
5. Cherchez une version alternative ou un mod similaire

---

Trouver la cause d'un crash

1. Allez dans la Console OuiPanel
2. Cherchez les lignes contenant ERROR ou FATAL
3. Identifiez le mod mentionné
4. Solutions possibles :
   • Mettre à jour le mod
   • Vérifier les dépendances
   • Supprimer le mod incompatible

---

Mods incompatibles connus

Mod A	Mod B	Problème
Optifine	Sodium	Faire le même travail (client)
Certains mods	Mohist	Incompatibilité hybride
Vieux mods	Nouvelles versions	APIs changées

---

💡 Bonnes Pratiques

À faire ✅

Pratique	Raison
Sauvegarder avant d'ajouter des mods	Pouvoir revenir en arrière
Tester les mods un par un	Identifier les problèmes facilement
Vérifier les versions	Éviter les incompatibilités
Lire les pages des mods	Connaître les dépendances
Mettre à jour régulièrement	Corrections de bugs et sécurité

---

À éviter ❌

Pratique	Risque
Installer trop de mods d'un coup	Difficile à débuguer
Mélanger Forge et Fabric	Incompatible
Télécharger depuis des sites non officiels	Malwares
Ignorer les prérequis	Crashes
Négliger la RAM	Serveur lent ou crash

---

📊 RAM Recommandée

Nombre de mods	RAM minimale	RAM recommandée
1-10 mods	2 Go	3-4 Go
10-30 mods	4 Go	6 Go
30-50 mods	6 Go	8 Go
50-100 mods	8 Go	10-12 Go
Gros modpack	10 Go+	12-16 Go

---

📝 Récapitulatif

INSTALLER DES MODS SUR OUIPANEL :

1. INSTALLER LE MOD LOADER
   ├── OuiPanel → Gestionnaire de Versions
   ├── Choisir Forge ou Fabric
   ├── Sélectionner la version Minecraft
   └── Cliquer sur Installer

2. TÉLÉCHARGER LES MODS
   ├── CurseForge ou Modrinth
   ├── Filtrer par version ET mod loader
   ├── Télécharger les fichiers .jar
   └── ⚠️ Fabric API obligatoire pour Fabric !

3. UPLOADER LES MODS
   ├── OuiPanel → Gestionnaire de fichiers
   ├── Naviguer vers /mods/
   ├── Upload les fichiers .jar
   └── (ou utiliser SFTP pour gros fichiers)

4. REDÉMARRER
   ├── Console → Arrêter
   ├── Attendre l'arrêt complet
   └── Démarrer

RÈGLES DE COMPATIBILITÉ :
├── Version Minecraft = Version du mod
├── Mod Loader = Type de mod (Forge ≠ Fabric)
├── Fabric API = Obligatoire pour Fabric
└── Client/Serveur = Vérifier les requirements

DÉPANNAGE RAPIDE :
├── Crash au démarrage → Vérifier versions
├── Mod non chargé → Vérifier dépendances
├── Conflit → Retirer le dernier mod ajouté
└── OutOfMemory → Augmenter la RAM

---

📚 Ressources Utiles

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