Devenir admin sur DayZ : BattlEye RCon et installation de VPPAdminTools
Sur un serveur DayZ, l'administration repose sur deux niveaux. Le premier, ce sont les outils du jeu lui-même : le mot de passe administrateur dans serverDZ.cfg, la connexion RCon (console à distance) de BattlEye et le journal d'administration. Ils vous permettent de surveiller, d'expulser et de bannir des joueurs. Les outils en jeu comme la téléportation, la caméra libre, la création d'objets ou de véhicules et le changement de météo ne sont en revanche pas intégrés au jeu : il faut pour cela un mod développé par la communauté, comme VPPAdminTools.
Dans ce guide, vous configurerez d'abord l'administration intégrée, puis vous installerez VPPAdminTools sur un serveur Windows ou Linux, vous vous déclarerez super-administrateur (SuperAdmin) et vous ouvrirez le menu d'administration en jeu. Pour les autres sujets, consultez les guides DayZ.
Avant de commencer
- Un serveur DayZ fonctionnel : le serveur doit être installé avec SteamCMD et avoir démarré au moins une fois sans erreur. Si ce n'est pas encore fait, suivez d'abord le guide d'installation d'un serveur DayZ. Les chemins de ce guide reprennent ses exemples :
C:\DayZServersous Windows,/home/steam/dayz-serversous Linux et-profiles=profilespour le dossier de profil. Les offres VDS adaptées se trouvent sur la page Location de serveur DayZ. - Votre identifiant Steam64 : VPPAdminTools reconnaît les administrateurs à leur identifiant Steam64 à 17 chiffres. Si l'adresse de votre profil Steam commence par
steamcommunity.com/profiles/, le nombre à 17 chiffres qui la termine est votre identifiant. Si vous utilisez une adresse de profil personnalisée (custom), le nom ou le nombre qu'elle contient n'est pas votre identifiant ; la documentation du mod recommande le site SteamID (steamid.io) pour le trouver. - Un compte Steam qui possède DayZ : vous téléchargerez les fichiers du mod depuis le launcher officiel de DayZ ou avec SteamCMD. Dans SteamCMD, vous vous connectez avec votre propre compte Steam, comme dans le guide d'installation.
- Les bases de l'installation de mods : le paramètre
-mod, le dossierkeyset la vérification des signatures sont expliqués en détail dans le guide pour installer des mods sur un serveur DayZ ; vous ne trouverez ici que les étapes propres à VPPAdminTools. - Un serveur avec une progression des joueurs : la page Workshop de CF indique que le serveur doit être réinitialisé (wipe) avant l'installation du mod. Si vous ajoutez les mods à un serveur existant, sauvegardez d'abord le dossier du serveur ; la réinitialisation est expliquée dans le guide du wipe.
VPPAdminTools est un mod communautaire non officiel, développé non pas par Bohemia Interactive mais par l'équipe Vanilla++ (VPP). Après une mise à jour de DayZ, il se peut que le serveur ne démarre plus ou que certaines fonctions ne marchent pas tant que le mod n'a pas été mis à jour à son tour. En cas de problème, consultez d'abord la page Steam Workshop du mod et la documentation d'installation sur GitHub.
1. Configurer l'administration intégrée du jeu
La page de Bohemia consacrée à la configuration du serveur définit le réglage passwordAdmin comme le « mot de passe utilisé pour devenir administrateur du serveur ». Écrivez la valeur dans le fichier que vous indiquez avec -config sur la ligne de lancement. Comme toute personne qui connaît ce mot de passe peut devenir administrateur, choisissez une valeur longue que vous n'utilisez nulle part ailleurs :
passwordAdmin = "MotDePasseAdminSolide";
Mise en garde sur #login et les commandes du chat : d'après les guides de la communauté, ce mot de passe s'utilise en tapant #login motdepasse dans le chat du jeu ; les mêmes listes citent aussi des commandes comme #logout, #kick et #shutdown. Ces commandes sont documentées sur la page « Multiplayer Server Commands » de Bohemia, mais cette page a été écrite pour Operation Flashpoint, ArmA, Arma 2 et Arma 3. Les pages officielles de DayZ ne mentionnent ni la commande #login ni les commandes qui fonctionnent après la connexion. C'est pourquoi nous ne donnons pas de liste de commandes ici ; si vous voulez les essayer, faites-le quand aucun joueur n'est connecté. La voie documentée pour expulser et bannir des joueurs est RCon (étape 2).
Les deux outils intégrés décrits à l'étape 7 du guide d'installation facilitent aussi le travail de votre équipe d'administration : lorsque -adminlog est activé, le journal d'administration .ADM créé dans le dossier de profil (chat, coups portés, morts et signalements laissés par les joueurs en tapant #toadmin message dans le chat), et le fichier priority.txt à la racine du dossier d'installation, qui fait passer vos administrateurs en tête de la file d'attente de connexion.
2. Activer l'administration à distance avec BattlEye RCon
RCon vous permet de vous connecter au serveur sans entrer dans le jeu pour lister, expulser et bannir des joueurs. Les réglages se trouvent dans le fichier BEServer_x64.cfg ; selon BattlEye, sous Linux le fichier s'appelle beserver_x64.cfg, en minuscules. Le dossier où ce fichier doit se trouver est indiqué à l'étape 4 du guide d'installation : avec la valeur -BEpath=battleye utilisée là-bas, il s'agit du dossier battleye de l'installation. Ouvrez le fichier et écrivez ces deux lignes :
RConPassword MotDePasseRconSolide
RConPort 2310
Selon la documentation de BattlEye, RConPassword et RConPort sont obligatoires et le port RCon doit être différent des ports du serveur de jeu ; 2310 n'est ici qu'un exemple. RCon fonctionne en UDP ; l'ouverture de ce port dans le pare-feu, en UDP et uniquement pour votre propre adresse IP, est expliquée dans le guide d'ouverture des ports et d'ajout à DZSA. Redémarrez le serveur après la modification.
Pour vous connecter, saisissez l'adresse IP du serveur, le port RCon et le mot de passe dans un outil RCon comme BEC ou DaRT, que Bohemia cite en exemple. Les commandes ci-dessous se tapent dans la console de l'outil, et non dans le chat du jeu :
| Commande | Effet |
|---|---|
players | Liste les joueurs avec leur GUID et leur ping ; affiche le numéro de joueur utilisé par les autres commandes |
kick [numéro] [raison] | Expulse le joueur ; affiche la raison si vous en indiquez une |
ban [numéro] [minutes] [raison] | Bannit le GUID BattlEye du joueur ; sans durée ou avec 0, le ban est permanent |
addBan [GUID ou IP] [minutes] [raison] | Bannit un joueur qui n'est pas sur le serveur à ce moment-là |
bans / removeBan [numéro du ban] | Affiche la liste des bans / lève un ban d'après son numéro dans la liste |
say -1 [message] | Envoie un message à tous les joueurs ; si vous remplacez -1 par un numéro de joueur, le message n'est envoyé qu'à ce joueur |
admins | Liste les administrateurs RCon connectés |
Les bans BattlEye sont enregistrés dans le fichier bans.txt du dossier de travail de BattlEye. Le GUID qui y figure n'a pas la même valeur que l'identifiant Steam64 ; or VPPAdminTools reconnaît les administrateurs à leur identifiant Steam64.
3. Télécharger les fichiers de VPPAdminTools et de CF
L'identifiant Steam Workshop de VPPAdminTools est 1828439124 ; pour fonctionner, le mod a besoin de Community Framework (CF, identifiant 1559212036). La page Workshop officielle du mod indique CF comme mod requis.
Windows (méthode documentée par le mod) :
- Sur votre propre ordinateur, abonnez-vous à VPPAdminTools et à CF dans le Steam Workshop (« S'abonner »).
- Lancez DayZ depuis votre bibliothèque Steam pour ouvrir le launcher officiel de DayZ. Pour cette opération, la page Workshop demande d'utiliser le launcher officiel et non DZSA Launcher.
- Dans l'onglet MODS, cherchez VPPAdminTools. Si les fichiers semblent corrompus ou encore en cours de téléchargement, réparez-les avec Repair (réparer).
- Ouvrez le dossier du mod via l'option Open folder in Windows Explorer (ouvrir le dossier dans l'Explorateur Windows) de son menu à trois points, puis copiez les dossiers
@VPPAdminToolset@CFdans le dossierC:\DayZServerdu VDS.
Vous pouvez aussi télécharger les fichiers directement sur le VDS avec SteamCMD. Les commandes ci-dessous reprennent la commande workshop_download_item de la partie Linux, écrite avec les chemins Windows du guide d'installation. Les fichiers sont téléchargés sous C:\DayZServer\steamapps\workshop\content\221100\, dans des dossiers qui portent l'identifiant Workshop ; les lignes xcopy les copient dans le dossier du serveur sous les noms @CF et @VPPAdminTools :
C:\steamcmd\steamcmd.exe +force_install_dir C:\DayZServer\ +login VOTRE_NOM_UTILISATEUR +workshop_download_item 221100 1559212036 +workshop_download_item 221100 1828439124 +quit
xcopy /E /I /Y "C:\DayZServer\steamapps\workshop\content\221100\1559212036" "C:\DayZServer\@CF"
xcopy /E /I /Y "C:\DayZServer\steamapps\workshop\content\221100\1828439124" "C:\DayZServer\@VPPAdminTools"
Linux : le guide Linux de Bohemia télécharge les mods avec la commande workshop_download_item de SteamCMD, via l'identifiant d'application Workshop de DayZ, 221100. Avec l'utilisateur steam :
sudo -iu steam
cd ~/Steam
./steamcmd.sh +force_install_dir /home/steam/dayz-server/ +login VOTRE_NOM_UTILISATEUR +workshop_download_item 221100 1559212036 +workshop_download_item 221100 1828439124 +quit
Les fichiers sont téléchargés sous /home/steam/dayz-server/steamapps/workshop/content/221100/, dans des dossiers qui portent l'identifiant Workshop. La documentation de VPPAdminTools ne décrit que l'installation sous Windows et ne parle pas de la prise en charge des serveurs Linux ; sous Linux, faites un essai quand aucun joueur n'est connecté avant de l'utiliser.
4. Placer les dossiers des mods et les clés
Avec verifySignatures = 2, le serveur vérifie les signatures des mods ; la clé .bikey de chaque mod doit donc se trouver dans le dossier keys du serveur. La documentation du mod demande d'ouvrir @VPPAdminTools, de copier le contenu de son dossier Keys dans le dossier keys du serveur, puis de répéter l'opération pour @CF.
Windows (« Command Prompt », l'invite de commandes) :
copy "C:\DayZServer\@VPPAdminTools\Keys\*.bikey" "C:\DayZServer\keys\"
copy "C:\DayZServer\@CF\Keys\*.bikey" "C:\DayZServer\keys\"
Sous Linux, toujours avec l'utilisateur steam, créez des liens symboliques (symlinks) vers les dossiers Workshop, comme dans le guide de Bohemia ; ainsi, lorsque SteamCMD met le mod à jour, le serveur utilise les nouveaux fichiers. Linux étant sensible à la casse, trouvez et copiez les clés avec find sans tenir compte des majuscules et des minuscules :
cd /home/steam/dayz-server
ln -s /home/steam/dayz-server/steamapps/workshop/content/221100/1559212036 @CF
ln -s /home/steam/dayz-server/steamapps/workshop/content/221100/1828439124 @VPPAdminTools
find steamapps/workshop/content/221100/1559212036 steamapps/workshop/content/221100/1828439124 -iname '*.bikey' -exec cp {} keys/ \;
ls keys
Dans la sortie de ls, vous devez voir les clés des deux mods.
5. Ajouter les mods à la ligne de lancement
La documentation du mod donne le paramètre de lancement sous la forme "-mod=@CF;@VPPAdminTools" ; dans l'exemple, CF, qui est une dépendance, vient en premier. Elle attire aussi l'attention sur deux points : pas de ; superflu à la fin de la ligne, et les guillemets ne doivent pas être supprimés (ils sont nécessaires pour les mods dont le nom contient des espaces). Sous Linux, les guillemets sont de toute façon obligatoires : sans eux, le shell considère le point-virgule comme un séparateur de commandes et la ligne est coupée en deux.
Sous Windows, la ligne du serveur dans start.bat :
DayZServer_x64.exe -config=serverDZ.cfg -port=2302 "-mod=@CF;@VPPAdminTools" -profiles=profiles -BEpath=battleye -dologs -adminlog -netlog -freezecheck
Sous Linux, si le service tourne, arrêtez-le d'abord avec sudo systemctl stop dayz-server, puis testez le serveur manuellement avec l'utilisateur steam :
cd /home/steam/dayz-server
./DayZServer -config=serverDZ.cfg -port=2302 "-mod=@CF;@VPPAdminTools" -profiles=profiles -BEpath=battleye -dologs -adminlog -netlog -freezecheck
S'il démarre sans problème, arrêtez-le avec Ctrl + C, revenez à votre propre compte administrateur avec exit et ajoutez le même paramètre -mod dans le fichier /etc/systemd/system/dayz-server.service, à la ligne ExecStart. Rechargez ensuite le service et démarrez-le :
sudo systemctl daemon-reload
sudo systemctl start dayz-server
Ne chargez pas ces mods avec -serverMod. Selon Bohemia, les mods chargés avec -serverMod ne sont pas communiqués aux clients ; or le menu et les raccourcis de VPPAdminTools fonctionnent dans le jeu de l'administrateur lui-même. Les mods chargés avec -mod étant communiqués aux clients, toute personne qui se connecte au serveur doit s'abonner à CF et à VPPAdminTools dans le Workshop.
Au premier démarrage du serveur avec cette ligne, les fichiers de configuration du mod sont créés automatiquement dans le dossier VPPAdminTools du dossier de profil.
6. Vous déclarer super-administrateur et créer le mot de passe
Les super-administrateurs sont les utilisateurs qui disposent des droits les plus élevés dans VPPAdminTools ; selon la page Workshop, eux seuls peuvent ajouter d'autres utilisateurs aux groupes d'utilisateurs. Chemin du fichier, la première ligne pour Windows et la seconde pour Linux :
C:\DayZServer\profiles\VPPAdminTools\Permissions\SuperAdmins\SuperAdmins.txt
/home/steam/dayz-server/profiles/VPPAdminTools/Permissions/SuperAdmins/SuperAdmins.txt
Sous Linux, si vous ne trouvez pas le fichier à cet emplacement, cherchez-le sans tenir compte de la casse avec la commande find /home/steam/dayz-server/profiles -iname 'superadmins.txt'. Ouvrez le fichier, lisez les consignes de format qu'il contient et ajoutez votre identifiant Steam64. Si vous ajoutez plusieurs identifiants, chacun doit figurer sur sa propre ligne, sans espace au début ni à la fin de la ligne :
7656119XXXXXXXXXX
7656119YYYYYYYYYY
Mot de passe : par défaut, le mod exige une couche supplémentaire de mot de passe ; selon la page Workshop, l'outil ne fonctionne pas si aucun mot de passe n'est défini. Créez le mot de passe dans le même dossier Permissions, en suivant les consignes du fichier credentials.txt. Le mot de passe est enregistré dans le fichier sous forme d'empreinte (hash) : si vous l'oubliez, vous ne pouvez pas le relire dans le fichier, vous en créez un nouveau en suivant les consignes. Pour désactiver cette couche, la documentation du mod indique d'ajouter la ligne suivante au fichier de configuration que vous indiquez avec -config :
vppDisablePassword = 1;
La documentation du mod présente ce mot de passe comme une couche de sécurité supplémentaire ; laissez-le activé sauf réelle nécessité. Selon la page Workshop, vous devez redémarrer le serveur pour que les modifications prennent effet.
7. Ouvrir le menu en jeu et ajouter d'autres administrateurs
Redémarrez le serveur et connectez-vous avec le compte Steam que vous avez ajouté à la liste des super-administrateurs. Les touches par défaut ci-dessous proviennent des définitions d'entrée du code source du mod. Selon la page Workshop, tous les raccourcis se trouvent dans l'onglet d'attribution des touches (keybinds) des paramètres du jeu, sous la rubrique VPPAdminTools.
| Touche par défaut | Nom dans la définition du mod | Fonction |
|---|---|---|
| Home (Début) | Open Toolbar | Ouvre la barre d'outils d'administration |
| End (Fin) | Toggle Tools, Keybinds & Privileges | Active ou désactive les outils, les raccourcis et les droits |
| Insert (Inser) | Toggle GodMode | Active ou désactive le mode invincible |
| Backspace (Retour arrière) | Toggle Free Camera | Active ou désactive la caméra libre |
| H | Teleport to Crosshair | Téléporte au point visé par le réticule |
| Delete (Suppr) | Delete Object at Crosshair | Supprime l'objet visé par le réticule |
| I | Toggle Invisibility | Active ou désactive l'invisibilité |
| J | Heal Self or Player on Crosshairs | Vous soigne, ou soigne le joueur visé par le réticule |
Si les raccourcis ne réagissent pas, vous avez peut-être désactivé les outils avec la touche End (Fin) ; appuyez une fois sur End et réessayez. Le wiki du mod cite les fonctions suivantes comme rubriques d'utilisation : gestionnaire de joueurs, outils de téléportation, ESP (couche qui affiche les joueurs et les objets à distance), console de commandes, gestion du serveur, éditeur météo, générateur d'objets, gestionnaire de bans, éditeur de permissions, webhooks et éditeur XML.
Autres administrateurs : plutôt que de déclarer chaque administrateur super-administrateur, créez, comme le décrit la documentation du mod, des groupes d'utilisateurs (« User Groups ») dans l'éditeur de permissions en jeu (« Permission Editor »), attribuez des droits aux groupes et ajoutez-y les utilisateurs. Vous pouvez ainsi, par exemple, ne donner à un groupe de modérateurs que les droits dont il a besoin.
8. Planifier les mises à jour et la sauvegarde
Les mods communautaires ne sont pas mis à jour avec le jeu. Si la copie du mod sur le serveur n'est plus à jour, elle ne correspond plus à la version installée par les joueurs ; après une mise à jour de DayZ, vous pouvez aussi rencontrer des problèmes jusqu'à la sortie d'une version compatible du mod.
- Windows : copiez sur le serveur la nouvelle version issue du Workshop par la méthode de l'étape 3 et remplacez les fichiers
.bikey. La bouclestart.batdu guide d'installation ne met à jour que le jeu, pas les mods. - Linux : arrêtez le service avec
sudo systemctl stop dayz-serveret relancez la commande SteamCMD de l'étape 3. Les liens symboliques pointent vers les nouveaux fichiers ; répétez en revanche la commande de copie des clés. - Sauvegarde : le dossier
VPPAdminToolsdu dossier de profil contient votre liste de super-administrateurs et les autres réglages du mod. Les VDS n'incluant pas de sauvegarde automatique, conservez régulièrement une copie de ce dossier en dehors du serveur.
La page Workshop interdit de reconditionner le mod (repack) et de le republier sur Steam sous un autre compte ; si vous préparez votre propre pack de mods, laissez VPPAdminTools comme dépendance séparée.
Exemple de configuration : fichiers et emplacements
| Objectif | Fichier ou réglage | Emplacement |
|---|---|---|
| Mot de passe administrateur du jeu | passwordAdmin | Fichier indiqué avec -config (serverDZ.cfg) |
| Liste de connexion prioritaire | priority.txt | Racine du dossier d'installation |
| Journal d'administration | Fichier .ADM | Dossier de profil ; nécessite -adminlog |
| Mot de passe et port RCon | RConPassword, RConPort | BEServer_x64.cfg (sous Linux beserver_x64.cfg), dossier -BEpath |
| Bans BattlEye | bans.txt | Dossier de travail de BattlEye |
| Clés des mods | Fichiers .bikey | Dossier keys de l'installation |
| Chargement des mods | "-mod=@CF;@VPPAdminTools" | Ligne de lancement |
| Super-administrateurs | SuperAdmins.txt | profiles\VPPAdminTools\Permissions\SuperAdmins |
| Mot de passe VPP | credentials.txt | profiles\VPPAdminTools\Permissions |
| Désactiver la couche de mot de passe VPP | vppDisablePassword = 1; | serverDZ.cfg |
Erreurs fréquentes
- J'ai ajouté mon identifiant Steam64 mais rien ne se passe en jeu : dans ce cas, la documentation du mod demande de vérifier d'abord l'identifiant ; les chiffres d'une adresse de profil personnalisée ne sont pas un identifiant Steam64. Vérifiez que l'identifiant appartient bien au compte avec lequel vous jouez à DayZ, que la ligne ne contient pas d'espace et que vous avez redémarré le serveur. Si vous n'avez pas désactivé la couche de mot de passe, assurez-vous aussi d'avoir créé un mot de passe avec
credentials.txt; selon la page Workshop, l'outil ne fonctionne pas si aucun mot de passe n'est défini. - Le dossier VPPAdminTools n'a pas été créé dans le dossier de profil : le nom du mod est mal écrit dans la ligne
-mod=, les fichiers du mod sont corrompus, ou le dossier que vous regardez n'est pas celui que vous avez indiqué avec-profiles=. - Le serveur ne démarre pas et affiche « Virtual Machine Error » : la documentation du mod recommande de vérifier les fichiers du serveur, de mettre les mods à jour, de contrôler que les mods sont compatibles et que leurs dépendances (CF) sont installées, et d'utiliser la dernière version de DayZ. Consultez aussi les dernières lignes du journal
.RPTdans le dossier de profil. - Les joueurs ne peuvent pas se connecter au serveur moddé : une clé manque, ou elle n'a pas été remplacée après une mise à jour du mod. Copiez les nouveaux fichiers
.bikeydans le dossierkeyset mettez à jour la version du mod sur le serveur. - Le mot de passe VPP semble incorrect en jeu : le mot de passe étant enregistré sous forme d'empreinte, il ne peut pas être lu dans le fichier. Créez un nouveau mot de passe selon les consignes de
credentials.txtet redémarrez le serveur. - Sous Linux, seul CF se charge ou une erreur « command not found » apparaît : le paramètre
-moda été écrit sans guillemets ; le shell a coupé la ligne au point-virgule. Écrivez le paramètre sous la forme"-mod=@CF;@VPPAdminTools". - L'outil RCon n'arrive pas à se connecter : selon la documentation du protocole BattlEye, RCon n'est pas activé si aucun mot de passe n'est défini. Vérifiez les lignes
RConPasswordetRConPort, que le fichier se trouve bien dans le dossier-BEpathainsi que la règle du pare-feu, puis redémarrez le serveur.
Questions fréquentes
Puis-je devenir administrateur en tapant #login ?
Les guides de la communauté expliquent que le mot de passe passwordAdmin s'utilise en tapant #login motdepasse dans le chat ; mais pour DayZ, Bohemia ne documente que le réglage passwordAdmin et ne publie ni la commande #login ni les commandes qui fonctionnent après la connexion (détails à l'étape 1). La voie documentée pour expulser et bannir des joueurs est BattlEye RCon ; pour la téléportation ou la création d'objets, il faut un mod comme VPPAdminTools.
Les joueurs doivent-ils aussi installer VPPAdminTools ?
Oui. Comme le mod est chargé avec -mod, il est communiqué aux clients ; toute personne qui se connecte au serveur doit s'abonner à CF et à VPPAdminTools. Seuls les super-administrateurs et les utilisateurs des groupes auxquels vous avez donné des droits peuvent utiliser les outils d'administration.
Puis-je utiliser un autre mod d'administration à la place de VPPAdminTools ?
Oui, il existe d'autres mods d'administration communautaires pour DayZ. Par exemple, le guide Linux de Bohemia utilise comme mod d'exemple Community Online Tools (identifiant Workshop 1564026768), avec CF. Quel que soit votre choix, effectuez l'installation et le réglage des droits selon la documentation de ce mod.
Puis-je utiliser ce mod sur un serveur qui propose des dons ou des avantages payants ?
Selon la page Workshop, le mod peut être utilisé sur des serveurs qui génèrent des revenus, tant que vous respectez les règles de Bohemia Interactive. Avant de mettre en place un modèle de revenus, lisez les règles de Bohemia sur la monétisation des serveurs.
Guides associés
- Comment installer un serveur DayZ ? SteamCMD sous Windows et Linux
- Comment installer des mods sur un serveur DayZ ? (Workshop & keys)
- Ouvrir les ports DayZ et ajouter le serveur à DZSA Launcher
- Réglages de serverDZ.cfg pour DayZ : comment régler le cycle jour/nuit ?
- Créer un serveur roleplay (RP) DayZ : trader et zone sécurisée
Commentaires0
Pas encore de commentaire
Soyez le premier à partager votre avis.
Veuillez vous connecter ou vous inscrire pour laisser un commentaire.