Zum Inhalt springen
+90 850 303 07 52 [email protected]
Support Kundenbereich
Bei ausgewählten Hosting-Paketen mit Jahreslaufzeit und VDS-Paketen mit 3 Monaten Laufzeit: .com / .com.tr-Domain im ersten Jahr kostenlos · Pakete ansehen

Anleitungen

Schritt-für-Schritt-Anleitungen, um Ihren eigenen Server, Gameserver und Ihre Website einzurichten und zu betreiben – vom Team, das unsere Infrastruktur in Istanbul betreibt.

Counter-Strike 2

Metamod und CounterStrikeSharp auf CS2 installieren: Windows und Linux

26 August 2026 11 Min. Lesezeit Aktualisiert:
Diesen Beitrag teilen

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 Benutzer steam der 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 Format mmsource-2.0.0-git<build>-windows.zip und mmsource-2.0.0-git<build>-linux.tar.gz.
  • CounterStrikeSharp-Paket „with-runtime“: Es wird auf der Seite „Releases“ unter github.com/roflmuffin/CounterStrikeSharp/releases heruntergeladen. Bei der Erstinstallation müssen Sie das Paket wählen, dessen Name with-runtime enthä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 libicu erforderlich sein; zum Entpacken des CS#-Archivs brauchen Sie außerdem unzip. 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

  1. Laden Sie auf der Download-Seite die Datei mmsource-2.0.0-git<build>-windows.zip herunter.
  2. Klicken Sie mit der rechten Maustaste auf die Datei und entpacken Sie sie mit „Extract All“ (Alle extrahieren) in einen Ordner.
  3. Kopieren Sie den entpackten Ordner addons nach C:\cs2-ds\game\csgo\. Anschließend muss der Ordner C:\cs2-ds\game\csgo\addons\metamod existieren.

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:

PaketWann verwenden
counterstrikesharp-with-runtime-windows-<version>.zipErstinstallation unter Windows
counterstrikesharp-with-runtime-linux-<version>.zipErstinstallation unter Linux
counterstrikesharp-windows-<version>.zipUpdate unter Windows; nur wenn Sie die .NET-Laufzeitumgebung selbst aktuell halten
counterstrikesharp-linux-<version>.zipUpdate unter Linux; unter derselben Bedingung

Windows

  1. Stellen Sie sicher, dass Visual C++ Redistributable (X64) installiert ist.
  2. Laden Sie das Paket with-runtime-windows herunter und entpacken Sie es mit „Extract All“.
  3. Kopieren Sie den entpackten Ordner addons nach C:\cs2-ds\game\csgo\. Der Ordner wird mit dem vorhandenen addons zusammengeführt: Die Metamod-Dateien bleiben erhalten, daneben kommt der Ordner counterstrikesharp hinzu.

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üsselStandardFunktion
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
FollowCS2ServerGuidelinestrueBlockiert 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
PluginHotReloadEnabledtrueLädt ein Plugin automatisch neu, wenn sich seine .dll-Datei ändert
PluginAutoLoadEnabledtrueLä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
AutoUpdateEnabledtruePrü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:

  1. Starten Sie den Server und geben Sie meta version ein. Wird der Befehl nicht erkannt, öffnen Sie gameinfo.gi und 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.
  2. 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 version liefert Unknown command: Die Zeile wurde in die falsche Datei (csgo_core/gameinfo.gi) oder an der falschen Position eingetragen, es wurde GameBin geschrieben, oder der Ordner addons wurde 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 list zeigt CS# nicht an: Fehlt die Datei addons/metamod/counterstrikesharp.vdf, wurde das CS#-Archiv nicht korrekt kopiert. Erscheint in der Konsole die Meldung CounterStrikeSharp 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 libicu aus Schritt 4. Der Installationshinweis im CS#-Repository nennt als Alternative, in der Serverumgebung die Variable DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=true zu setzen; dadurch wird die Lokalisierungsunterstützung von .NET abgeschaltet.
  • Bei der Erstinstallation wurde ein Paket ohne with-runtime verwendet: Fehlt der Ordner counterstrikesharp/dotnet, fehlt auch die .NET-Laufzeitumgebung; in der Konsole erscheint der Fehler Failed to initialize .NET runtime, und CS# startet nicht. Kopieren Sie das Paket with-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 von identity, die Namen der Berechtigungen sowie Kommas und Anführungszeichen im JSON; führen Sie nach dem Speichern der Datei css_admins_reload aus.

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

Kommentare0

Noch keine Kommentare

Schreiben Sie den ersten Kommentar und teilen Sie Ihre Gedanken.

Diskutieren Sie mit

Bitte melden Sie sich an oder registrieren Sie sich, um einen Kommentar zu hinterlassen.

Keinen Beitrag verpassen

Erhalten Sie unsere neuesten Tutorials, Anleitungen und Produktneuigkeiten direkt in Ihr Postfach.

Sie haben unseren Newsletter abonniert.