Il y a deux façons d'être admin sur un serveur Project Zomboid, et choisir la bonne vous fait gagner beaucoup de temps.
- Se connecter avec le compte
adminintégré. Votre serveur en possède déjà un, et son nom d'utilisateur et son mot de passe sont dans votre panneau de contrôle. Rien à taper, pas de console. C'est la voie rapide, et celle qu'il vous faut si vous venez d'acheter un serveur ou si vous vous êtes bloqué dehors. - Promouvoir votre propre joueur avec
grantadmin. Mieux au quotidien, car vous gardez votre personnage et votre nom. Cela demande une commande console.
Ce guide couvre les deux, puis les commandes que vous utiliserez vraiment tous les jours.
Se connecter avec le compte admin intégré
Ouvrez votre serveur dans le panneau de contrôle. Admin username et Admin password se trouvent juste sous l'adresse de connexion, chacun avec un bouton de copie.

Connectez-vous ensuite au serveur et saisissez ces deux valeurs dans les champs nom d'utilisateur et mot de passe du jeu, à la place de votre nom de joueur habituel. Vous entrez en tant que compte admin avec un accès complet, sans toucher à la console.
Changez les deux avant d'inviter qui que ce soit. Un nouveau serveur arrive avec le nom d'utilisateur admin et un mot de passe par défaut, et ce couple est connu de tous. Le panneau les signale en orange tant que vous ne les avez pas changés. Cliquez sur le crayon à côté de chacun, saisissez vos propres valeurs, puis redémarrez le serveur.
Cet avertissement orange n'est pas décoratif : admin a le contrôle total de votre monde, et ce nom de compte est la première chose que tout le monde essaie.
Changer le mot de passe admin (dans le panneau, pas dans la console)
C'est le piège classique. Project Zomboid dispose de la commande console changepwd, et sur un serveur auto-hébergé elle fonctionne. Sur le vôtre, elle ne tient pas.
Votre Admin password est réécrit depuis les paramètres de démarrage de votre serveur à chaque boot. Vous le voyez dans le log de la console à chaque démarrage :
admin password changed via -adminpassword option.
Un mot de passe défini avec changepwd tient donc jusqu'au redémarrage suivant, puis revient silencieusement à ce que dit le panneau. Tous les guides qui vous conseillent changepwd sont écrits pour un serveur auto-hébergé.
Changez-le plutôt dans le panneau : modifiez Admin password sur la vue d'ensemble (ou dans l'onglet Startup, même valeur), puis redémarrez. Là, ça tient, parce que le panneau fait autorité.
Même chose pour Server password, celui dont les joueurs ont besoin pour se connecter. Il vit dans la configuration du serveur, et le panneau l'écrit pour vous.
Promouvoir votre propre joueur avec grantadmin
Vous préférez jouer avec votre personnage tout en ayant les droits admin ? Passez par la console.
- Ouvrez votre serveur et cliquez sur l'onglet Console.
- Attendez que la ligne
*** SERVER STARTED ****apparaisse.
Vous verrez d'abord les logs de démarrage. N'écrivez rien tant que le serveur n'a pas fini de démarrer : les commandes envoyées trop tôt sont ignorées.
Tapez ensuite ceci dans la console (pas besoin du préfixe / dans la console, le slash ne sert que dans le chat en jeu) :
grantadmin YourSteamUsername
Remplacez YourSteamUsername par votre nom de joueur en jeu (sensible à la casse). Vous devriez voir :
User YourSteamUsername has been added as admin.
Si l'utilisateur n'existe pas encore, il faut vous être connecté au serveur au moins une fois. Le système crée la fiche du compte à la première connexion.
Contrairement au mot de passe admin ci-dessus, grantadmin écrit dans la base du serveur et survit à un redémarrage.
Vérifier en jeu
Connectez-vous au serveur et tapez /help dans le chat. Si vous voyez la liste complète des commandes admin (plus de 50), vous êtes admin. Si vous ne voyez que les commandes joueur de base (8 à 10 commandes), le grant n'a pas fonctionné.
Les niveaux d'accès (pas seulement « admin »)
Project Zomboid propose cinq niveaux d'accès via setaccesslevel :
| Niveau | Pouvoirs |
|---|---|
admin |
Contrôle total, toutes les commandes |
moderator |
Kick, ban, téléportation, messages |
overseer |
Consultation seule des statistiques des joueurs |
gm |
Spawn d'objets, téléportation, pas de droit de ban |
observer |
Spectateur uniquement, aucune interaction |
Ils se définissent avec :
setaccesslevel "PlayerName" "moderator"
Les 10 commandes que vous utiliserez vraiment
Sur plus de 50 commandes, voici celles auxquelles vous reviendrez chaque semaine :
| Commande | Utilité |
|---|---|
/players |
Lister les joueurs connectés |
/teleport "Player" |
Se téléporter vers un joueur |
/teleportto x,y,z |
Se téléporter à des coordonnées |
/kickuser "Player" -r "reason" |
Kick avec un motif |
/banuser "Player" -r "reason" -ip -s |
Ban + ban IP + ban Steam |
/unbanuser "Player" |
Annuler un ban |
/servermsg "Restart in 5 minutes" |
Diffuser un message à tous |
/save |
Forcer la sauvegarde du monde |
/quit |
Sauvegarder et éteindre proprement |
/additem "Player" "Base.Hammer" |
Faire spawn un objet |
Pour la référence complète, consultez notre guide des commandes serveur Project Zomboid.
Console ou chat en jeu : la différence de syntaxe
| Source | Préfixe | Exemple |
|---|---|---|
| Console du serveur | aucun | grantadmin YourName |
| Chat en jeu | / |
/grantadmin YourName |
Les deux fonctionnent de la même façon, seul le slash change. Les nouveaux admins collent souvent la syntaxe console dans le chat et se demandent pourquoi il ne se passe rien.
Où sont stockées les permissions admin
Le statut admin est enregistré dans une base SQLite sur votre serveur :
/home/container/.cache/db/<NomDuServeur>.db
Le nom du fichier suit le nom interne de votre serveur : sur un serveur par défaut, c'est donc Pterodactyl.db. Vous pouvez l'inspecter avec n'importe quel navigateur SQLite si vous avez besoin de faire des modifications en masse. La table whitelist associe un nom d'utilisateur à un niveau d'accès. Modifiez directement la colonne accesslevel pour promouvoir ou rétrograder un joueur en dehors de la console.
Le mot de passe du compte admin fait exception : il est réécrit depuis vos paramètres de démarrage à chaque boot, le modifier ici ne sert donc à rien.
Problèmes courants
« User does not exist »
Le joueur ne s'est jamais connecté. Demandez-lui de se connecter une fois, puis relancez grantadmin.
« Permission denied » en lançant des commandes en tant qu'admin
Vous avez utilisé le chat en jeu sans le /. Le slash est obligatoire dans le chat.
Mot de passe admin perdu Pas besoin de la base de données pour ça. Ouvrez la vue d'ensemble de votre serveur, cliquez sur le crayon à côté d'Admin password, définissez-en un nouveau et redémarrez. Les paramètres de démarrage sont réappliqués au boot, le nouveau mot de passe est donc actif dès que le serveur est revenu.
Le mot de passe admin revient sans cesse en arrière
Vous l'avez changé avec changepwd dans la console. Changez-le plutôt sur la vue d'ensemble ou dans l'onglet Startup : voir la section ci-dessus.
La console répète « Type 'help' for commands »
Le serveur n'a pas fini de démarrer. Attendez SERVER STARTED avant de taper quoi que ce soit.
FAQ
Plusieurs joueurs peuvent-ils être admin en même temps ?
Oui, il n'y a pas de limite. Lancez grantadmin pour chacun.
Existe-t-il une interface graphique d'administration ? Project Zomboid n'a aucune interface d'administration. Tout passe par les commandes console ou par la modification directe de la base SQLite.
Puis-je me rétrograder par accident ?
Oui : /removeadmin "YourName" retire vos propres droits admin. Si cela arrive et que vous n'avez aucun autre compte admin, reconnectez-vous avec le compte admin en utilisant le nom d'utilisateur et le mot de passe de votre vue d'ensemble. C'est votre porte de secours, d'où l'intérêt de garder ce mot de passe en lieu sûr.
Quelle différence entre le statut admin et le compte spécial admin ?
admin est un compte intégré qui a toujours les privilèges admin, et ses identifiants viennent des paramètres de démarrage de votre serveur plutôt que d'un joueur qui se connecte. Le statut admin classique s'accorde avec grantadmin à un compte joueur normal. Utilisez le compte intégré pour la récupération et la première configuration, et votre propre joueur au quotidien.
Ai-je besoin du mot de passe serveur et du mot de passe admin ?
Ils ne servent pas à la même chose. Server password est celui que chaque joueur tape pour entrer, et il est vide par défaut : n'importe qui ayant l'adresse peut donc rejoindre. Admin password ne concerne que le compte admin. Les deux sont sur la vue d'ensemble.
