Guide des commandes admin et de l’API Web de Motor Town
L’administration d’un serveur dédié Motor Town: Behind The Wheel fonctionne différemment de la plupart des jeux de survie : au lieu d’une longue liste de commandes de chat, Motor Town offre aux admins un menu admin en jeu, un système de rôle de police et (la partie que presque personne ne documente) une API Web HTTP complète sur le serveur pour les kicks, les bans, les annonces, les rôles et les données du serveur en direct. Ce guide couvre les trois.
Nommer un joueur admin
Les admins sont définis dans le fichier DedicatedServerConfig.json du serveur, dans la liste Admins. Chaque entrée associe un UniqueNetId à un Nickname. Pour les joueurs Steam, le UniqueNetId est le SteamID64 (retrouvez le vôtre sur steamid.io). Ajoutez le joueur, redémarrez le serveur : lorsqu’il se reconnecte, il a accès aux outils admin en jeu. Le paramètre bAllowAdminToRemoveAdmin détermine si les admins peuvent se rétrograder entre eux (désactivé par défaut).
Sur une instance Survival Servers, c’est un champ du panneau : indiquez les SteamID64 dans Admin Steam IDs dans l’outil Server Config et redémarrez.
Le ReadMe officiel documente aussi une astuce pour trouver les identifiants non-Steam : ouvrez le serveur depuis votre client de jeu, ajoutez l’admin en jeu, puis relevez l’entrée générée dans GameUserSettings.ini sous %LOCALAPPDATA%\MotorTown\Saved\Config\Windows.
Le rôle de police
Motor Town propose un rôle de police dédié pour les serveurs RP. PoliceRolePlayers dans la config liste les joueurs (même structure UniqueNetId + Nickname que pour Admins), et bAllowPoliceVehicleByPlayerRole contrôle si les véhicules de police sont réservés à ce rôle : mettez-le à true et seuls les agents inscrits peuvent les conduire ; laissez-le à false et tout le monde le peut.
L’API Web : la véritable console de commandes du serveur
Le serveur dédié peut exposer une API HTTP avec tout ce dont un administrateur de communauté a besoin, sans que personne ne soit en jeu. Activez-la dans DedicatedServerConfig.json :
- bEnableHostWebAPIServer: true
- HostWebAPIServerPassword: a strong password; it authenticates every call
- HostWebAPIServerPort : 8080 par défaut
- HostWebAPIDisabledCommands : liste facultative des endpoints à désactiver
Chaque appel passe le mot de passe en paramètre et renvoie une enveloppe JSON avec les champs data, message et succeeded. Exemple :
curl "http://127.0.0.1:8080/player/count?password=yourpassword"
Note de sécurité : le mot de passe circule comme simple paramètre de requête en clair, n’ouvrez donc pas le port de l’API sur Internet. Interrogez-la depuis la machine du serveur elle-même (ou depuis un réseau de confiance) et gardez le port derrière le pare-feu.
Référence des endpoints
| Point de terminaison | Méthode | Effet |
|---|---|---|
| /chat | POST | Envoie une annonce à tout le serveur, ou un message de chat avec type=message et une color facultative (hex comme FF00FF) |
| /player/count | GET | Nombre de joueurs actuel |
| /player/list | GET | Chaque joueur en ligne avec son nom, son unique_id, sa position dans le monde et son véhicule actuel |
| /player/kick | POST | Expulser par unique_id (depuis /player/list) |
| /player/ban | POST | Bannir par unique_id, avec hours facultatif (permanent si omis) et reason |
| /player/unban | POST | Lever un bannissement par unique_id |
| /player/banlist | GET | Liste des bannissements actuelle |
| /player/role/list | GET | Lister l’effectif admin ou police (role=admin ou role=police) |
| /player/role/add | POST | Accorde le statut admin ou police à un unique_id |
| /player/role/remove | POST | Retire le rôle d’admin ou de police d’un unique_id |
| /delivery/sites | GET | État en direct des livraisons et des cargaisons sur les chantiers de l’île |
| /housing/list | GET | Parcelles de logement avec propriétaire et expiration de la location |
| /version | GET | La version du jeu du serveur, pratique pour vérifier la correspondance des versions client/serveur |
Faire tout cela sans curl
Sur les instances Survival Servers, les outils d’administration du panneau de contrôle reposent sur cette même API Web : l’expulsion, le bannissement et le débannissement, les annonces, ainsi que les listes d’admins et de policiers sont des boutons et des champs du panneau, l’API restant en sécurité sur l’interface de bouclage (loopback). Le guide de configuration du serveur dédié explique comment mettre un serveur en route, et le guide des mods couvre le volet mods de véhicules de la vie d’admin.