Fehlerbehebung
Das Plugin lädt nicht
Section titled “Das Plugin lädt nicht”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:
- Bestätige, dass die zwei Einstellungen vorhanden sind. Mit dem
Dashboard-Bundle sind sie bereits in
cfg/sourcemod/rookhelm.cfgbefüllt, die das Plugin automatisch lädt; hast du manuell konfiguriert, prüfe, dassrookhelm_api_urlundrookhelm_enrollment_tokenin derserver.cfgbeide gesetzt und nicht leer sind. - Bestätige, dass die Werte zu deiner Servers-Seite passen. Das Bundle neu herunterzuladen ist der einfachste Weg zu einer korrekten, vorbefüllten Config.
- 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. - 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.
Ein übernommener Server zeigt offline
Section titled “Ein übernommener Server zeigt offline”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.