Versions, Paper, Forge et Fabric

Un serveur Minecraft, ce n’est pas seulement une version du jeu : c’est aussi un moteur, le logiciel qui fait tourner la partie. C’est lui qui décide si vous pourrez installer des plugins, des mods, ou rien du tout. Cette page est pour vous si vous devez choisir avant d’installer, ou si vous voulez changer sans perdre votre monde.

Si votre serveur n’est pas encore démarré, commencez par Installer un serveur Minecraft et revenez ici au moment du choix.

Vanilla, Paper, Purpur : quelles différences

Ces trois moteurs font tourner le même jeu. Ils se distinguent par ce qu’ils acceptent en plus et par leur consommation.

Vanilla est le serveur officiel de Mojang. Il fait exactement ce que fait le jeu solo, rien de plus : aucune extension, aucun réglage avancé, et des performances modestes dès que plusieurs joueurs explorent en même temps. À réserver aux petits serveurs entre amis.

Paper est un dérivé de Vanilla, via CraftBukkit et Spigot. Il apporte deux choses décisives : il accepte les plugins (permissions, protection de zones, économie, minijeux) et il corrige une longue liste de lenteurs du serveur d’origine. C’est le choix par défaut dès que vous accueillez des joueurs que vous ne connaissez pas.

Purpur est un dérivé de Paper. Il garde la compatibilité avec ses plugins et ajoute des centaines de réglages fins : comportement des mobs, règles de jeu, limites par monde. Utile pour modifier le gameplay sans écrire de plugin ; sinon, Paper suffit.

	Vanilla	Paper	Purpur
Plugins	non	oui	oui
Mods	non	non	non
Réglages avancés	très peu	oui	beaucoup
Jeu identique au solo	oui	oui	par défaut, oui

Passer de Vanilla à Paper

C’est la migration la plus simple : même format de monde, même server.properties. Vous pouvez le faire à tout moment, et revenir en arrière aussi longtemps que vous n’avez pas installé de plugin qui crée ses propres données.

Il existe des moteurs répartissant le monde sur plusieurs fils d’exécution, pour les serveurs à très forte fréquentation. Ils cassent la compatibilité avec la plupart des plugins : à éviter sans raison précise.

Forge et Fabric pour les mods

Pour jouer avec des mods — nouveaux blocs, nouvelles dimensions, machines, magie — il faut un chargeur de mods, et le même des deux côtés : serveur et joueurs.

Forge est le plus ancien. C’est l’écosystème des gros modpacks historiques. Pour les versions récentes du jeu, une grande partie des mods est passée à NeoForge, un dérivé de Forge. Les deux ne sont pas interchangeables : un mod NeoForge ne se charge pas sur Forge.

Fabric est plus léger et suit les nouvelles versions du jeu très vite. C’est le terrain des mods d’optimisation et des modpacks récents. La plupart des mods Fabric exigent aussi Fabric API, un mod à installer en même temps. Il existe des dérivés de Fabric, compatibles avec ses mods, mais Fabric reste la référence.

La règle qui évite tous les ennuis : ne choisissez pas le chargeur, laissez le modpack le choisir. Un modpack est publié pour une version du jeu et un chargeur précis. Prenez exactement ceux-là.

Attention

Les mods sont presque toujours nécessaires aussi côté joueur. Vos joueurs devront installer le même chargeur, la même version et la même liste de mods, sinon la connexion est refusée avec un message d’incompatibilité. Prévoyez de leur distribuer le modpack.

Changer de version en toute sécurité

Que vous montiez de version ou que vous changiez de moteur, la procédure est la même. Elle tient en une phrase : sauvegarder, changer, tester, et savoir revenir.

1. Vérifiez d’abord que vos plugins ou vos mods existent dans la version visée. Ce point décide de tout le reste — voir la section suivante.

2. Arrêtez le serveur proprement depuis le panel (Démarrer, arrêter et redémarrer). N’intervenez jamais sur les fichiers d’un serveur en marche.

3. Créez une sauvegarde complète depuis le panel et attendez qu’elle soit terminée (Sauvegardes du serveur de jeu). Téléchargez aussi le dossier world/ en SFTP si le monde compte pour vous (Accéder à son serveur en SFTP).

4. Modifiez le moteur et la version dans la section du panel qui regroupe les paramètres de démarrage, puis relancez le serveur. Il récupère les fichiers nécessaires au démarrage suivant.

5. Suivez la console en direct pendant tout le premier démarrage (Console et logs). C’est là qu’apparaissent les plugins ou les mods refusés.

6. Connectez-vous avant d’annoncer quoi que ce soit. Testez un déplacement, un coffre, et la fonction la plus utilisée de votre serveur.

Danger

Une montée de version est à sens unique pour le monde. Dès qu’un monde a été ouvert par une version plus récente, le remettre sur l’ancienne provoque des corruptions de terrain et des pertes d’inventaire. Le retour en arrière passe par la restauration de la sauvegarde prise à l’étape 3, pas par un changement de version.

Montez les versions une par une plutôt que de sauter de 1.18 à 1.21 d’un coup : si quelque chose casse, vous savez quoi.

Compatibilité des plugins et des mods

C’est le vrai frein à une mise à jour, bien plus que le serveur lui-même.

Les plugins survivent souvent à une montée de version mineure, car Paper conserve une compatibilité large. Mais un plugin non maintenu finit par refuser de se charger, avec un message du type Unsupported API version dans la console. Vérifiez la version annoncée par l’auteur avant de monter.

Les mods ne pardonnent rien : un mod est publié pour une version du jeu et un chargeur donnés, point. Un mod 1.20 ne se charge pas en 1.21. Un modpack se met à jour en bloc, pas mod par mod.

Java. Les versions récentes du jeu demandent une version de Java plus récente. Si la console affiche un message parlant d’une version de classe non supportée, ou demandant explicitement une version de Java, c’est l’environnement d’exécution qui est en cause et pas votre configuration : ouvrez un ticket de support en précisant le moteur et la version visés.

Faites la liste de vos extensions et vérifiez-les une par une avant de décider de monter.

Migrer un monde existant

Vous arrivez d’un autre hébergeur, ou d’une partie solo. Le monde est transportable : c’est un dossier.

1. Récupérez le dossier du monde sur l’ancien serveur, ou dans les sauvegardes de votre jeu pour une partie solo. Il contient level.dat et les dossiers de régions.

2. Arrêtez votre serveur CloudFive et faites-en une sauvegarde, même s’il est vide. Vous aurez un point de retour.

3. Envoyez le dossier à la racine du serveur en SFTP (guide). Le gestionnaire de fichiers du panel accepte aussi les archives, mais le SFTP est plus fiable pour un monde volumineux.

4. Vérifiez que le nom du dossier correspond à la clé level-name de server.properties, ou corrigez la clé.

5. Redémarrez et surveillez la console. Un monde créé par une version plus ancienne est converti au premier chargement : laissez faire, cela peut prendre plusieurs minutes.

• Répertoireworld/

  • level.dat
  • Répertoireregion/

    • …
  • Répertoireplayerdata/

    • …
• Répertoireworld_nether/

  • …
• Répertoireworld_the_end/

  • …

Sur Paper et dérivés, le Nether et l’End vivent dans deux dossiers séparés (world_nether, world_the_end) ; dans une partie solo, ils sont imbriqués dans le dossier du monde, sous DIM-1 et DIM1. Si vos joueurs retrouvent l’Overworld mais pas le Nether, c’est presque toujours cela. Les détails sont dans Gérer son monde.

Si ça ne marche pas

Le serveur ne démarre plus après le changement. Lisez la console du haut vers le bas et arrêtez-vous à la première erreur, pas à la dernière. Le nom du plugin ou du mod fautif y figure presque toujours. Retirez-le, redémarrez, et traitez-le ensuite (Installer des plugins et des mods).

Les joueurs sont refusés avec un message d’incompatibilité. Côté mods, chargeur et liste de mods doivent être identiques des deux côtés. Côté version, le client doit être lancé sur le même profil que le serveur.

Le monde est revenu à son état d’avant, ou le terrain est troué. Vous avez probablement rétrogradé la version. Restaurez la sauvegarde prise avant le changement et remontez sur la version la plus récente des deux.

Un plugin essentiel n’existe pas dans la nouvelle version. Restez sur votre version actuelle : un serveur stable en retard d’une version vaut mieux qu’un serveur à jour sans ses protections. Cherchez un remplaçant maintenu, testez-le, puis montez.

Vous préférez essayer avant de toucher à la production. Montez un second serveur au plus petit palier, migrez dessus, puis résiliez-le : les services CloudFive sont sans engagement (Résilier un service).