Zum Inhalt springen

Fehlerbehebung

Logzeile: [SM] Unable to load plugin "rookhelm.smx"

Prüfe Folgendes:

  • SourceMod 1.12 (stable) ist unter addons/sourcemod/ installiert. Ältere Versionen werden nicht unterstützt, und SourceMod 1.13 noch nicht - siehe Die Extension lädt nicht und meldet einen Versionsfehler weiter unten.
  • Du hast das ganze Bundle entpackt, sodass sein addons/-Ordner mit deiner SourceMod-Installation verschmolzen ist - die Extension (addons/sourcemod/extensions/rookhelm.ext.so) und das Begleit-Plugin (addons/sourcemod/plugins/rookhelm.smx) müssen beide vorhanden sein.
  • Die Dateien sind nicht beschädigt. Lade das Bundle neu aus deinem Dashboard herunter und prüfe es gegen SHA256SUMS.

Die Extension lädt nicht und meldet einen Versionsfehler

Section titled “Die Extension lädt nicht und meldet einen Versionsfehler”

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

Das bedeutet, dass dein SourceMod-Build und die RookHelm-Extension gegen inkompatible Extension-ABI-Versionen gebaut wurden. SourceMod lädt nur Extensions, deren gemeldete Version in dem Bereich liegt, den der laufende Build akzeptiert, und SourceMod 1.13 hat diese ABI geändert - eine für 1.12 gebaute Extension meldet eine ältere Version, als 1.13 akzeptiert (too old), und umgekehrt (too new). Metamod:Source ist nicht beteiligt; das ist rein der Extension-Loader von SourceMod.

RookHelm liefert derzeit eine Extension, gebaut für SourceMod 1.12 (stable). So behebst du es:

  • Nutze den stabilen 1.12-Branch von SourceMod (und Metamod:Source). Die Dev-/master-Builds sind 1.13 und lehnen die aktuelle Extension ab.
  • Wenn du absichtlich auf 1.13 testest, gibt es noch keinen Workaround - eine einzelne Extension-Binary kann nicht 1.12 und 1.13 zugleich bedienen, ein 1.13-Build muss also separat veröffentlicht werden. Er steht auf der Roadmap.

Wenn die Extension nicht lädt, kann auch das Begleit-Plugin (rookhelm.smx) nicht laden - es setzt die Extension voraus. Der Server verbindet sich also nie und bleibt auf deinem Dashboard auf Never connected. Die SourceMod-Version zu korrigieren behebt beides.

Der Server erscheint nach einem Neustart nicht als pending

Section titled “Der Server erscheint nach einem Neustart nicht als pending”

Nachdem du das Bundle eingespielt und neu gestartet hast, sollte der Server innerhalb von etwa einer Minute unter Pending servers auf deinem Dashboard auftauchen. Falls nicht:

  1. Bestätige, dass die zwei Einstellungen vorhanden sind. Mit dem Dashboard-Bundle sind sie bereits in cfg/sourcemod/rookhelm.cfg befüllt, die das Plugin automatisch lädt; hast du manuell konfiguriert, prüfe, dass rookhelm_api_url und rookhelm_enrollment_token in der server.cfg beide gesetzt und nicht leer sind.
  2. Bestätige, dass die Werte zu deiner Servers-Seite passen. Das Bundle neu herunterzuladen ist der einfachste Weg zu einer korrekten, vorbefüllten Config.
  3. Bestätige, dass der Server RookHelm erreichen kann. Der Server öffnet einen ausgehenden sicheren WebSocket zu rookhelm_api_url; eine Firewall, die ausgehendes 443 blockt, verhindert das Enrollment. Die meisten Hoster erlauben das standardmäßig.
  4. Sieh im Serverlog rund um den Start nach einer RookHelm-Zeile, die beschreibt, warum die Verbindung abgelehnt wurde (zum Beispiel ein unbekannter Enrollment-Token).

Wurde der Token im Dashboard rotiert, funktioniert der Token eines alten Bundles nicht mehr - lade ein frisches Bundle herunter.

Der Server ist pending, kommt aber nicht online

Section titled “Der Server ist pending, kommt aber nicht online”

Ein pending Server hat sich angekündigt, ist aber noch nicht vertraut. Öffne die Servers-Seite und klicke auf Adopt auf seiner Karte. Nur Admins und Owner können übernehmen. Das Übernehmen liefert den Signing Key des Servers automatisch aus - es gibt nichts zu kopieren.

Name und Adresse auf einer Pending-Karte meldet der Server selbst; sie sind bis zur Übernahme nicht verifiziert. Bestätige also vor dem Übernehmen, dass die Adresse zu dem Server passt, den du erwartest.

Was du siehst: Der Server war online, und jetzt ist sein Status offline (kein Heartbeat seit mehr als zwei Minuten).

Der Server verbindet sich von selbst neu und weist seinen Key nach einem Neustart, Mapwechsel oder Netzwerkaussetzer erneut nach - ein kurzer Offline-Blip verschwindet also meist von allein. Bleibt er offline:

  • Bestätige, dass der Gameserver-Prozess läuft und erreichbar ist.
  • Bestätige, dass ausgehendes 443 weiterhin offen ist (siehe oben).
  • Wurde der Signing Key des Servers verloren oder die Maschine neu aufgesetzt, öffne die Seite des Servers und nutze Reissue keys. Der neue Key erreicht den Server beim nächsten Reconnect - du kopierst ihn nie von Hand.