Installer le plugin RookHelm

Ce guide vous accompagne pour connecter un serveur de jeu Source 1 à RookHelm. Le chemin le plus rapide est le bundle de plugins de votre tableau de bord : un seul téléchargement, déposez-le, redémarrez, et adoptez le serveur en un clic. Aucun fichier de config à modifier.

Jeux pris en charge

RookHelm fournit un seul bundle de plugins pour tous les jeux Source 1 qui font tourner SourceMod. La prise en charge vient de SourceMod, pas d’une liste de jeux autorisés : si votre jeu fait tourner SourceMod 1.12, le plugin se charge et fonctionne de la même façon.

Jeu	Moteur	Statut
Team Fortress 2	Source	Pris en charge
Counter-Strike: Source	Source	Pris en charge
Day of Defeat: Source	Source	Pris en charge
Left 4 Dead 2	Source	Pris en charge
Half-Life 2: Deathmatch	Source	Pris en charge
Tout autre jeu sous SourceMod	Source	Pris en charge
Garry’s Mod	Source	Pas encore pris en charge
Counter-Strike 2	Source 2	Pas encore pris en charge

Garry’s Mod ne fait pas tourner SourceMod tel quel, il lui faut donc une prise en charge dédiée - elle est prévue mais pas encore disponible.

Vous voulez la prise en charge d’un jeu absent de cette liste ? Écrivez à [email protected] - les demandes orientent ce que nous prendrons en charge ensuite.

Avant de commencer

Il vous faut :

• SourceMod 1.12 (stable) installé dans addons/sourcemod/.
• Un accès aux fichiers de votre serveur de jeu (FTP, SSH ou le gestionnaire de fichiers de votre hébergeur).
• Un siège admin dans une communauté RookHelm - le bundle de plugins se trouve sur la page Servers de votre tableau de bord. (Pas encore de communauté ? Demandez un accès.)

SourceMod 1.13 is not yet supported

RookHelm fournit actuellement une seule extension, compilée pour SourceMod 1.12. SourceMod 1.13 (ses builds master/dev) a introduit une nouvelle ABI d’extension incompatible : l’extension RookHelm actuelle ne s’y chargera pas - vous verrez Extension version is too old to load dans le log de votre serveur. Restez sur la branche stable 1.12 de SourceMod (et de Metamod:Source) jusqu’à la publication d’un build 1.13. Voir Dépannage si vous rencontrez ce cas.

Vous n’avez pas besoin d’installer REST in Pawn ni aucune autre extension séparément - l’extension RookHelm est incluse dans le bundle. Vous ne copiez pas non plus d’identifiants par serveur à la main ; le serveur reçoit sa clé automatiquement quand vous l’adoptez.

Étape 1 - Télécharger le bundle de plugins

Sur la page Servers, cliquez sur Download plugin bundle. Vous obtenez rookhelm-sourcemod-<community>.zip, qui contient :

• L’extension SourceMod RookHelm et son plugin compagnon.
• cfg/sourcemod/rookhelm.cfg, déjà rempli avec les deux réglages de votre communauté (rookhelm_api_url et rookhelm_enrollment_token).
• README.txt et les textes de licence.

Le jeton d’enrôlement est le même pour tous les serveurs de votre communauté ; le même bundle fonctionne donc sur toute votre flotte. Re-télécharger est sans risque - cela ne provoque pas de rotation du jeton.

Note

Le bundle embarque le jeton d’enrôlement de votre communauté. Détenir le jeton permet seulement à un serveur de s’annoncer dans votre liste d’attente - il ne donne aucun accès aux bans, aux mutes ni à aucune donnée de la communauté tant que vous n’adoptez pas explicitement le serveur. Traitez tout de même le zip comme n’importe quelle config contenant des identifiants : ne le publiez pas.

Étape 2 - Déposer et redémarrer

Extrayez le zip dans le répertoire du mod de votre jeu, de façon à fusionner ses dossiers addons/ et cfg/ avec votre installation existante :

unzip rookhelm-sourcemod-*.zip -d /path/to/srcds/

Puis redémarrez le serveur. Au démarrage, le plugin charge automatiquement le cfg/sourcemod/rookhelm.cfg fourni, lit les deux réglages, ouvre une connexion vers RookHelm et s’annonce.

Note

Il n’y a rien à éditer. Le bundle pré-remplit les deux réglages dans cfg/sourcemod/rookhelm.cfg, et le plugin charge ce fichier au démarrage : vous n’ajoutez jamais une ligne à server.cfg et ne copiez jamais un identifiant à la main.

Étape 3 - Adopter le serveur

De retour sur la page Servers, le serveur apparaît sous Pending servers en une minute environ, avec le nom et l’adresse qu’il déclare lui-même. Cliquez sur Adopt. L’adoption génère la clé de signature du serveur et la lui livre automatiquement - il n’y a rien à copier.

Chaque serveur, y compris le premier d’une communauté toute neuve, attend un clic d’adoption explicite. C’est voulu : un serveur n’a aucun pouvoir tant que vous n’avez pas confirmé qu’il est à vous.

À quoi ressemble la réussite

Une fois adopté, le statut du serveur passe à Online dès l’arrivée de son premier heartbeat, généralement en quelques secondes. Bans, mutes et nombres de joueurs commencent alors à remonter vers votre tableau de bord.

Si vous avez lancé le téléchargement depuis le tableau de bord, la carte d’installation de la page Servers avance toute seule - des étapes d’installation à « Server detected » quand la ligne en attente apparaît, puis à « Heartbeat received. Plugin installed » une fois que le serveur adopté se manifeste.

Vérifier le téléchargement (facultatif)

Chaque version publie un fichier SHA256SUMS. Pour confirmer que le bundle est arrivé intact :

sha256sum -c SHA256SUMS
# Expected: "rookhelm-sourcemod-v<version>.zip: OK"

Les binaires publiés sont produits par la chaîne de publication RookHelm. L’extension combine du code GPL-3.0 et du code propriétaire ; NOTICE.txt dans le bundle explique comment demander les sources de la partie GPL-3.0.

Configurer manuellement (avancé)

Si vous gérez vos configs vous-même au lieu d’utiliser le bundle, il ne vous faut que deux réglages. Copiez-les depuis la page Servers et ajoutez-les à une config exécutée au démarrage du serveur, comme cfg/server.cfg :

rookhelm_api_url           "https://api.rookhelm.com"
rookhelm_enrollment_token  "your-community-enrollment-token"

Redémarrez le serveur (ou changez de carte) pour que le plugin les lise, puis adoptez le serveur comme à l’étape 3. Les valeurs définies ainsi sont sûres : le plugin ne charge automatiquement cfg/sourcemod/rookhelm.cfg que si ce fichier est présent (il n’est fourni que dans le bundle du tableau de bord), donc une configuration manuelle dans server.cfg n’est jamais écrasée.

ConVar	Description
rookhelm_api_url	URL de base du point de connexion RookHelm. Le bundle du tableau de bord la pré-remplit.
rookhelm_enrollment_token	Votre jeton d’enrôlement de communauté - une seule valeur, identique sur tous les serveurs, collée une seule fois. Le bundle du tableau de bord la pré-remplit.

Les deux ConVars sont FCVAR_PROTECTED : leurs valeurs restent masquées dans cvarlist et ne peuvent pas être lues depuis le chat. La clé de signature par serveur n’est jamais une ConVar - le serveur la reçoit et la stocke lui-même quand vous l’adoptez.

Rotation des identifiants

• Jeton d’enrôlement : en cas de fuite, effectuez sa rotation depuis le tableau de bord. Les serveurs déjà adoptés continuent de fonctionner - leur clé par serveur est indépendante du jeton d’enrôlement. Les serveurs pas encore adoptés auront besoin d’un bundle frais.
• La clé de signature d’un serveur : si la clé d’un serveur est perdue ou compromise, utilisez Reissue keys sur la page du serveur. La nouvelle clé est livrée au serveur à sa prochaine reconnexion ; vous ne la copiez jamais à la main.

---

Besoin d’aide ?

Si un serveur n’apparaît pas comme en attente après un redémarrage, ou ne passe pas en ligne après l’adoption, consultez le Dépannage.

Demander un accès