RCON et outils d’admin WARDOGS

Le RCON dans WARDOGS

Le RCON de WARDOGS n’est pas l’ancien protocole socket façon Source. Le serveur dédié fait tourner une petite API HTTP, versionnée sous /v1, qui répond en JSON. Chaque requête transmet le mot de passe RCON comme jeton bearer, et ce même jeton autorise les lectures comme les écritures : il n’y a pas de rôle en lecture seule, alors ne donne le mot de passe qu’à des admins de confiance et place devant l’API un panneau avec ses propres identifiants pour tous les autres.

Le listener est désactivé par défaut. Il s’active dans le fichier ServerSettings.ini du serveur, section WDRCONSettings, avec une adresse d’écoute, un port (7776 par défaut, réglable aussi par un argument de lancement) et soit un mot de passe en clair, soit un hash de mot de passe. Un listener lié à autre chose que l’interface loopback doit utiliser TLS : un hébergeur qui te donne accès au RCON te fournira donc une adresse https, un port et un mot de passe.

Ce que les admins peuvent en faire

L’API expose environ 35 endpoints. Ceux qui comptent au quotidien :

• L’état du serveur et la liste des joueurs connectés, avec leurs Steam ID.
• Expulser un joueur, le tuer, lui envoyer un message et le changer de faction ; envoyer un message à tout le monde.
• Bannir et débannir par Steam ID, avec une liste de bannissements persistante ; les places réservées fonctionnent de la même façon.
• Changer de carte immédiatement, terminer ou relancer la partie, régler l’éclairage et la météo en direct.
• Lire, modifier et enregistrer la rotation des cartes ; des endpoints de catalogue listent les cartes, les modes et les préréglages d’éclairage que le serveur accepte.
• Récupérer, valider et remplacer l’ensemble du document de configuration du serveur, et lire le journal d’audit des actions d’admin.

Obtenir l’accès auprès de ton hébergeur

Seuls les trois hébergeurs agréés font tourner des serveurs WARDOGS : l’accès RCON dépend donc de ce que leurs panneaux proposent. Avant de louer, demande :

Il n’existe pas encore de documentation officielle pour les développeurs. La référence la plus complète est une référence non officielle tenue par la communauté sur wardogs.tech, qui documente chaque endpoint et chaque clé de configuration et fournit un fichier OpenAPI à partir duquel tu peux générer un client.

• Le listener RCON est-il activé et joignable depuis l’extérieur de la machine, via TLS, et puis-je définir le mot de passe moi-même ?
• Puis-je modifier ServerSettings.ini directement, ou seulement via le panneau ?
• Le panneau conserve-t-il les bannissements et la rotation après les redémarrages et les réinstallations ?
• Puis-je connecter un panneau tiers au serveur, ou dois-je utiliser le vôtre ?

Référence non officielle de l’API RCON WARDOGS (wardogs.tech) ↗

BattleMetrics

BattleMetrics a ajouté WARDOGS à son service RCON : si ta communauté y gère déjà d’autres jeux, tu peux ajouter un serveur WARDOGS avec son adresse et son mot de passe RCON, et retrouver au même endroit sa liste de joueurs, ses outils d’expulsion et de bannissement, et ses logs.

C’est un service payant au-delà de l’offre gratuite, et il détient ton mot de passe RCON, qui donne ici un accès complet. C’est le prix à payer pour ne rien avoir à faire tourner toi-même.

BattleMetrics : prise en charge du RCON WARDOGS ↗

Warcon : un panneau RCON que tu peux héberger toi-même

Nous avons créé Warcon, un panneau RCON open source pour les serveurs dédiés WARDOGS. Il se place entre tes admins et le listener RCON du serveur : chaque admin a ainsi son propre identifiant et son propre rôle au lieu du mot de passe RCON partagé. Il gère plusieurs serveurs, tient un journal d’audit de qui a fait quoi et couvre les endpoints joueurs, bannissements, cartes et rotation présentés plus haut.

Il tourne sous Linux ou avec Docker, le code est sous licence MIT sur GitHub, et une console hébergée est disponible sur warcon.app si tu ne veux pas l’installer toi-même. Il te faut quand même un accès RCON chez ton hébergeur ; renseigne-toi avant de louer.

Warcon : panneau RCON open source pour WARDOGS ↗

Gérer un serveur avant d’avoir des outils

Aie des admins en jeu à tes heures de pointe. Reçois les signalements dans un seul salon Discord, avec une seule personne pour faire le tri. Garde un règlement court. Une expulsion ou un bannissement via l’API prend quelques secondes dès que quelqu’un a le mot de passe et un moyen d’envoyer une requête : mets ça en place dès le premier jour plutôt qu’après le premier griefer.