Metamod und CounterStrikeSharp auf CS2 installieren: Windows und Linux
In dieser Anleitung installieren Sie die beiden Schichten, die Sie benötigen, um auf Ihrem Counter-Strike-2-Server (CS2) Plugins auszuführen: Metamod:Source und das darauf aufbauende CounterStrikeSharp (CS#). Sie sehen Schritt für Schritt, wie Sie die Dateien unter Windows und Linux ablegen, gameinfo.gi bearbeiten, die Installation prüfen, Admins festlegen und was nach Spielupdates zu tun ist. Die Schritte beruhen auf der offiziellen Installationsdokumentation von CounterStrikeSharp und der Installationsseite für Metamod:Source von AlliedModders. Weitere Themen finden Sie auf der Seite Counter-Strike-2-Anleitungen.
Bevor Sie beginnen
Das SourceMod aus der CS:GO-Zeit funktioniert in CS2 nicht: In der Versionstabelle von AlliedModders ist SourceMod für CS2 als „Unsupported“ (nicht unterstützt) und Metamod:Source als „Current Development“ (Entwicklungsversion) aufgeführt. CounterStrikeSharp ist ein Plugin-Framework, das von Metamod geladen wird; Plugins dafür werden in C# entwickelt. Bereiten Sie vor der Installation Folgendes vor:
- Ein laufender CS2-Server: Der Server muss mit SteamCMD installiert sein und Spieler annehmen. Falls Sie ihn noch nicht eingerichtet haben, folgen Sie zuerst der Anleitung zur Installation eines CS2-Servers. Die Pfade hier beziehen sich auf die Installation aus dieser Anleitung: unter Windows
C:\cs2-ds, unter Linux beim Benutzersteamder Ordner/home/steam/cs2-ds. Wenn Sie noch keinen Server haben, finden Sie die Pakete auf der Seite CS2-Server. - Entwickler-Build (Dev Build) von Metamod:Source 2.x: Die CS#-Dokumentation verlangt einen Build 1467 oder neuer mit KHook-Unterstützung. Verwenden Sie auf der Download-Seite den Bereich „Dev Builds“ (Branch master):
metamodsource.net/downloads.php?branch=master. Die Dateinamen haben das Formatmmsource-2.0.0-git<build>-windows.zipundmmsource-2.0.0-git<build>-linux.tar.gz. - CounterStrikeSharp-Paket „with-runtime“: Es wird auf der Seite „Releases“ unter
github.com/roflmuffin/CounterStrikeSharp/releasesheruntergeladen. Bei der Erstinstallation müssen Sie das Paket wählen, dessen Namewith-runtimeenthält; es bringt die .NET-Laufzeitumgebung (Runtime) mit, die die Plugins benötigen. - Visual C++ Redistributable unter Windows: Laut CS#-Dokumentation funktioniert CS# nicht, wenn dieses Paket nicht installiert ist. Installieren Sie das X64-Paket von der Seite zu Visual C++ Redistributable von Microsoft.
- ICU-Bibliothek und unzip unter Linux: Damit .NET läuft, kann je nach Distribution
libicuerforderlich sein; zum Entpacken des CS#-Archivs brauchen Sie außerdemunzip. Beides installieren Sie in Schritt 4. - Backup: Sichern Sie Ihren Ordner
game/csgo/cfg. Bei VDS-Diensten sind automatische Backups nicht enthalten; für Backups sind Sie selbst verantwortlich.
1. Metamod:Source-Dateien ablegen
Bevor Sie Dateien kopieren, beenden Sie den Server, indem Sie in der Serverkonsole quit eingeben. Das Metamod-Archiv enthält einen Ordner addons; dieser wird unverändert in den Ordner game/csgo des Servers kopiert.
Windows
- Laden Sie auf der Download-Seite die Datei
mmsource-2.0.0-git<build>-windows.zipherunter. - Klicken Sie mit der rechten Maustaste auf die Datei und entpacken Sie sie mit „Extract All“ (Alle extrahieren) in einen Ordner.
- Kopieren Sie den entpackten Ordner
addonsnachC:\cs2-ds\game\csgo\. Anschließend muss der OrdnerC:\cs2-ds\game\csgo\addons\metamodexistieren.
Linux
Führen Sie die Befehle als Benutzer steam aus; werden die Dateien als root kopiert, kann der Benutzer, unter dem der Server läuft, möglicherweise nicht in sie schreiben. Der Download-Server von AlliedModders liefert unter der Adresse mmsource-latest-linux den Dateinamen des neuesten Linux-Builds:
sudo -iu steam
MM=$(curl -s https://mms.alliedmods.net/mmsdrop/2.0/mmsource-latest-linux)
curl -sLO "https://mms.alliedmods.net/mmsdrop/2.0/$MM"
mkdir -p ~/mm && tar -xzf "$MM" -C ~/mm
cp -r ~/mm/addons ~/cs2-ds/game/csgo/
Danach muss in der Ausgabe des Befehls ls ~/cs2-ds/game/csgo/addons der Ordner metamod erscheinen.
2. Metamod-Zeile in gameinfo.gi eintragen
Laut AlliedModders gibt es in Source 2 keine Unterstützung für Server-Plugins, daher wird Metamod über eine Zeile geladen, die in die Datei gameinfo.gi eingetragen wird. Die Datei liegt unter Windows unter C:\cs2-ds\game\csgo\gameinfo.gi, unter Linux unter /home/steam/cs2-ds/game/csgo/gameinfo.gi. Erstellen Sie zuerst eine Kopie und öffnen Sie die Datei dann mit einem Editor wie Notepad oder nano.
Suchen Sie den Abschnitt SearchPaths; fügen Sie nach dem Zeichen { und vor allen Game-Zeilen eine neue Zeile ein und schreiben Sie Game csgo/addons/metamod. In der CS2-Datei liegt diese Position, wie auch die CS#-Dokumentation beschreibt, direkt unter der Zeile Game_LowViolence csgo_lv. Der bearbeitete Abschnitt sollte etwa so aussehen; die übrigen Zeilen Ihrer Datei können je nach Version abweichen:
SearchPaths
{
Game_LowViolence csgo_lv
Game csgo/addons/metamod
Game csgo
...
}
Beachten Sie Folgendes: Laut AlliedModders muss die Metamod-Zeile der erste Game-Eintrag der Liste sein; die Liste ist geordnet, und eine an anderer Stelle eingetragene Zeile lädt Metamod nicht. Wenn Sie statt Game den Eintrag GameBin schreiben, funktioniert es nicht. Auch wenn Sie der Hinweis „DO NOT EDIT THIS FILE DIRECTLY“ in der Datei auf die Datei csgo_core/gameinfo.gi verweist, lädt eine Bearbeitung jener Datei Metamod nicht; die richtige Datei ist csgo/gameinfo.gi. Unter Windows müssen Sie den Pfad nicht mit Backslashes schreiben.
3. Prüfen, ob Metamod geladen wird
Starten Sie den Server mit der üblichen Startzeile: unter Windows start.bat, unter Linux ./cs2.sh in der tmux-Sitzung. Geben Sie nach dem Laden der Map in der Serverkonsole Folgendes ein:
meta version
Sehen Sie in der Ausgabe eine Zeile im Format Metamod:Source version 2.x.x, läuft Metamod. Wird der Befehl nicht erkannt (Unknown command), fahren Sie nicht mit dem nächsten Schritt fort; führen Sie zuerst die Prüfungen im Abschnitt „Häufige Fehler“ durch.
4. CounterStrikeSharp installieren
Beenden Sie den Server erneut mit quit. Auf der Seite „Releases“ gibt es für jede Version vier Pakete:
| Paket | Wann verwenden |
|---|---|
counterstrikesharp-with-runtime-windows-<version>.zip | Erstinstallation unter Windows |
counterstrikesharp-with-runtime-linux-<version>.zip | Erstinstallation unter Linux |
counterstrikesharp-windows-<version>.zip | Update unter Windows; nur wenn Sie die .NET-Laufzeitumgebung selbst aktuell halten |
counterstrikesharp-linux-<version>.zip | Update unter Linux; unter derselben Bedingung |
Windows
- Stellen Sie sicher, dass Visual C++ Redistributable (X64) installiert ist.
- Laden Sie das Paket
with-runtime-windowsherunter und entpacken Sie es mit „Extract All“. - Kopieren Sie den entpackten Ordner
addonsnachC:\cs2-ds\game\csgo\. Der Ordner wird mit dem vorhandenenaddonszusammengeführt: Die Metamod-Dateien bleiben erhalten, daneben kommt der Ordnercounterstrikesharphinzu.
Linux
Installieren Sie zuerst mit dem Administratorkonto die benötigten Pakete (sind Sie als Benutzer steam angemeldet, verlassen Sie diese Sitzung mit exit):
# Ubuntu / Debian
sudo apt-get update
sudo apt-get install unzip libicu-dev
# AlmaLinux
sudo dnf install unzip libicu
Laden und entpacken Sie das Paket anschließend als Benutzer steam. Ersetzen Sie den Wert 1.0.378 im Beispiel durch die aktuelle Version auf der Seite „Releases“; der Buchstabe v am Anfang des Versions-Tags ist nicht Teil des Dateinamens:
sudo -iu steam
SURUM=1.0.378
curl -sLO "https://github.com/roflmuffin/CounterStrikeSharp/releases/download/v$SURUM/counterstrikesharp-with-runtime-linux-$SURUM.zip"
mkdir -p ~/css && unzip -o "counterstrikesharp-with-runtime-linux-$SURUM.zip" -d ~/css
cp -r ~/css/addons ~/cs2-ds/game/csgo/
Falls Sie versehentlich als root kopiert haben, korrigieren Sie den Besitzer: sudo chown -R steam:steam /home/steam/cs2-ds/game/csgo/addons
5. CounterStrikeSharp prüfen
Starten Sie den Server. Beim Start sollte in der Konsole die Zeile CounterStrikeSharp.API Loaded Successfully. erscheinen. Geben Sie danach meta list ein; erwartet wird, dass genau ein Plugin aufgelistet wird (die Version in Klammern kann abweichen):
meta list
Listing 1 plugin:
[01] CounterStrikeSharp (...) by Roflmuffin
Auch die eigenen Befehle der CS#-Schicht funktionieren jetzt: css zeigt die API-Version, css_plugins list die geladenen C#-Plugins. Um diese Befehle im Spiel zu verwenden, ist die Berechtigung @css/generic erforderlich; in der Serverkonsole wird keine Berechtigung verlangt. Die Ordnerstruktur sollte in etwa so aussehen:
game/csgo/addons
├── counterstrikesharp
│ ├── api
│ ├── bin
│ ├── configs
│ ├── dotnet
│ ├── gamedata
│ └── plugins
├── metamod
│ ├── bin
│ ├── counterstrikesharp.vdf
│ └── metaplugins.ini
├── metamod.vdf
└── metamod_x64.vdf
6. Grundeinstellungen vornehmen: core.json
Die allgemeinen Einstellungen von CS# stehen in der Datei addons/counterstrikesharp/configs/core.json. Fehlt die Datei, wird sie beim ersten Start aus der danebenliegenden Vorlage core.example.json erstellt. Starten Sie den Server nach einer Änderung neu oder geben Sie in der Konsole css_core_reload ein. Die wichtigen Schlüssel der Beispieldatei und ihre Standardwerte:
| Schlüssel | Standard | Funktion |
|---|---|---|
PublicChatTrigger | ["!"] | Für alle sichtbares Präfix, mit dem Plugin-Befehle im Chat aufgerufen werden |
SilentChatTrigger | ["/"] | Präfix, das dasselbe tut, ohne die Nachricht im Chat anzuzeigen |
FollowCS2ServerGuidelines | true | Blockiert Funktionen, die bekanntermaßen gegen die Serverrichtlinien von Valve verstoßen und zu einer GSLT-Sperre führen können; lassen Sie die Option aktiviert |
PluginHotReloadEnabled | true | Lädt ein Plugin automatisch neu, wenn sich seine .dll-Datei ändert |
PluginAutoLoadEnabled | true | Lädt beim Start die Plugins im Ordner plugins |
ServerLanguage | "en" | Standardsprache der Serverbefehle und -nachrichten (z. B. "de"); bei einem unbekannten Wert wird auf en zurückgegriffen |
AutoUpdateEnabled | true | Prüft, ob es für die Spieldatendatei gamedata.json ein Update gibt, und lädt es gegebenenfalls herunter |
7. Admins festlegen: admins.json
Das Berechtigungssystem von CS# liest die Admins beim Start aus der Datei addons/counterstrikesharp/configs/admins.json. Fehlt die Datei, werden keine Admins geladen; erstellen Sie sie, indem Sie die Vorlage admins.example.json im selben Ordner kopieren, oder legen Sie sie neu an. Jeder Eintrag enthält einen Namen, eine SteamID und eine Liste von Berechtigungen:
{
"Serverinhaber": {
"identity": "IHRE_STEAMID64",
"flags": ["@css/root"]
},
"Moderator": {
"identity": "STEAM_0:1:1",
"flags": ["@css/generic", "@css/kick", "@css/ban", "@css/changemap"]
}
}
Das Feld identity akzeptiert die 17-stellige SteamID64 oder das Format STEAM_0:1:1. Berechtigungen müssen unbedingt mit @ beginnen, sonst werden sie nicht erkannt. @css/generic vergibt allgemeine Admin-Rechte, @css/reservation einen reservierten Slot, @css/rcon RCON-Befehle und @css/root alle Berechtigungen. Geben Sie nach dem Speichern der Datei in der Konsole css_admins_reload ein und prüfen Sie das Ergebnis mit css_admins_list.
CS# bringt von sich aus keine Admin-Befehle wie !kick oder !ban mit; diese Befehle stellen die installierten Plugins bereit. Zu reservierten Slots und VIP-Einstellungen lesen Sie die Anleitung zum CS2-VIP-System.
8. Das erste Plugin hinzufügen
Jedes Plugin wird unter addons/counterstrikesharp/plugins in einem Ordner abgelegt, der denselben Namen wie die .dll-Datei trägt: plugins/BeispielPlugin/BeispielPlugin.dll. Ist PluginAutoLoadEnabled aktiviert, wird das Plugin beim nächsten Start automatisch geladen. Um es ohne Herunterfahren des Servers zu laden und das Ergebnis zu sehen, geben Sie in der Konsole Folgendes ein:
css_plugins load BeispielPlugin
css_plugins list
Zum Finden von Plugins, zu Abhängigkeiten, Konfigurationsdateien und zur Fehlerbehebung wechseln Sie zur Anleitung zum Installieren von CS2-Plugins.
9. Nach Updates prüfen
AlliedModders weist darauf hin, dass Sie die Metamod-Zeile jedes Mal neu eintragen müssen, wenn Valve die Datei gameinfo.gi ändert. Auch validate in SteamCMD überschreibt geänderte Standarddateien; den Ordner addons, der nicht zur Standardinstallation gehört, lässt es dagegen unberührt. Gehen Sie daher nach jedem CS2-Update so vor:
- Starten Sie den Server und geben Sie
meta versionein. Wird der Befehl nicht erkannt, öffnen Siegameinfo.giund tragen Sie die Zeile wie in Schritt 2 erneut ein. Spielen Sie nicht einfach die alte Sicherung zurück; Valve hat in der Datei möglicherweise weitere Änderungen vorgenommen. - Prüfen Sie mit
meta list, ob CS# geladen wird. Melden Plugins Fehler, sehen Sie auf der Seite „Releases“ nach, ob es eine neue CS#-Version gibt.
Um CS# zu aktualisieren, kopieren Sie die neue Version wie bei der Erstinstallation an dieselbe Stelle; laut CS#-Dokumentation werden Ihre Konfigurationsdateien dabei nicht überschrieben. Wenn Sie die .NET-Laufzeitumgebung nicht selbst aktuell halten, wählen Sie auch beim Update das Paket with-runtime.
Häufige Fehler
meta versionliefertUnknown command: Die Zeile wurde in die falsche Datei (csgo_core/gameinfo.gi) oder an der falschen Position eingetragen, es wurdeGameBingeschrieben, oder der Ordneraddonswurde an die falsche Stelle kopiert (häufiges Beispiel:game/csgo/addons/addons). Möglicherweise hat auch das letzte Spielupdate die Zeile entfernt. AlliedModders empfiehlt außerdem, das Spiel und Metamod auf die neueste Version zu aktualisieren.- Metamod läuft, aber
meta listzeigt CS# nicht an: Fehlt die Dateiaddons/metamod/counterstrikesharp.vdf, wurde das CS#-Archiv nicht korrekt kopiert. Erscheint in der Konsole die MeldungCounterStrikeSharp requires Metamod with KHook, ist Ihr Metamod-Build zu alt; installieren Sie einen Dev Build 1467 oder neuer. - CS# wird unter Windows nicht geladen: Möglicherweise ist Visual C++ Redistributable (X64) nicht installiert; installieren Sie das Paket und starten Sie den Server neu.
- .NET findet unter Linux die ICU-Bibliothek nicht: Installieren Sie das Paket
libicuaus Schritt 4. Der Installationshinweis im CS#-Repository nennt als Alternative, in der Serverumgebung die VariableDOTNET_SYSTEM_GLOBALIZATION_INVARIANT=truezu setzen; dadurch wird die Lokalisierungsunterstützung von .NET abgeschaltet. - Bei der Erstinstallation wurde ein Paket ohne
with-runtimeverwendet: Fehlt der Ordnercounterstrikesharp/dotnet, fehlt auch die .NET-Laufzeitumgebung; in der Konsole erscheint der FehlerFailed to initialize .NET runtime, und CS# startet nicht. Kopieren Sie das Paketwith-runtime. - Admin-Rechte funktionieren nicht: CS# überspringt SteamIDs, die es nicht auflösen kann, sowie Berechtigungen, die nicht mit
@beginnen, ohne Warnung. Prüfen Sie den Wert vonidentity, die Namen der Berechtigungen sowie Kommas und Anführungszeichen im JSON; führen Sie nach dem Speichern der Dateicss_admins_reloadaus.
Häufig gestellte Fragen
Kann ich SourceMod-Plugins (.smx) in CS2 verwenden?
Nein. AlliedModders führt SourceMod für CS2 als nicht unterstützt; daher funktionieren aus CS:GO übrig gebliebene .smx-Plugins in CS2 nicht. Sie müssen für die gewünschte Funktion ein Gegenstück finden, das für CounterStrikeSharp geschrieben wurde.
Warum installiere ich einen Entwickler-Build von Metamod?
Die CS2-Unterstützung befindet sich im Zweig 2.0 von Metamod, und AlliedModders führt diesen Zweig für CS2 als „Current Development“. Auch die CS#-Dokumentation setzt einen 2.x-Entwickler-Build voraus, mindestens Build 1467.
Kann die Nutzung von Plugins zur Sperrung meines GSLT führen?
Laut CS#-Dokumentation können bestimmte Plugin-Funktionen, die gegen die CS2-Serverrichtlinien von Valve verstoßen, dazu führen, dass die GSLT-Schlüssel des Serverbetreibers gesperrt werden. Die Einstellung FollowCS2ServerGuidelines blockiert bekannte Funktionen, die Dokumentation stellt aber ausdrücklich klar, dass diese Einstellung eine Sperre nicht sicher verhindert. Einzelheiten zu den Schlüsseln finden Sie in der CS2-GSLT-Anleitung.
Welchen Server sollte ich für viele Plugins wählen?
Plugins laufen im selben Prozess wie der Gameserver; je mehr Arbeit die Plugins verrichten, desto höher ist auch die CPU-Last des Servers. Die von uns für Gameserver empfohlene Familie ist AMD Ryzen 9 9950X VDS mit hoher Single-Core-Leistung. Zum Messen der Last und zu Einstellungen lesen Sie die Anleitung zur CS2-Serverperformance.
Verwandte Anleitungen
- CS2-Server installieren: Anleitung für Windows und Linux mit SteamCMD
- Plugins auf einem CS2-Server installieren: CS# und Metamod
- CS2-VIP-System einrichten und Reserved Slots konfigurieren
- CS2-RCON aktivieren: Passwort, Befehle und Fernverwaltung
- CS2 GSLT: Was ist das, wie erhält man es und wie trägt man es auf dem Server ein?
Kommentare0
Noch keine Kommentare
Schreiben Sie den ersten Kommentar und teilen Sie Ihre Gedanken.
Bitte melden Sie sich an oder registrieren Sie sich, um einen Kommentar zu hinterlassen.