Das RookHelm-Plugin installieren

Diese Anleitung führt dich durch das Verbinden eines Source-1-Gameservers mit RookHelm. Der schnellste Weg ist das Plugin-Bundle aus deinem Dashboard: einmal herunterladen, reinlegen, neu starten und den Server mit einem Klick übernehmen. Kein Config-Editieren.

Unterstützte Spiele

RookHelm liefert ein Plugin-Bundle für jedes Source-1-Spiel, das SourceMod ausführt. Die Unterstützung kommt von SourceMod, nicht von einer Allowlist pro Spiel: Wenn dein Spiel SourceMod 1.12 ausführt, lädt das Plugin und funktioniert überall gleich.

Spiel	Engine	Status
Team Fortress 2	Source	Unterstützt
Counter-Strike: Source	Source	Unterstützt
Day of Defeat: Source	Source	Unterstützt
Left 4 Dead 2	Source	Unterstützt
Half-Life 2: Deathmatch	Source	Unterstützt
Jedes andere Spiel mit SourceMod	Source	Unterstützt
Garry’s Mod	Source	Noch nicht unterstützt
Counter-Strike 2	Source 2	Noch nicht unterstützt

Garry’s Mod läuft nicht mit Stock-SourceMod und braucht daher eigene Unterstützung - sie ist geplant, aber noch nicht verfügbar.

Du willst Unterstützung für ein Spiel, das hier nicht steht? Schreib an [email protected] - Anfragen bestimmen, was wir als Nächstes unterstützen.

Bevor du startest

Du brauchst:

• SourceMod 1.12 (stable), installiert unter addons/sourcemod/.
• Zugriff auf die Dateien deines Gameservers (FTP, SSH oder der Dateimanager deines Hosts).
• Einen Admin-Platz in einer RookHelm-Community - das Plugin-Bundle liegt auf der Servers-Seite deines Dashboards. (Noch keine Community? Fordere Zugang an.)

SourceMod 1.13 is not yet supported

RookHelm liefert derzeit eine einzige Extension, gebaut für SourceMod 1.12. SourceMod 1.13 (die master-/Dev-Builds) hat eine neue, inkompatible Extension-ABI eingeführt, daher lädt die aktuelle RookHelm-Extension dort nicht - du siehst Extension version is too old to load in deinem Serverlog. Bleib auf dem stabilen 1.12-Branch von SourceMod (und Metamod:Source), bis ein 1.13-Build veröffentlicht ist. Siehe Fehlerbehebung, falls du darauf stößt.

Du musst REST in Pawn oder irgendeine andere Extension nicht separat installieren - die RookHelm-Extension ist im Bundle enthalten. Du kopierst auch keine Server-Zugangsdaten von Hand; der Server erhält seinen Key automatisch, wenn du ihn übernimmst.

Schritt 1 - Plugin-Bundle herunterladen

Klicke auf der Servers-Seite auf Download plugin bundle. Du bekommst rookhelm-sourcemod-<community>.zip mit folgendem Inhalt:

• Die RookHelm-SourceMod-Extension und ihr Begleit-Plugin.
• cfg/sourcemod/rookhelm.cfg, bereits befüllt mit den zwei Einstellungen deiner Community (rookhelm_api_url und rookhelm_enrollment_token).
• README.txt und die Lizenztexte.

Der Enrollment-Token ist für jeden Server deiner Community derselbe, dasselbe Bundle funktioniert also auf deiner ganzen Flotte. Erneutes Herunterladen ist unbedenklich - es rotiert deinen Token nicht.

Hinweis

Das Bundle enthält den Enrollment-Token deiner Community. Wer den Token hat, kann einen Server nur in deiner Pending-Liste ankündigen - er erhält keinen Zugriff auf Bans, Mutes oder andere Community-Daten, bis du den Server ausdrücklich übernimmst. Behandle das Zip trotzdem wie jede Config mit Zugangsdaten: Poste es nicht öffentlich.

Schritt 2 - Reinlegen und neu starten

Entpacke das Zip ins Mod-Verzeichnis deines Spiels, sodass seine Ordner addons/ und cfg/ mit deiner bestehenden Installation verschmelzen:

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

Starte dann den Server neu. Beim Start lädt das Plugin die mitgelieferte cfg/sourcemod/rookhelm.cfg automatisch, liest die zwei Einstellungen, öffnet eine Verbindung zu RookHelm und kündigt sich an.

Hinweis

Es gibt nichts zu editieren. Das Bundle befüllt die zwei Einstellungen in cfg/sourcemod/rookhelm.cfg vor, und das Plugin lädt die Datei beim Start - du fügst also nie eine Zeile zur server.cfg hinzu und kopierst nie Zugangsdaten von Hand.

Schritt 3 - Server übernehmen

Zurück auf der Servers-Seite erscheint der Server innerhalb von etwa einer Minute unter Pending servers, mit dem selbst gemeldeten Namen und der Adresse. Klicke auf Adopt. Das Übernehmen erstellt den Signing Key des Servers und liefert ihn automatisch aus - es gibt nichts zu kopieren.

Jeder Server, auch der erste in einer brandneuen Community, wartet auf einen ausdrücklichen Adopt-Klick. Das ist Absicht: Ein Server hat keinerlei Rechte, bis du bestätigst, dass er dir gehört.

So sieht Erfolg aus

Nach dem Übernehmen wechselt der Status des Servers auf Online, sobald sein erster Heartbeat ankommt - meist innerhalb weniger Sekunden. Ab da fließen Bans, Mutes und Spielerzahlen in dein Dashboard.

Wenn du den Download aus dem Dashboard angestoßen hast, läuft die Install-Karte auf der Servers-Seite von selbst weiter - von den Installationsschritten über “Server detected”, sobald die Pending-Zeile erscheint, bis “Heartbeat received. Plugin installed”, sobald der übernommene Server sich meldet.

Download prüfen (optional)

Jedes Release enthält eine SHA256SUMS-Datei. So bestätigst du, dass das Bundle unversehrt übertragen wurde:

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

Die veröffentlichten Binaries stammen aus der RookHelm-Release-Pipeline. Die Extension kombiniert GPL-3.0- und proprietären Code; die NOTICE.txt im Bundle erklärt, wie du den Quellcode für den GPL-3.0-Teil anforderst.

Manuell konfigurieren (für Fortgeschrittene)

Wenn du deine Configs selbst verwaltest, statt das Bundle zu nutzen, brauchst du nur zwei Einstellungen. Kopiere beide von der Servers-Seite und füge sie in eine Config ein, die der Server beim Start ausführt, etwa cfg/server.cfg:

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

Starte den Server neu (oder wechsle die Map), damit das Plugin sie liest, und übernimm den Server dann wie in Schritt 3. Werte, die du so setzt, sind sicher: Das Plugin lädt cfg/sourcemod/rookhelm.cfg nur automatisch, wenn die Datei vorhanden ist (sie kommt nur im Dashboard-Bundle mit), ein manuelles server.cfg-Setup wird also nie überschrieben.

ConVar	Beschreibung
rookhelm_api_url	Basis-URL des RookHelm-Connect-Endpunkts. Das Dashboard-Bundle befüllt sie vor.
rookhelm_enrollment_token	Dein Community-Enrollment-Token - ein Wert, auf jedem Server derselbe, einmal eingefügt. Das Dashboard-Bundle befüllt ihn vor.

Beide ConVars sind FCVAR_PROTECTED, ihre Werte bleiben also in cvarlist verborgen und lassen sich nicht aus dem Chat auslesen. Der Signing Key pro Server ist nie eine ConVar - der Server erhält und speichert ihn selbst, wenn du ihn übernimmst.

Zugangsdaten rotieren

• Enrollment-Token: rotiere ihn im Dashboard, falls er geleakt ist. Bereits übernommene Server laufen weiter - ihr Signing Key ist vom Enrollment-Token unabhängig. Server, die noch nicht übernommen sind, brauchen ein frisches Bundle.
• Signing Key eines Servers: Ist der Key eines Servers verloren oder kompromittiert, nutze Reissue keys auf der Seite des Servers. Der neue Key wird beim nächsten Reconnect an den Server ausgeliefert; du kopierst ihn nie von Hand.

---

Brauchst du mehr Hilfe?

Wenn ein Server nach einem Neustart nicht als pending erscheint oder nach dem Übernehmen nicht online kommt, sieh in der Fehlerbehebung nach.

Zugang anfordern