Dépannage

Le plugin ne se charge pas

Ligne de log : [SM] Unable to load plugin "rookhelm.smx"

Vérifiez que :

SourceMod 1.12 (stable) est installé dans addons/sourcemod/. Les versions plus anciennes ne sont pas prises en charge, et SourceMod 1.13 ne l’est pas encore non plus - voir L’extension ne se charge pas avec une erreur de version ci-dessous.
Vous avez extrait le bundle entier, de sorte que son dossier addons/ a fusionné avec votre installation SourceMod - l’extension (addons/sourcemod/extensions/rookhelm.ext.so) et le plugin compagnon (addons/sourcemod/plugins/rookhelm.smx) doivent tous deux être présents.
Les fichiers ne sont pas corrompus. Re-téléchargez le bundle depuis votre tableau de bord et vérifiez-le avec SHA256SUMS.

L’extension ne se charge pas avec une erreur de version

Ligne de log : <FAILED> file "rookhelm.ext.so": Extension version is too old to load (8, max is 9) (ou ... too new to load).

Cela signifie que votre build SourceMod et l’extension RookHelm ont été compilés contre des versions incompatibles de l’ABI d’extension. SourceMod ne charge une extension que si la version qu’elle annonce tombe dans la plage acceptée par le build en cours, et SourceMod 1.13 a changé cette ABI - une extension compilée pour 1.12 annonce une version plus ancienne que ce que 1.13 accepte (too old), et inversement (too new). Metamod:Source n’est pas en cause ; c’est purement le chargeur d’extensions de SourceMod.

RookHelm fournit actuellement une seule extension, compilée pour SourceMod 1.12 (stable). Pour corriger :

Utilisez la branche stable 1.12 de SourceMod (et de Metamod:Source). Les builds dev/master sont en 1.13 et rejetteront l’extension actuelle.
Si vous testez volontairement sur 1.13, il n’existe pas encore de contournement - un seul binaire d’extension ne peut pas satisfaire à la fois 1.12 et 1.13, un build 1.13 doit donc être publié séparément. C’est sur la feuille de route.

Quand l’extension ne se charge pas, le plugin compagnon (rookhelm.smx) ne peut pas se charger non plus - il dépend de l’extension - donc le serveur ne se connecte jamais et reste Never connected sur votre tableau de bord. Corriger la version de SourceMod règle les deux.

Le serveur n’apparaît pas comme en attente après un redémarrage

Après avoir déposé le bundle et redémarré, le serveur devrait apparaître sous Pending servers sur votre tableau de bord en une minute environ. Sinon :

Confirmez que les deux réglages sont présents. Si vous avez utilisé le bundle du tableau de bord, ils sont déjà remplis dans cfg/sourcemod/rookhelm.cfg, que le plugin charge automatiquement ; si vous avez configuré manuellement, vérifiez que rookhelm_api_url et rookhelm_enrollment_token sont tous deux définis et non vides dans server.cfg.
Confirmez que les valeurs correspondent à votre page Servers. Re-télécharger le bundle est le moyen le plus simple d’obtenir une config correcte et pré-remplie.
Confirmez que le serveur peut joindre RookHelm. Le serveur ouvre une WebSocket sécurisée sortante vers rookhelm_api_url ; un pare-feu qui bloque le 443 sortant empêchera l’enrôlement. La plupart des hébergeurs l’autorisent par défaut.
Consultez le log du serveur autour du démarrage : une ligne RookHelm y décrit pourquoi la connexion a été refusée (par exemple, un jeton d’enrôlement inconnu).

Si le jeton a fait l’objet d’une rotation depuis le tableau de bord, le jeton d’un ancien bundle ne fonctionne plus - téléchargez un bundle frais.

Le serveur est en attente mais ne passe pas en ligne

Un serveur en attente s’est annoncé mais n’est pas encore de confiance. Ouvrez la page Servers et cliquez sur Adopt sur sa carte. Seuls les admins et les propriétaires peuvent adopter. L’adoption livre la clé de signature du serveur automatiquement - il n’y a rien à copier.

Le nom et l’adresse d’une carte en attente sont déclarés par le serveur lui-même et ne sont pas vérifiés avant l’adoption ; confirmez donc que l’adresse correspond au serveur attendu avant d’adopter.

Un serveur adopté apparaît hors ligne

Ce que vous voyez : le serveur était en ligne, et son statut est maintenant hors ligne (aucun heartbeat depuis plus de deux minutes).

Le serveur se reconnecte tout seul et re-prouve sa clé après un redémarrage, un changement de carte ou un incident réseau ; un bref passage hors ligne se résout donc généralement de lui-même. S’il reste hors ligne :

Confirmez que le processus du serveur de jeu tourne et est joignable.
Confirmez que le 443 sortant est toujours ouvert (voir plus haut).
Si la clé de signature du serveur a été perdue ou si la machine a été reconstruite, ouvrez la page du serveur et utilisez Reissue keys. La nouvelle clé atteint le serveur à sa prochaine reconnexion - vous ne la copiez jamais à la main.