Project Zomboid Commandes admin serveur et outils

Faire tourner un serveur dédié Project Zomboid signifie répondre à la même poignée de questions chaque week-end : comment téléporter un joueur perdu en arrière, comment réinitialiser une valeur sandbox sans redémarrage complet, et quelle est la bonne façon d’émettre des restocks pendant un événement public. Le Build 42.20.4 stable (hotfix de sécurité du 26 août 2026) a supprimé loadstring / loadstream des contextes Lua, donc certains vieux mods admin qui hot-rechargeaient du code nécessitent maintenant une reconstruction explicite. Ce guide couvre le panneau de triche par défaut, le mod Admin Tools de la communauté, les commandes de reload sandbox, la modération des joueurs, et l’étiquette patch-aware pour les hébergeurs.

Pour la configuration serveur, combine cette page avec Serveurs dédiés et Serveurs et coop. Pour le tuning sandbox, voir Paramètres sandbox.

Accès admin en jeu par défaut

Les serveurs Project Zomboid activent l’accès admin via server-options.ini et la whitelist de compte joueur. Le jeu de base supporte un canal admin piloté par le chat pour les hébergeurs uniquement.

Étapes de configuration :

1. Ajoute le nom de ton compte Steam ou GOG à la section admin de la config serveur.
2. Définis AdminUsername et Password pour un accès protégé par mot de passe sur les boxes louées.
3. Redémarre le serveur, puis connecte-toi. Ton prompt de chat gagne le tag admin dans les UIs Serveurs et coop.
4. Tape !help dans le canal admin pour voir les commandes disponibles sur ton build actuel.

Les commandes par défaut varient selon le patch ; le panneau de triche peut être verrouillé derrière une option serveur pour les hébergements loués. Vérifie toujours d’abord les docs admin de ton fournisseur d’hébergement - certaines entreprises restreignent !additem et les commandes similaires.

Project Zomboid server admin commands and sandbox tools

Panneau de triche : la trousse à outils admin orientée survie

Le panneau de triche vanilla s’ouvre avec la commande chat !cheats (hébergeur uniquement). Il expose les mêmes toggles que les admins utilisaient à la création du monde, plus plusieurs qui ont migré dans la sandbox après le Build 42. Utilise-le pour :

• !toggle pour basculer les cheats courants comme Build (construction gratuite), NoClip, ou Invisible.
• !additem <objet> <quantité> pour donner des objets à toi-même ou à un joueur cible.
• !godmode pour tester l’équilibre des combats sans mourir.
• !time pour régler l’heure en jeu pendant les événements planifiés.
• !weather pour vider la pluie ou déclencher des tempêtes pour les tests.

Le panneau de triche n’accorde pas automatiquement l’admin à d’autres joueurs. C’est ton outil hébergeur uniquement pour les tests et le support en direct.

Mod Admin Tools : fonctionnalités puissantes de la communauté

La mod Admin Tools maintenue par la communauté (par Whicker, actuellement la mod principale du Steam Workshop pour les releases compatibles B42.x) étend le panneau de triche avec des contrôles de qualité serveur hébergé plus sûrs. Après le Build 42.20.4, elle est livrée sans loadstring et fonctionne sur la nouvelle baseline de sécurité.

Commandes notables :

• !additem <NomJoueur> <NomObjet> <Quantité> - accorde des objets sans quitter l’inventaire de l’admin.
• !addxp <NomJoueur> <NomCompétence> <Niveau> - monte une compétence de survivant pour les tests ou événements.
• !teleport <NomJoueur> <x,y> - déplace les joueurs en arrière à la base ou à un refuge connu.
• !removezombies - efface tous les zombies dans le chunk actuel. Utile en plein événement quand le déchargeur de chunk échoue.
• !restock - réinitialise les états de conteneurs globalement.
• !kick <NomJoueur> et !ban <NomJoueur> - modération des joueurs.
• !saveworld - force une sauvegarde hors de l’intervalle d’autosave.

Confirme la version installée contre ton build serveur : les hotfixes 42.20.4 ont changé les permissions Lua, donc les anciens builds du mod Admin Tools lanceront des erreurs. Mets à jour le mod via le Workshop ou ton dossier de téléchargement manuel avant de passer en live.

Reload sandbox sans redémarrage

La commande !reloadoptions recharge SandboxVars.lua sans redémarrer le serveur. Utilise-la après avoir ajusté une seule valeur (fréquence de migration des zombies, fenêtre de jour d’événement hélicoptère, heures de réappro de loot) pour que les joueurs ne voient pas de pop de déconnexion.

Meilleures pratiques :

• Annonce toujours !reloadoptions sur Discord avant de l’exécuter. Certains changements sandbox affectent les populations de zombies.
• Combine avec la documentation Paramètres sandbox pour ne pas activer accidentellement un paramètre qui casse ta sauvegarde.
• Fais une sauvegarde avec Sauvegarde avant tout reload en direct.

Si ton serveur n’a pas !reloadoptions, cela signifie que le panneau de triche sous-jacent est verrouillé par le fournisseur d’hébergement. La plupart des grands hébergeurs (G-Portal, Apex, Bisect) l’activent par défaut ; les hébergeurs plus petits peuvent nécessiter une demande.

Gestion des chunks et commandes de performance

L’extension de carte du Build 42.20 a approximativement doublé la zone jouable. Les serveurs qui préexistaient à la ligne 42.20 rencontrent souvent des problèmes de chargement de chunk quand les groupes conduisent sur de longues distances. Commandes utiles :

• !chunkreload - force un reload du chunk autour de la position de l’admin. Utile quand les textures deviennent grises.
• !vehicles - liste tous les véhicules actifs en mémoire, utile quand les véhicules disparaissent ou se dupliquent. Le hotfix 42.20.1 a déjà amélioré cela, mais une liste manuelle aide toujours après désync.
• !players - liste les joueurs en ligne et leurs coordonnées.
• !gc (garbage collect) - demande au runtime Java de libérer la mémoire. Exécute après une longue session.

Combine avec Configuration requise quand les joueurs rapportent des crashes. Les correctifs de fuite mémoire du patch 42.20.3 ont aidé, mais les longues saisons ont quand même besoin d’un !gc occasionnel.

Modération des joueurs

La trousse admin inclut : !kick, !ban, !mute, et !unmute. Combine-les avec un code de conduite écrit posté sur le Discord de ton serveur. Le serveur Project Zomboid par défaut journalise les actions de modération dans server-console.txt pour la transparence.

Conseils :

• Avertis toujours avant de kick sauf si la violation est grave.
• Documente les bans avec horodatages et raisons.
• Utilise !mute pour le spam avant d’émettre !kick.
• Fournis un chemin d’appel clair sur ton Discord.

Pour des conseils de sécurité communautaire plus larges, voir Ressources wiki.

Gestion des mods Workshop

Le mod Admin Tools et les mods similaires sont typiquement livrés via le Steam Workshop. Le Build 42.20.4 change quels mods peuvent charger des contextes Lua, donc les auteurs Workshop peuvent avoir besoin de jours après un hotfix pour publier des mises à jour. Planifie du downtime après les patches de sécurité.

Si tu héberges des mods manuellement :

• Place les mods dans /media/mods/ et mets à jour la liste WorkshopItems= dans server-options.ini.
• Backup WorkshopItems avant d’ajouter de nouveaux mods.
• Exécute !reloadoptions pour rafraîchir la liste de mods sans redémarrage.

Réfère-toi à Mods multijoueur pour le workflow de cycle de vie de mod plus large.

Pièges admin courants en Build 42.20.4

• Faire tourner un vieux build du mod Admin Tools qui utilise encore loadstring. Le hotfix de sécurité 42.20.4 supprime la fonction et ton serveur bouclera en erreur.
• Émettre !restock en plein événement sans prévenir les joueurs. Les marquages whiteboard sont effacés.
• Téléporter les joueurs vers un coéquipier sans confirmer d’abord l’emplacement du coéquipier.
• Activer les options ZombieLore en direct. Voir Modes de jeu pour les détails des presets de lore.
• Oublier !saveworld après les actions admin. La fenêtre d’autosave est indulgente, mais les événements en direct bénéficient de sauvegardes explicites.

Étape par étape : supporter un joueur perdu

1. Confirme que le joueur est en ligne : !players.
2. Identifie sa coordonnée de grille : !where <NomJoueur>.
3. Vérifie qu’il n’est pas coincé dans un véhicule : !vehicles.
4. S’il est bloqué, !teleport <NomJoueur> <Refuge> vers un lot de rallye désigné.
5. Communique via Discord. Évite de téléporter les joueurs pendant les événements hélicoptère.
6. Après action, !saveworld.

Ce pattern garde tes tickets de support courts et ta base de joueurs confiante.

Checklist d’hébergement patch-aware

• Pré-patch : sauvegarder, documenter les mods installés, geler les nouvelles arrivées de joueurs.
• Jour du patch : mettre à jour le jar serveur, exécuter !reloadoptions, redémarrer, smoke-tester avec le compte admin.
• Post-patch : surveiller server-console.txt pour les erreurs, communiquer les problèmes connus sur Discord.
• Semaine du hotfix : surveiller les mises à jour du mod Admin Tools. Appliquer dans les 48 heures quand c’est possible.

Pour le Build 42.20.4 spécifiquement, suis Hotfix 42.20.4 pour le contexte de sécurité et Vue d’ensemble Build 42 pour l’ère post-42.20 plus large.

Backup avant chaque action admin majeure

Les actions admin touchent l’état du monde partagé. Utilise Sauvegarde chaque fois que tu changes des valeurs sandbox, exécute !restock, ou remets en place une position de joueur. La fenêtre d’autosave est indulgente mais pas infinie.