Comment reset ou wiper la map d'un serveur Project Zomboid

Il existe trois façons de reset un serveur Project Zomboid : tout effacer (hard reset), effacer le monde en gardant les personnages (soft reset), ou ne reset que certains chunks. Ce guide couvre les trois, avec les chemins exacts et la méthode pour conserver players.db si vous voulez garder les personnages.

Arrêtez d'abord le serveur. Chaque méthode ci-dessous exige un serveur arrêté. Les modifications faites sur le dossier de sauvegarde d'un serveur en cours d'exécution sont écrasées à l'extinction.

Organisation des fichiers

Une sauvegarde multijoueur Project Zomboid se trouve dans :

/home/container/.cache/Saves/Multiplayer/Pterodactyl/

À l'intérieur, les fichiers et sous-dossiers importants :

Chemin	Ce que c'est
`map_*.bin`	Les chunks du monde (loot, structures, zombies de chaque cellule)
`map_t.bin`	Les données temporelles du monde
`map_zone.bin`	Les définitions de zones (forêt, forêt profonde, urbain)
`map_meta.bin`	Les métadonnées du monde
`players.db`	Tous les personnages, inventaires, compétences et positions
`zpop_*.bin`	La population de zombies par cellule
`reanimated/`	Les zombies réanimés
`vehicles.db`	L'état des véhicules

Le nom du dossier Pterodactyl correspond au nom de votre serveur. Si vous l'avez renommé, le dossier porte un autre nom.

Hard reset : tout effacer

Le reset le plus simple. Les joueurs perdent leurs personnages et le monde se régénère de zéro.

Arrêtez le serveur
Ouvrez le gestionnaire de fichiers et allez dans /home/container/.cache/Saves/Multiplayer/
Supprimez le dossier Pterodactyl (ou renommez-le en Pterodactyl_backup)
Démarrez le serveur : il génère un nouveau monde au premier boot

Durée : immédiat. Les joueurs se reconnectent sur un monde neuf avec des personnages neufs.

Soft reset : garder les personnages, wiper le monde

Les joueurs conservent leurs niveaux, leur inventaire et leurs traits, mais apparaissent sur une map neuve.

Arrêtez le serveur
Allez dans /home/container/.cache/Saves/Multiplayer/Pterodactyl/
Copiez players.db dans un endroit sûr (téléchargez-le en SFTP, par exemple)
Supprimez ou renommez tout le dossier Pterodactyl
Démarrez le serveur, puis arrêtez-le dès que vous voyez SERVER STARTED (cela régénère un dossier Pterodactyl vierge)
Arrêtez de nouveau le serveur
Recollez le players.db sauvegardé dans le nouveau dossier Pterodactyl, en écrasant celui qui est vide
Démarrez le serveur

À la reconnexion, les personnages réapparaissent au point de spawn par défaut, avec toutes leurs stats intactes.

Wiper le monde en gardant la progression de la map : reset des zombies et du loot uniquement

Pratique pour les week-ends "nouveau départ" sans perdre les bases construites. Ce n'est pas une opération en un clic :

Arrêtez le serveur
Dans /home/container/.cache/Saves/Multiplayer/Pterodactyl/, supprimez uniquement :
- zpop_*.bin (remet les populations de zombies à leurs spawns d'origine)
- le dossier reanimated/
Démarrez le serveur avec LootRespawn = 2 dans Pterodactyl_SandboxVars.lua pendant un cycle, puis revenez en arrière

Les constructions des joueurs, le loot qu'ils ont amassé et la map restent en place.

Reset au niveau des chunks : rafraîchir une seule ville

Vous avez saturé une ville de constructions, ou vous voulez juste rafraîchir le loot d'une zone précise :

Repérez les chunks à nettoyer à partir des coordonnées en jeu (appuyez sur F11 pour voir X,Y)
Chaque fichier de chunk s'appelle map_X_Y.bin, où X et Y sont les coordonnées de cellule divisées par 300
- Exemple : un joueur situé en X=10500, Y=8700 se trouve dans le chunk map_35_29.bin
Arrêtez le serveur
Supprimez uniquement les chunks à rafraîchir
Démarrez le serveur : ces chunks se régénèrent à la première visite

Ne supprimez pas les fichiers dont le nom se termine par _player. Ils contiennent les structures construites par les joueurs.

Reset des bans et de la whitelist en gardant le monde

Si vous voulez seulement effacer les bans et la whitelist sans toucher à la map :

Arrêtez le serveur
Supprimez /home/container/.cache/db/Pterodactyl.db
Démarrez le serveur (il régénère une base vierge : aucun ban, aucune whitelist, aucun admin)
Redonnez-vous les droits d'admin avec grantadmin en console

Cela efface bannedid.txt, bannedip.txt et la table SQLite des admins. Faites une sauvegarde d'abord si vous pensez en avoir encore besoin.

Vérifier que le reset a fonctionné

Après le redémarrage, connectez-vous avec un personnage neuf ou avec celui que vous avez conservé. Les points à contrôler :

Le point de spawn correspond à la région de spawn configurée
La densité de loot correspond à vos réglages sandbox FoodLoot et WeaponLoot
Les zombies sont présents dans les quantités attendues
L'heure du jour correspond à votre réglage sandbox StartTime

Si l'un de ces points cloche, le wipe n'est pas passé entièrement, en général parce qu'il vous manque la suppression d'un fichier.

Pièges courants

Les joueurs voient encore leur ancienne base après le reset. Vous avez effacé les map_*.bin mais oublié les fichiers de chunk terminant par _player. Supprimez-les aussi, en sachant que cela détruit tous les murs et structures construits par les joueurs.

Les personnages ont disparu après un "soft reset". Vous avez oublié l'étape de copie de players.db, ou vous l'avez recollé dans le mauvais dossier. Le dossier doit bien être Pterodactyl (ou le nom de votre serveur).

Le reset réussit mais le serveur crashe quand un joueur se connecte. Un mod a cassé pendant le wipe. Regardez /home/container/.cache/Logs/ pour la trace de l'exception et cherchez les références Mod "X".

Le nouveau monde fait toujours spawn aux coordonnées que je veux fuir. Vos régions de spawn sont définies dans Pterodactyl_spawnregions.lua. Reset aussi ce fichier si vous voulez retrouver le sélecteur de région de spawn par défaut.

Sauvegardez avant tout reset

Téléchargez toujours une copie d'abord. Depuis le gestionnaire de fichiers, faites un clic droit sur le dossier Pterodactyl et téléchargez-le. Ou en SFTP :

sftp> get -r /home/container/.cache/Saves/Multiplayer/Pterodactyl /local/backups/

Une sauvegarde multijoueur typique pèse de 50 à 500 Mo selon l'exploration du monde.

FAQ

Le reset affecte-t-il mes mods ? Non. Les mods vivent dans un chemin séparé (/home/container/.cache/Workshop/) et ne sont pas touchés par un reset du monde.

Puis-je reset sans perdre la liste des bans ? Oui. La liste des bans se trouve dans /home/container/.cache/db/Pterodactyl.db (SQLite). Elle est indépendante de la sauvegarde du monde : effacer la map n'y touche pas.

À quelle fréquence faut-il reset un serveur au long cours ? La plupart des serveurs wipent une fois par trimestre. Les réglages sandbox LootRespawn couvrent l'essentiel du besoin de "fraîcheur" sans wipe complet. Ne reset que quand les constructions deviennent ingérables ou que vous voulez un vrai nouveau départ.

Supprimer map_zone.bin remet-il à zéro la répartition des zombies ? En partie seulement. zpop_*.bin est le vrai levier pour la population. map_zone.bin définit la classification forêt/urbain.

Comment reset ou wiper la map d'un serveur Project Zomboid