Installer des mods sur votre serveur Minecraft OneHeberge (avec Wisp)

Ce guide vous explique comment ajouter des mods (Forge/Fabric) ou des plugins (Paper/Spigot) sur votre serveur Minecraft OneHeberge, en passant soit par l’installateur intégré du panel Wisp (recommandé), soit de manière manuelle via le gestionnaire de fichiers/FTP.

Sommaire

• Prérequis & bonnes pratiques
• Installation via le panel Wisp (recommandé)
• Installation manuelle de Forge
• Installation manuelle de Fabric
• Ajouter des mods côté serveur
• Ajouter des plugins (Paper/Spigot)
• Optimisation & mémoire
• Dépannage rapide
• Sauvegardes & maintenance
• FAQ

Prérequis & bonnes pratiques

• ✅ Serveur Minecraft OneHeberge actif et accès au panel Wisp.
• ✅ Sauvegarde de votre monde avant toute modification.
• ✅ Vérifier la compatibilité version (Minecraft + Forge/Fabric + mods).
• ⚠️ Les joueurs doivent avoir les mêmes mods que le serveur (pour les mods côté serveur).

Installation via le panel Wisp (recommandé)

Le panel Wisp utilisé par OneHeberge propose un installateur rapide pour les modpacks, mods et plugins. C’est la méthode la plus simple et la plus sûre.

1) Choisir le type de serveur (loader)

1. Dans Wisp, ouvrez votre serveur → onglet Startup (ou Démarrage).
2. Choisissez le Server JAR : Forge, Fabric, Paper…
3. Validez/Appliquez. Le panel prépare l’environnement automatiquement (premier redémarrage plus long).

2) Installer des mods/plugins en un clic

1. Allez dans l’onglet Mods / Plugins, Marketplace ou One-Click Installer (nom selon thème).
2. Recherchez un mod (Forge/Fabric) ou un plugin (Paper/Spigot), puis cliquez sur Installer.
3. Sélectionnez la version correspondant à votre version de Minecraft/loader.
4. Redémarrez le serveur si nécessaire. Le fichier est placé automatiquement dans /mods ou /plugins.

Astuce : Pour des modpacks complets, utilisez la catégorie dédiée (Modpacks) du marketplace. Wisp installe le bon loader et l’ensemble des dépendances.

3) Mettre à jour / désinstaller

• Depuis la liste des mods/plugins installés, utilisez Update ou Remove.
• Après une mise à jour, redémarrez le serveur.

Installation manuelle de Forge

1. Arrêtez le serveur depuis Wisp.
2. Téléchargez l’installateur Forge pour votre version Minecraft : files.minecraftforge.net.
3. Dans File Manager, uploadez l’installateur Forge ou le server.jar Forge prêt-à-l’emploi.
4. Renommez le JAR de lancement en server.jar si besoin.
5. Dans Startup, vérifiez que le Server JAR pointe sur server.jar, puis démarrez.

Installation manuelle de Fabric

1. Téléchargez le server jar Fabric : fabricmc.net.
2. Uploadez-le dans la racine du serveur et renommez-le server.jar.
3. Installez Fabric API (souvent requis) en plaçant son .jar dans /mods.
4. Démarrez le serveur.

Ajouter des mods côté serveur

Sources fiables

• CurseForge
• Modrinth
• Sites officiels des créateurs

Procédure

1. Vérifiez la version (Minecraft + Forge/Fabric) et les dépendences listées.
2. Dans Wisp → File Manager, ouvrez /mods (créez-le si absent).
3. Uploadez les .jar des mods souhaités.
4. Redémarrez le serveur.

Ajouter des plugins (Paper/Spigot)

1. Assurez-vous d’utiliser un server JAR Paper/Spigot.
2. Installez via l’onglet Plugins (marketplace) ou uploadez dans /plugins.
3. Redémarrez le serveur. Les dossiers de configuration se créent dans /plugins/<plugin>.

Optimisation & mémoire

Mods d’optimisation

• Fabric : Sodium (rendu), Lithium (optimisations), Phosphor (éclairage)
• Forge : AI Improvements, performant équivalents (selon version)

Paramètres recommandés (server.properties)

• view-distance=8
• simulation-distance=8
• max-tick-time=60000

Allocation mémoire (indicatif)

• Starter : -Xms2G -Xmx2G
• Gaming : -Xms4G -Xmx4G
• Pro : -Xms8G -Xmx8G (ou plus selon modpack)

Dépannage rapide

Le serveur ne démarre pas

• Consultez Console et latest.log dans Wisp.
• Retirez le dernier mod ajouté ou corrigez les versions.
• Vérifiez que les dépendances (ex. Fabric API) sont présentes.

Crash à la connexion

• Les joueurs doivent avoir exactement les mêmes mods et versions que le serveur.

Performances faibles

• Réduisez la distance de rendu/simulation.
• Ajoutez des mods d’optimisation (Sodium/Lithium…).
• Augmentez la mémoire si nécessaire.

Sauvegardes & maintenance

• Activez/planifiez des sauvegardes depuis Wisp (ou via tâches programmées).
• Conservez au moins 3 points de restauration récents.
• Testez la restauration périodiquement.

FAQ

• Puis-je utiliser des mods sur Paper/Spigot ? Non, Paper/Spigot utilise des plugins. Pour les mods, utilisez Forge ou Fabric.
• Les joueurs doivent-ils installer les mods ? Oui pour les mods côté serveur ; pas nécessaire pour les plugins.
• Combien de mods puis-je installer ? Selon les ressources de votre offre et la lourdeur des mods/modpacks.

Conclusion

Grâce au panel Wisp de OneHeberge et à son installateur en un clic, ajouter des mods/plugins est simple et rapide. Sauvegardez, vérifiez la compatibilité, installez, redémarrez : votre serveur est prêt !