Ce guide explique comment basculer votre serveur Project Zomboid entre Build 41 (B41) et Build 42 (B42) via GPanel. Il couvre la compatibilité des sauvegardes, la sauvegarde de votre monde et la réalisation du changement par vous-même.

Avant de changer : comprendre le problème de compatibilité des sauvegardes

Project Zomboid stocke toutes les données du monde et des joueurs dans un dossier de sauvegarde lié à la version du build avec laquelle il a été créé. Les deux builds utilisent des formats différents pour les chunks de carte, les définitions d'objets et les données de personnage des joueurs.

La branche bêta est définie dans l'onglet Startup de votre serveur GPanel.

Une fois le changement effectué, votre serveur démarrera sur un nouveau monde avec le nouveau build. Tout monde existant sur le build précédent sera toujours présent dans le dossier de sauvegarde, mais le serveur ne le chargera pas. Il ne sera pas supprimé automatiquement — il ne sera simplement pas utilisé. Vous devez soit changer le nom de votre serveur, soit supprimer les données de sauvegarde existantes avant de démarrer sur le nouveau build.

Étape 1 — Sauvegarder votre monde actuel

Avant de changer de build, téléchargez une copie de votre sauvegarde actuelle. Même si vous ne prévoyez pas de revenir à l'ancien build, avoir une sauvegarde protège contre la perte accidentelle de données et vous donne quelque chose à restaurer si les circonstances changent.

Option A : Sauvegarde via GPanel

1. Connectez-vous à GPanel et sélectionnez votre serveur Project Zomboid.
2. Arrêtez le serveur en utilisant le bouton Stop dans l'onglet Console et attendez que le statut affiche Offline.
3. Naviguez vers l'onglet Backups dans GPanel.
4. Cliquez sur Create Backup et attendez que la sauvegarde soit terminée. La sauvegarde apparaîtra dans la liste ci-dessous.
5. Une fois la sauvegarde listée, cliquez sur l'icône de téléchargement pour l'enregistrer localement.

Option B : Télécharger le dossier de sauvegarde via SFTP

Si vous souhaitez télécharger uniquement les données de sauvegarde du monde plutôt qu'une sauvegarde complète du serveur, connectez-vous à votre serveur via SFTP et téléchargez le dossier de sauvegarde manuellement.

1. Dans GPanel, allez dans l'onglet SFTP et notez votre nom d'hôte SFTP, port, nom d'utilisateur et mot de passe.
2. Ouvrez un client SFTP tel que FileZilla et connectez-vous avec ces identifiants.
3. Naviguez vers le répertoire de sauvegarde du monde :
   /home/container/.cache/saves/multiplayer/<YourWorldName>/
4. Téléchargez l'intégralité du dossier <YourWorldName> sur votre machine locale.

Étape 2 — Changer le build dans GPanel

Le changement entre B41 et B42 se fait via les options de démarrage de votre serveur. Aucun ticket de support n'est nécessaire.

1. Connectez-vous à GPanel et sélectionnez votre serveur Project Zomboid.
2. Assurez-vous que le serveur est arrêté.
3. Allez dans l'onglet Startup.
4. Localisez le champ Beta Branch :
   • Pour passer à B41 : laissez le champ Beta Branch vide.
   • Pour passer à B42 : entrez unstable dans le champ Beta Branch.
5. Changez le Server Name dans l'onglet Startup pour un nouveau nom différent de l'actuel. Cela empêche le nouveau build d'essayer de charger des données de sauvegarde incompatibles.
6. Allez dans l'onglet Settings et cliquez sur Reinstall Server. Cela télécharge les fichiers de jeu corrects pour le build sélectionné.
7. Démarrez le serveur. Il générera un nouveau monde sous le nouveau nom de serveur.

Compatibilité des mods après le changement

Les mods ne sont pas compatibles entre les builds. Un mod écrit pour B41 ne fonctionnera pas sur B42, et vice versa. Après le changement, vous devrez revoir et remplacer l'intégralité de votre liste de mods.

• Passage de B41 à B42 : La plupart des mods populaires de B41 ont été mis à jour ou remplacés par des versions B42. Vérifiez le Steam Workshop pour les versions spécifiques à B42 des mods que vous utilisiez. Notez que le format WorkshopItems a également changé en B42 — consultez le guide d'installation des mods pour le format correct de B42.
• Passage de B42 à B41 : Les mods B42 ne se chargeront pas sur B41. Vous devez trouver et installer les versions originales B41 de tous les mods que vous souhaitez utiliser. Vérifiez le Steam Workshop pour les auteurs de mods qui maintiennent des branches B41 séparées.

Questions fréquemment posées

Puis-je garder mon monde B41 et aussi avoir un monde B42 ?

Pas sur le même serveur simultanément — une seule instance de serveur exécute un build à la fois. Cependant, vos fichiers de sauvegarde B41 restent sur le disque après le passage à B42. Si vous revenez à B41 à l'avenir et restaurez le nom de serveur d'origine, l'ancienne sauvegarde pourra être chargée à nouveau. Vos données de sauvegarde précédentes sont stockées dans .cache/saves/multiplayer/ et ne sont pas supprimées automatiquement lors d'un changement de build.

Le retour à B41 coûte-t-il quelque chose ?

Non. Le changement de build se fait entièrement via GPanel sans frais supplémentaires. Les emplacements de serveur Project Zomboid B41 et B42 sont au même prix chez Legion Hosting.

Mes joueurs obtiennent une erreur de version incompatible après le changement

Cela signifie que le serveur et le client de jeu du joueur sont sur des versions de build différentes. Les joueurs doivent faire correspondre leur branche bêta Steam avec le build du serveur :

1. Dans Steam, faites un clic droit sur Project Zomboid et sélectionnez Properties.
2. Cliquez sur l'onglet Betas.
3. Dans le menu déroulant, sélectionnez None — cela vous donne le build par défaut actuel (B41).
4. Si le serveur exécute B42, sélectionnez unstable à la place.
5. Attendez que Steam mette à jour le jeu, puis lancez-le et connectez-vous.

Besoin d'aide supplémentaire ?

Si vous rencontrez des problèmes lors du changement, ouvrez un ticket de support et nous vous aiderons.