Le modpack ne démarre pas ou se bloque au démarrage

Lorsqu'un serveur moddé se bloque en cours de démarrage — la console devient silencieuse et n'atteint jamais « Done » — ou plante au démarrage, il s'agit presque toujours d'un conflit de mods ou d'un mod cassé/obsolète, et non d'un problème avec le serveur lui-même. Voici comment trouver le coupable et redémarrer.

Bloqué ou planté — faites la différence

• Planté : la console affiche une erreur et le processus s'arrête. Vous verrez une trace de pile et souvent un rapport de crash sous crash-reports/.
• Bloqué (figé) : le serveur semble « en ligne » mais ne termine jamais le chargement et personne ne peut le rejoindre. Le journal s'arrête simplement au milieu de l'initialisation. Cela signifie généralement que deux mods se bloquent mutuellement pendant le démarrage.

Les deux sont diagnostiqués de la même manière : lisez le journal et isolez le mod incriminé.

1. Lisez le journal, de haut en bas

Ouvrez la Console, redémarrez, et lisez depuis le début. Pour Forge/NeoForge, le fichier le plus utile est logs/fml-server-latest.log (ouvrez-le dans le Gestionnaire de fichiers). Recherchez la première occurrence de :

ERROR   FATAL   Caused by:   LoadingFailedException   NoClassDefFound

Le premier mod qui génère une erreur est généralement la cause principale. Les mods listés ensuite comme « errored because dependency X errored » ne sont que du bruit en aval — ignorez-les et concentrez-vous sur le premier.

2. Attention aux mods de performance qui se "battent"

Les mods de performance (Redirector, Canary, ModernFix, Rubidium, Embeddium, et similaires) modifient profondément les mécanismes internes du jeu, et les versions obsolètes peuvent se bloquer mutuellement au démarrage — le symptôme classique du « serveur semble en ligne mais est bloqué au milieu de l'initialisation ». Si votre pack s'est bloqué après une mise à jour, ou si vous utilisez des versions de mods datant de quelques mois, ce sont les principaux suspects.

3. Désactivez le mod suspect

Vous n'avez pas besoin de supprimer quoi que ce soit — retirez-le simplement du chemin de chargement :

1. Dans le Gestionnaire de fichiers, ouvrez le dossier mods/.
2. Renommez le fichier jar suspect de quelquechose.jar en quelquechose.jar.disabled. (L'extension .disabled l'empêche de se charger et facilite sa réactivation ultérieure.)
3. Redémarrez et surveillez la console.

S'il démarre maintenant au-delà du point de blocage/crash, vous l'avez trouvé. Sinon, réactivez-le et essayez le suspect suivant. Changez un mod à la fois pour savoir lequel était en cause.

4. Protégez votre monde avant un nouveau départ

Si un monde est corrompu (ou si vous voulez tester un démarrage propre), ne le supprimez pas — archivez-le :

1. Dans le Gestionnaire de fichiers, renommez world en world-broken-<date>.old.
2. Redémarrez. Le serveur génère un nouveau monde et démarre proprement.
3. Votre ancien monde est toujours là si vous voulez le récupérer plus tard.

Attention — la génération de monde est lente avec les gros packs. Après un nouveau départ, un modpack lourd peut passer 5 à 15 minutes en pleine génération de chunks avant d'atteindre « Done » — les mods comme MineColonies ou Alex's Mobs qui scannent les biomes au démarrage sont normaux. Si le CPU travaille réellement (pas bloqué à 0%), donnez-lui du temps avant de supposer qu'il est bloqué.

5. Corrigez le problème correctement : mettez à jour les mods

Désactiver un mod de performance vous coûte quelques FPS mais rien qui ne casse le gameplay, c'est donc une solution temporaire acceptable. La vraie solution est généralement de mettre à jour les mods en conflit — la plupart ont eu des versions correctives qui résolvent ces conflits. Procurez-vous les versions plus récentes pour votre version de Minecraft/loader, déposez-les dans mods/ (en remplaçant les anciens jars), et réactivez tout ce que vous avez désactivé.

Schémas courants

• Se bloque juste après qu'un mod spécifique se connecte : ce mod (ou le suivant à s'initialiser) se bloque — désactivez-le.
• Missing or unsupported mandatory dependencies : un mod de bibliothèque requis est manquant ou la mauvaise version — ajoutez/corrigez-le.
• Incompatible mod set! / version mismatch : un mod est conçu pour une version de Minecraft ou de loader différente de votre pack.
• Plante uniquement lorsqu'un joueur rejoint, pas au démarrage : il s'agit généralement d'une incompatibilité de liste de mods client/serveur — voir Installer un modpack.

Toujours bloqué ?

Ouvrez un ticket de support avec la première erreur de fml-server-latest.log (ou un lien vers le rapport de crash). Nous pouvons examiner directement l'ensemble des mods sur le nœud, désactiver les mods en conflit pour vous, et déposer des versions mises à jour afin que vous puissiez le voir fonctionner.