Comment administrer un serveur dédié Ground Branch ?
Ground Branch s'administre depuis le jeu. La commande admin setup suivie du code affiché dans le panel EsoterHost donne le rang SuperAdmin, puis la commande admin ouvre le menu d'administration. Les administrateurs sont listés dans GroundBranch/ServerConfig/Admin.ini avec leur identifiant Steam, dans trois groupes (SuperAdmin, Admin, Moderator). Les réglages de la partie sont dans Server.ini, les votes dans Vote.ini et les tirs fratricides dans TeamKill.ini.
Ground Branch n'a pas de console à distance (RCON) : un serveur dédié s'administre depuis le jeu, avec le menu admin et quelques fichiers de configuration. Ce guide de référence liste toutes les commandes et tous les réglages, d'après les fichiers que le serveur officiel crée lui-même.
Tous les fichiers de ce guide sont dans groundbranch/GroundBranch/ServerConfig/, onglet Fichiers du panel ou en SFTP. Arrêtez le serveur avant de les modifier à la main, puis redémarrez-le.
Devenir SuperAdmin
Au premier démarrage, le serveur écrit un code à usage unique dans AdminSetupPassword.txt. Le panel EsoterHost l'affiche au-dessus de la console, dans la carte Devenir administrateur.
- Rejoignez votre serveur depuis la liste des serveurs du jeu.
- Ouvrez la console du jeu avec la touche ² (la touche du tilde sur un clavier QWERTY).
- Collez la commande affichée par le panel, par exemple :
admin setup A1b2C3d4- Tapez
adminpour ouvrir le menu d'administration.
Le jeu vous inscrit aussitôt dans Admin.ini avec le groupe SuperAdmin et supprime le code. Si vous perdez ce rang, ajoutez votre ligne à la main, comme ci-dessous.
Ajouter des administrateurs
Chaque administrateur occupe une ligne Admins= dans Admin.ini. C'est exactement le format que le jeu écrit après admin setup :
Admins=(Name="Pseudo",UniqueId="76561198000000000",ContactInfo="",Group="Admin")| Champ | Contenu |
|---|---|
Name | Un nom pour vous y retrouver, libre |
UniqueId | L'identifiant Steam du joueur (SteamID64, 17 chiffres commençant par 7656) |
ContactInfo | Facultatif : un moyen de contacter cet administrateur |
Group | SuperAdmin, Admin ou Moderator |
Pour trouver un SteamID64, ouvrez les détails du compte dans Steam : l'identifiant Steam y est affiché. Un SuperAdmin peut aussi ajouter et retirer des administrateurs depuis le menu admin, sans toucher au fichier.
Les groupes et leurs commandes
Les trois groupes sont définis en tête de Admin.ini, sur les lignes AdminGroups. Voici les commandes que chacun peut utiliser dans la configuration d'origine :
| Commande | Ce qu'elle permet | SuperAdmin | Admin | Moderator |
|---|---|---|---|---|
kick | Exclure un joueur | ✓ | ✓ | ✓ |
ban / unban | Bannir un joueur, lever un bannissement | ✓ | ✓ | ✓ |
mute | Rendre un joueur muet | ✓ | ✓ | ✓ |
say | Envoyer un message à tout le serveur | ✓ | ✓ | ✓ |
motd | Afficher le message d'accueil | ✓ | ✓ | ✓ |
changemap | Changer de carte et de mission | ✓ | ✓ | ✓ |
nextmap | Passer à la mission suivante de la rotation | ✓ | ✓ | ✓ |
randomiseobjectives | Tirer au sort de nouveaux objectifs | ✓ | ✓ | ✓ |
updatesettings | Modifier les réglages de la partie | ✓ | ✓ | ✓ |
setteam / setteamelement | Changer l'équipe ou l'élément d'un joueur | ✓ | ✓ | ✓ |
kill / killai | Éliminer un joueur, éliminer l'IA | ✓ | ✓ | ✓ |
startround / endround / restartround | Lancer, terminer ou relancer la manche | ✓ | ✓ | |
freezeai / unfreezeai | Figer l'IA ou la libérer | ✓ | ✓ | |
resurrect (res), resurrectnear (resnear), resurrectatme (resatme) | Ramener un joueur dans la partie | ✓ | ✓ | |
toplayarea / toreadyroom | Envoyer un joueur sur le terrain ou dans la Ready Room | ✓ | ✓ | |
resetactors | Remettre en place les éléments de la carte | ✓ | ✓ | |
servergamerules | Changer les règles de partie du serveur | ✓ | ✓ | |
restartserver | Redémarrer le serveur | ✓ | ✓ | |
addadmin / removeadmin / editadminlist | Gérer les administrateurs | ✓ | ✓ | |
| Toutes les commandes | Le groupe SuperAdmin a Commands=("all") | ✓ |
Le plus simple est de passer par le menu admin (commande admin), qui propose les actions possibles et la liste des joueurs. Vous pouvez retirer une commande d'un groupe en l'effaçant de sa ligne AdminGroups.
Server.ini : la partie et le serveur
[/Script/RBZooKeeper.ZKServer]
ServerName=[FR] Opérations tactiques | Coop
ServerMOTD=Bienvenue ! Respect et communication radio.
ServerWebBanner=
MaxPlayers=16
MaxSpectators=0
ServerPassword=
SpectatorOnlyPassword=| Réglage | Rôle |
|---|---|
ServerName | Nom affiché dans la liste des serveurs. Le panel l'écrit, et un renommage dans le panel est appliqué au redémarrage suivant |
ServerMOTD | Message d'accueil, affiché avec la commande motd |
ServerWebBanner | Adresse d'une image utilisée comme bannière du serveur dans le jeu |
MaxPlayers | Nombre de joueurs. Le jeu plafonne lui-même à 16, même si le fichier indique plus |
MaxSpectators | Places réservées aux spectateurs |
ServerPassword | Mot de passe pour jouer. Réglez-le plutôt dans l'onglet Paramètres du panel |
SpectatorOnlyPassword | Mot de passe qui fait entrer en spectateur |
ServerShutdownType, ServerShutdownHour, ServerShutdownTimeLimit, ServerShutdownGracePeriod | Arrêts programmés du serveur. Laissez les valeurs d'origine : les redémarrages se planifient depuis l'onglet Sauvegardes & tâches du panel |
Le menu admin du jeu (updatesettings) peut aussi réécrire ce fichier. Vos modifications, faites en jeu ou à la main, sont conservées : le panel ne réécrit que le nom, le mot de passe et les places, et seulement quand vous les changez dans le panel.
Les règles de partie (GameRules)
La ligne GameRules regroupe des interrupteurs True ou False :
| Règle | Quand elle est à True |
|---|---|
AllowCheats | Les commandes de triche sont autorisées |
AllowDeadChat | Les joueurs morts peuvent écrire dans le chat |
AllowEnemyNPCMinimapBlips | L'IA ennemie peut apparaître sur la mini-carte |
AllowUnrestrictedRadio | La radio n'a pas de restriction |
AllowUnrestrictedVoice | La voix n'a pas de restriction |
BalanceTeams | Les équipes sont équilibrées automatiquement |
RestrictFiringRange | L'accès au stand de tir est restreint |
SpectateEnemies | Les spectateurs peuvent suivre les ennemis |
SpectateForceFirstPerson | Les spectateurs restent en vue à la première personne |
SpectateFreeCam | Les spectateurs ont une caméra libre |
UseFriendlyNameTags | Les noms des alliés s'affichent au-dessus d'eux |
UseGlobalSkinRestrictions | Les restrictions d'apparence s'appliquent à tout le serveur |
Pour un serveur PvP compétitif, on passe souvent SpectateEnemies et SpectateFreeCam à False, et SpectateForceFirstPerson à True : un joueur mort ne peut plus renseigner son équipe sur la position adverse.
Vote.ini : les votes des joueurs
Les joueurs peuvent lancer des votes pour certaines commandes. Valeurs d'origine :
[/Script/RBZooKeeper.ZKVote]
VoteDuration=30
VoteSucceededTimeout=60
VoteFailedTimeout=180
MapVoteTimeout=300
MinPlayers=1
VotingCommands=changemap
VotingCommands=nextmap
VotingCommands=kick
VotingCommands=restartround
VotingCommands=updatesettings
VoteDelayFromRoundStart=0
bAllowVotesWhenAdminPresent=False
bVoteForAnyMap=False| Réglage | Rôle |
|---|---|
VoteDuration | Durée d'un vote |
VoteSucceededTimeout / VoteFailedTimeout | Délai avant un nouveau vote, après un vote réussi ou raté |
MapVoteTimeout | Délai entre deux votes de changement de carte |
MinPlayers | Nombre de joueurs minimum pour lancer un vote |
VotingCommands | Une ligne par commande ouverte au vote. Supprimez la ligne kick pour interdire les votes d'exclusion |
VoteDelayFromRoundStart | Délai après le début de la manche avant de pouvoir voter |
bAllowVotesWhenAdminPresent | À False, pas de vote quand un administrateur est connecté : c'est lui qui décide |
bVoteForAnyMap | À False, les votes de carte se limitent à la rotation de MapList.ini |
TeamKill.ini : les tirs fratricides
[/Script/RBZooKeeper.ZKTeamKill]
MaxTeamKills=3
BanTime=60
TeamKillExpireTime=30MaxTeamKills: nombre de tirs fratricides tolérés avant la sanction.BanTime: durée du bannissement qui suit.TeamKillExpireTime: délai au bout duquel un tir fratricide n'est plus compté.
Sur un serveur public, gardez une limite basse. Entre amis, vous pouvez la relever.
Ban.ini : les bannissements
Ban.ini règle la durée par défaut d'un bannissement (DefaultBanDuration=720 à l'origine). Les bannissements se donnent en jeu avec ban et se lèvent avec unban, depuis le menu admin.
Bonnes pratiques
- Gardez au moins deux SuperAdmins, pour ne jamais perdre la main si l'un est absent.
- Donnez le rang Moderator aux nouveaux venus de l'équipe : ils peuvent exclure et changer de carte, sans toucher aux administrateurs ni redémarrer le serveur.
- Faites une sauvegarde avant de modifier les fichiers à la main. Ground Branch ne garde pas de monde persistant : vos réglages, administrateurs et bannissements sont ce qu'il y a de plus précieux.
- Planifiez un redémarrage quotidien dans l'onglet Sauvegardes & tâches : le serveur se met à jour à chaque démarrage.
Questions fréquentes
Quelle est la commande pour devenir admin sur Ground Branch ?
Dans la console du jeu (touche ²), tapez admin setup suivi du code à usage unique. Chez EsoterHost, la commande complète s'affiche dans le panel, au-dessus de la console.
Comment ouvrir le menu admin de Ground Branch ?
Une fois administrateur, tapez admin dans la console du jeu. Le menu permet d'exclure, de bannir, de changer de carte et de modifier les réglages de la partie.
Comment ajouter un admin sur un serveur Ground Branch ?
Ajoutez une ligne Admins=(Name="Pseudo",UniqueId="SteamID64",ContactInfo="",Group="Admin") dans Admin.ini, serveur arrêté, ou utilisez le menu admin en tant que SuperAdmin.
Quelle différence entre SuperAdmin, Admin et Moderator ?
SuperAdmin a toutes les commandes. Admin gère la partie, les joueurs et les administrateurs. Moderator peut exclure, bannir, rendre muet et changer de carte, mais pas lancer ou relancer les manches, figer l'IA, redémarrer le serveur ni gérer les administrateurs.
Comment empêcher les votes d'exclusion sur Ground Branch ?
Supprimez la ligne VotingCommands=kick de Vote.ini, serveur arrêté.
Pourquoi le nom de mon serveur Ground Branch a-t-il changé tout seul ?
Un administrateur l'a sans doute modifié depuis le menu admin du jeu, qui réécrit Server.ini. Renommez le serveur avec le crayon du panel : le nom du panel est appliqué au redémarrage suivant.
Pour aller plus loin
- Le guide complet du serveur dédié Ground Branch
- Cartes, missions et rotation MapList.ini
- Mods du Workshop et création de mods
Image : GROUND BRANCH, BlackFoot Studios