Comment installer des mods ou un modpack sur mon serveur ?

Les mods modifient le gameplay de Minecraft en profondeur : nouveaux blocs, créatures, dimensions et mécaniques. Contrairement aux plugins, ils nécessitent un mod loader (Forge, Fabric ou NeoForge) aussi bien sur le serveur que sur le client des joueurs.

Choisir le bon mod loader

• Forge : le plus ancien et le plus compatible. La majorité des gros modpacks (CurseForge) utilisent Forge.
• Fabric : plus léger et plus rapide à mettre à jour. Populaire pour les mods d'optimisation (Sodium, Lithium) et les packs récents.
• NeoForge : fork communautaire de Forge depuis la 1.20.1, qui reprend progressivement l'écosystème Forge sur les versions récentes.

Vérifiez toujours pour quel loader vos mods sont conçus ; un mod Forge ne fonctionne pas sous Fabric et inversement.

Installer le mod loader

1. Dans le panneau de jeu, ouvrez l'onglet Startup.
2. Sous Server Jar, sélectionnez Forge, Fabric ou NeoForge.
3. Choisissez la version de Minecraft correspondant à vos mods.
4. Redémarrez le serveur. Le loader s'installe automatiquement et crée le dossier mods.

Ajouter des mods individuels

1. Téléchargez les fichiers .jar de vos mods depuis CurseForge ou Modrinth. Vérifiez la version de Minecraft et le loader.
2. Envoyez les fichiers dans le dossier mods via l'onglet Files ou en SFTP.
3. Redémarrez le serveur.

Installer un modpack complet

1. Téléchargez le pack serveur (souvent un zip nommé "Server Pack" ou "Server Files") depuis la page du modpack.
2. Arrêtez le serveur et supprimez les fichiers existants, sauf le dossier de votre monde si vous voulez le conserver.
3. Envoyez le contenu du zip en SFTP dans le dossier racine du serveur.
4. Vérifiez dans l'onglet Startup que le loader et la version de Minecraft correspondent à ceux du pack.
5. Redémarrez le serveur.

Synchronisation client-serveur

Les joueurs doivent installer exactement les mêmes mods (mêmes versions) sur leur propre client. Les mods uniquement client (shaders, minimaps) n'ont pas besoin d'être sur le serveur, et les mods uniquement serveur n'ont pas besoin d'être chez le joueur. Le modpack indique généralement quels mods sont côté serveur.

Un mod provoque un crash au démarrage ? Consultez le fichier logs/latest.log pour identifier le mod en cause. Des questions ? Ouvrez un ticket de support avec le log.