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

Plugins auf einem CS2-Server installieren: CS# und Metamod

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

Mit Plugins können Sie Ihren Counter-Strike-2-Server (CS2) um Funktionen wie ein Admin-Menü, VIP, Statistiken oder neue Spielmodi erweitern. Diese Anleitung behandelt zwei Arten: Plugins für CounterStrikeSharp (CS#), die in C# geschrieben und als .dll verteilt werden, und native Plugins, die direkt von Metamod:Source geladen werden. Sie sehen Schritt für Schritt für Windows und Linux, wie Sie beide Arten in den richtigen Ordner legen, über die Konsole laden und entladen, Konfigurationsdateien bearbeiten und Plugins reparieren, die nach CS2-Updates nicht mehr funktionieren. Weitere Themen finden Sie auf der Seite Counter-Strike-2-Anleitungen.

Bevor Sie beginnen

  • Metamod:Source und CounterStrikeSharp müssen installiert sein: Diese Anleitung setzt voraus, dass beide Frameworks installiert sind und laufen; die Installation wird hier nicht wiederholt. Falls Sie sie noch nicht installiert haben, folgen Sie zuerst der Anleitung zur Installation von Metamod und CounterStrikeSharp. Wenn nach Eingabe von meta list in der Serverkonsole CounterStrikeSharp in der Liste erscheint, sind Sie bereit.
  • Ordner: Die Beispiele verwenden die Pfade aus der Anleitung zur Einrichtung eines CS2-Servers: unter Windows C:\cs2-ds, unter Linux den Ordner des Benutzers steam, /home/steam/cs2-ds. Wenn im Text kurz von game/csgo die Rede ist, ist der Ordner game/csgo unterhalb dieser Ordner gemeint.
  • Konsolenzugriff: Die Befehle geben Sie unter Windows im Serverfenster ein, unter Linux in der Sitzung, mit der Sie sich über tmux attach -t cs2 verbinden. Zur Fernverwaltung des Servers lesen Sie die Anleitung zu CS2-RCON.
  • Ihre CS#-Version: Geben Sie in der Konsole css ein; Sie sehen eine Zeile im Format Current API Version: v378 (...). Diese Zahl ist der letzte Teil des CS#-Versionstags (378 bei v1.0.378). Ist die niedrigste API-Version, die der Entwickler im Plugin-Code mit MinimumApiVersion angegeben hat, größer als diese Zahl, wird das Plugin nicht geladen.
  • Backup: Sichern Sie die Ordner addons/counterstrikesharp/plugins und addons/counterstrikesharp/configs. Bei VDS-Diensten ist kein automatisches Backup enthalten; für Backups sind Sie selbst verantwortlich.

Wenn Sie noch keinen Server haben, finden Sie die Pakete auf der Seite CS2-Server.

1. Plugin aus einer vertrauenswürdigen Quelle herunterladen

Sowohl CS#-Plugins (.NET-Bibliotheken) als auch Metamod-Plugins laufen im selben Prozess wie der Gameserver und mit den Rechten des Benutzers, der den Server ausführt. Das Plugin kann also auf jede Datei und auf das Netzwerk zugreifen, auf die dieser Benutzer Zugriff hat; eine einzige manipulierte .dll- oder .so-Datei genügt, um Ihren Server zu gefährden. Beachten Sie beim Herunterladen diese Regeln:

  • Laden Sie das Plugin im Bereich Releases des GitHub-Repositorys des Entwicklers herunter. Installieren Sie keine .dll-Dateien, die in Foren, auf Discord-Servern oder auf Filesharing-Seiten weiterverbreitet werden, und vor allem keine „gecrackten“ Kopien kostenpflichtiger Plugins.
  • Prüfen Sie, ob das Repository den Quellcode enthält, wie aktuell die letzte Version ist und welche offenen Fehlermeldungen (Issues) es gibt. Plugins, die lange nicht aktualisiert wurden, funktionieren in neuen CS2-Versionen möglicherweise nicht.
  • Führen Sie den Server unter Linux nicht als root aus, sondern wie in der Einrichtungsanleitung mit dem Benutzer steam; so bleibt der Schaden, den ein Plugin anrichten kann, auf die Dateien dieses Benutzers begrenzt.
  • Funktionen, die gegen die Serverregeln von Valve verstoßen, können zur Sperrung Ihrer GSLT-Schlüssel führen; Details finden Sie in der Anleitung zum CS2-GSLT.

Lesen Sie vor der Installation die README-Datei (Beschreibung) des Plugins und notieren Sie vier Angaben: die mindestens erforderliche CS#-Version, die Abhängigkeiten (Dependencies; andere Plugins oder Bibliotheken, die das Plugin zum Laufen benötigt), den Ordner, in den das Archiv entpackt werden soll, und den Ort der Konfigurationsdatei. Für Metamod-basierte Plugins gibt es getrennte Pakete für Windows und Linux; laden Sie das für Ihr Betriebssystem passende herunter.

2. Dateien in den richtigen Ordner legen

CS#-Plugins liegen im Ordner game/csgo/addons/counterstrikesharp/plugins. Jedes Plugin hat einen eigenen Ordner, und der Ordnername muss dem Namen der darin enthaltenen Haupt-.dll entsprechen; CS# sucht beim Start in jedem Ordner nach der .dll-Datei, die den Namen dieses Ordners trägt. Direkt im Ordner plugins abgelegte .dll-Dateien werden nicht geladen. Laut dem Beispiel in der CS#-Dokumentation und dem Quellcode wird folgende Struktur erwartet:

game/csgo/addons/counterstrikesharp
├── plugins
│   ├── disabled
│   └── BeispielPlugin
│       ├── BeispielPlugin.dll
│       ├── BeispielPlugin.deps.json
│       └── (weitere vom Plugin verwendete .dll-Dateien)
├── shared
│   └── BeispielApi
│       └── BeispielApi.dll
└── configs
    └── plugins
        └── BeispielPlugin
            └── BeispielPlugin.json

Die .dll-Dateien der NuGet-Pakete, die das Plugin verwendet, liegen im Plugin-Ordner neben der Hauptdatei. Gemeinsam genutzte API-Bibliotheken (Shared API), die für die Verwendung durch andere Plugins geschrieben wurden, kommen laut CS#-Dokumentation dagegen nach demselben Schema als shared/BeispielApi/BeispielApi.dll in den Ordner shared. Nennt die README zusätzlich ein Plugin, das installiert werden muss, fügen Sie auch dieses mit seinem eigenen Ordner unter plugins hinzu.

Entwickler packen ihre Archive mit unterschiedlichen Stammordnern. Wenn die README angibt, wohin Sie entpacken sollen, halten Sie sich daran; andernfalls entpacken Sie das Archiv in einen temporären Ordner und sehen sich den obersten Ordner an:

Ganz oben im ArchivKopieren nach
Ordner addonsgame/csgo
Ordner plugins (und gegebenenfalls configs, shared)game/csgo/addons/counterstrikesharp
Der eigene Ordner des Plugins (z. B. BeispielPlugin)game/csgo/addons/counterstrikesharp/plugins
Nur .dll- und .json-DateienEin neuer Ordner unter plugins mit demselben Namen wie die Haupt-.dll

Wenn Sie ein Plugin aktualisieren und das Archiv einen Ordner configs enthält, sichern Sie vor dem Kopieren Ihre vorhandene Konfigurationsdatei; andernfalls können Ihre bearbeiteten Einstellungen überschrieben werden.

Windows

  1. Verbinden Sie sich per RDP mit dem Server und laden Sie die .zip-Datei des Plugins von der Releases-Seite herunter.
  2. Klicken Sie mit der rechten Maustaste auf die Datei, entpacken Sie sie mit „Extract All“ in einen temporären Ordner und sehen Sie sich den obersten Ordner an.
  3. Kopieren Sie den Ordner an die in der Tabelle angegebene Stelle. Ist zum Beispiel der eigene Ordner des Plugins herausgekommen, fügen Sie ihn in C:\cs2-ds\game\csgo\addons\counterstrikesharp\plugins\ ein.

Linux

Führen Sie die Befehle als Benutzer steam aus. Die Download-Adresse erhalten Sie, indem Sie auf der Releases-Seite den Link der Datei kopieren; ersetzen Sie die großgeschriebenen Teile im Beispiel durch Ihre eigenen Werte:

sudo -iu steam
curl -sLO "https://github.com/ENTWICKLER/REPO/releases/download/VERSION/DATEI.zip"
mkdir -p ~/plugin/DATEI
unzip -o DATEI.zip -d ~/plugin/DATEI
find ~/plugin/DATEI -maxdepth 3

Sehen Sie sich die Ausgabe von find an und kopieren Sie an die in der Tabelle angegebene Stelle. Steht zum Beispiel ganz oben im Archiv addons:

cp -r ~/plugin/DATEI/addons ~/cs2-ds/game/csgo/

Linux unterscheidet zwischen Groß- und Kleinschreibung: beispielplugin/BeispielPlugin.dll wird nicht geladen; der Ordnername muss buchstabengenau dem Dateinamen entsprechen. Wenn Sie die Dateien als root kopiert oder per SFTP mit dem root-Konto hochgeladen haben, korrigieren Sie den Eigentümer:

sudo chown -R steam:steam /home/steam/cs2-ds/game/csgo/addons

3. Plugin laden und prüfen, ob es funktioniert

CS# lädt die Plugins unter plugins beim Start automatisch (solange in core.json die Option PluginAutoLoadEnabled aktiviert ist; das ist der Standard). Ein neues Plugin, das Sie bei laufendem Server hinzufügen, wird dagegen nicht automatisch geladen; starten Sie den Server neu oder geben Sie in der Konsole Folgendes ein:

css_plugins load BeispielPlugin
css_plugins list

Dem Befehl load können Sie den Ordnernamen oder einen Pfad wie plugins/BeispielPlugin/BeispielPlugin.dll übergeben. Kann das Plugin nicht geladen werden, erscheint in der Konsole die Meldung Could not load plugin. Die Ausgabe von list enthält für jedes Plugin eine Zeile:

  List of all plugins currently loaded by CounterStrikeSharp: 1 plugins loaded.
  [#1:LOADED]: "Beispiel Plugin" (1.0.0) by Entwickler

Die Zahl in den eckigen Klammern ist die Kennnummer (ID) des Plugins, das Wort nach dem Doppelpunkt sein Status. Der Name in Anführungszeichen ist der Plugin-Name, den der Entwickler im Code angegeben hat, und kann vom Ordnernamen abweichen. Verwenden Sie die Nummer, um das Plugin neu zu laden oder anzuhalten:

css_plugins reload 1
css_plugins unload 1

Auch wenn im reload-Beispiel des Hilfetexts #1 steht, vergleicht der aktuelle CS#-Quellcode den eingegebenen Wert mit der Plugin-Nummer, ohne das Zeichen # zu entfernen; geben Sie daher nur die Zahl ein. Statt der Nummer können Sie auch den Namen in Anführungszeichen angeben (z. B. css_plugins reload "Beispiel Plugin"); dabei wird zwischen Groß- und Kleinschreibung unterschieden.

Ist PluginHotReloadEnabled aktiviert (Standard), lädt CS# ein Plugin automatisch neu, sobald Sie seine .dll-Datei durch eine neue ersetzen; das nennt man Hot Reload. Ein mit unload angehaltenes Plugin wird dagegen beim nächsten Serverstart wieder aus seinem Ordner geladen. Um ein Plugin dauerhaft zu deaktivieren, ohne es zu löschen, verschieben Sie seinen Ordner in den Ordner plugins/disabled (er ist im CS#-Paket enthalten; falls nicht, legen Sie ihn an); CS# durchsucht diesen Ordner nicht.

4. Einstellungen des Plugins bearbeiten

Plugins, die das Konfigurationssystem von CS# nutzen, speichern ihre Einstellungen in der Datei addons/counterstrikesharp/configs/plugins/BeispielPlugin/BeispielPlugin.json; Ordner- und Dateiname entsprechen dem Ordnernamen des Plugins unter plugins. Laut CS#-Quellcode wird die Datei beim ersten Laden angelegt: Liegt im selben Ordner eine BeispielPlugin.example.json, wird diese kopiert; andernfalls wird eine neue Datei mit den Standardwerten des Plugins geschrieben. Gibt es eine gleichnamige Datei mit der Endung .toml, wird zuerst diese gelesen. Laden Sie das Plugin deshalb zuerst einmal und bearbeiten Sie danach die erzeugte Datei.

Öffnen Sie die Datei unter Windows mit Notepad, unter Linux mit nano. Der Inhalt hängt vom Plugin ab; die folgenden Schlüssel sind nur ein Beispiel:

{
  "ConfigVersion": 1,
  "ChatPrefix": "[MeinServer]",
  "EnableFeature": true
}
  • Der Schlüssel ConfigVersion ist in Plugins vorhanden, die das Konfigurationssystem von CS# verwenden. Laut CS#-Quellcode prüft der Kern diesen Wert nicht; er dient der eigenen Prüfung des Plugins. Ändern Sie ihn nicht, sofern die README nichts anderes sagt.
  • Halten Sie die JSON-Regeln ein: Schlüssel und Textwerte stehen in doppelten Anführungszeichen, und nach dem letzten Element folgt kein Komma. Eine mit // beginnende Kommentarzeile am Anfang der von CS# erzeugten Datei ist normal; CS# überspringt Kommentarzeilen.
  • Bearbeiten Sie die eigentliche Datei, nicht die Beispieldatei (.example.json). Achten Sie unter Windows darauf, dass Notepad die Datei nicht mit der Endung .json.txt speichert.

Laden Sie das Plugin nach dem Speichern mit css_plugins reload und der ID-Nummer neu; die Konfigurationsdatei wird beim Laden des Plugins gelesen. Manche Plugins bieten einen eigenen Befehl zum Neuladen, andere speichern ihre Einstellungen unter game/csgo/cfg in .cfg-Dateien; maßgeblich ist hier die README.

5. Metamod-basierte Plugins installieren

Manche Plugins wie CS2Fixes oder MovementUnlocker nutzen kein CS#; es sind C++-Plugins, die direkt von Metamod:Source geladen werden. Diese Plugins gehören nicht in den Ordner plugins von CS#. Die README-Dateien dieser beiden Projekte verlangen, dass Sie das für Ihr Betriebssystem passende Paket in den Ordner game/csgo entpacken.

Metamod liest im Ordner addons/metamod die .vdf-Dateien und lädt die darin angegebenen Plugins; auch CS# selbst wird auf diese Weise über die Datei counterstrikesharp.vdf geladen. Laut der VDF-Dokumentation von AlliedModders muss die Datei die Endung .vdf haben, der Inhalt muss im KeyValues-Format von Valve geschrieben sein und den Schlüssel file enthalten; alias (Aliasname) ist optional. Bringt das Paket keine .vdf-Datei mit, können Sie sie nach dem Schema, das das Source-2-Beispiel-Plugin von Metamod erzeugt, selbst anlegen (z. B. addons/metamod/beispielplugin.vdf):

"Metamod Plugin"
{
	"alias"	"beispielplugin"
	"file"	"addons/beispielplugin/bin/win64/beispielplugin"
}

Unter Linux schreiben Sie statt win64 linuxsteamrt64. Die Dateiendung müssen Sie nicht angeben; laut Metamod-Dokumentation wird sie automatisch ergänzt, und die Pfadtrennzeichen werden an das Betriebssystem angepasst. Starten Sie den Server neu und geben Sie meta list ein; das neue Plugin sollte neben CounterStrikeSharp aufgeführt sein.

Um es ohne Herunterfahren des Servers auszuprobieren, können Sie den Befehl meta load addons/beispielplugin/bin/win64/beispielplugin verwenden; laut Dokumentation erfordern manche Plugins danach einen Map-Wechsel. meta retry, gefolgt von der Nummer aus meta list, versucht ein Plugin, das zuvor nicht geladen werden konnte, erneut zu laden. Die vollständige Befehlsliste finden Sie auf der Befehlsseite im AlliedModders-Wiki.

6. Updates und Versionswechsel von CS2 handhaben

Plugins stützen sich auf die interne Struktur des Spiels (Signaturen, Offsets, Schemadefinitionen), und CS2-Updates können diese Struktur verändern. CS# passt sich mit neuen Versionen an diese Änderungen an; die Release Notes auf der Releases-Seite von CS# enthalten Spiel-Updates (Game Update) sowie Korrekturen an Signaturen (Signature) und Offsets. In core.json aktualisiert die Einstellung AutoUpdateEnabled nur die Spieldatendatei gamedata.json; CS# und die Plugins müssen Sie selbst aktualisieren.

Prüfen Sie nach jedem CS2-Update in dieser Reihenfolge:

  1. meta version: Wird der Befehl nicht erkannt, ist Metamod nicht geladen, und kein Plugin funktioniert. Häufigste Ursache ist, dass das Update die Datei gameinfo.gi erneuert und die Metamod-Zeile gelöscht hat; fügen Sie die Zeile wie in Schritt 2 der Installationsanleitung erneut ein.
  2. meta list: Stehen CounterStrikeSharp und Ihre Metamod-Plugins in der Liste? Prüfen Sie für ein fehlendes Metamod-Plugin, ob der Entwickler einen neuen Build veröffentlicht hat.
  3. css und die Releases-Seite: Gibt es eine neue CS#-Version, installieren Sie sie mit der Update-Methode aus der Installationsanleitung.
  4. css_plugins list: Bei Plugins, deren Status nicht LOADED ist oder die nicht in der Liste erscheinen, sehen Sie sich im Ordner addons/counterstrikesharp/logs die Logdatei an, deren Name mit log-cssharp beginnt, und prüfen Sie, ob es eine neue Version des Plugins gibt.

Wenn Sie ein Plugin aktualisieren, sichern Sie die Konfigurationsdatei, fahren den Server mit quit herunter, ersetzen die Dateien im Plugin-Ordner durch die der neuen Version und starten den Server. Verlangt die neue Version ein neueres CS#, wird das Plugin nicht geladen; in der Log-Meldung requires a newer version of CounterStrikeSharp stehen die vom Plugin erwartete und Ihre API-Version in eckigen Klammern.

Befehlsübersicht

BefehlEbeneFunktion
cssCS#Zeigt die CS#-API-Version an
css_plugins listCS#Listet die geladenen C#-Plugins mit ID, Status, Name und Version auf
css_plugins load BeispielPluginCS#Lädt ein nicht geladenes Plugin; entspricht start
css_plugins unload 1CS#Hält ein geladenes Plugin an; entspricht stop
css_plugins reload 1CS#Entlädt das Plugin, lädt es neu und liest die Konfigurationsdatei erneut ein; entspricht restart
meta versionMetamodZeigt, ob Metamod geladen ist, und seine Version
meta listMetamodListet die Metamod-Plugins auf
meta load <datei>MetamodLädt ein Metamod-Plugin
meta unload <ID>MetamodVersucht, ein Metamod-Plugin zu entladen; das Plugin kann dies ablehnen
meta retry <ID>MetamodVersucht ein zuvor nicht geladenes Plugin erneut zu laden

Häufige Fehler

  • Das Plugin fehlt in der Ausgabe von css_plugins list völlig: Die Haupt-.dll liegt nicht in ihrem eigenen Ordner, der Ordnername stimmt nicht mit dem Dateinamen überein (unter Linux einschließlich der Groß- und Kleinschreibung), oder der Ordner liegt unter plugins/disabled. Wenn Sie das Plugin bei laufendem Server hinzugefügt haben, laden Sie es mit css_plugins load.
  • requires a newer version of CounterStrikeSharp im Log: Das Plugin verlangt eine neuere CS#-API-Version als die installierte. Aktualisieren Sie CS# oder verwenden Sie eine ältere Version des Plugins, die mit Ihrer Version kompatibel ist.
  • Fehler wegen fehlender Bibliothek im Log: Findet .NET eine vom Plugin benötigte Bibliothek (Assembly) nicht, erscheint in der Regel die Meldung Could not load file or assembly. Stellen Sie sicher, dass Sie alle .dll-Dateien aus dem Archiv kopiert und die in der README genannten abhängigen Plugins sowie die shared-Bibliotheken installiert haben.
  • Eine geänderte Einstellung wirkt nicht: Bearbeitet wurde die Beispieldatei oder eine Kopie mit der Endung .json.txt, oder das Plugin wurde nicht neu geladen. Prüfen Sie den Dateinamen und führen Sie css_plugins reload aus.
  • Nach dem Bearbeiten der Konfigurationsdatei wird das Plugin gar nicht mehr geladen: Das JSON ist möglicherweise beschädigt (fehlendes Anführungszeichen, überzähliges Komma); CS# ersetzt eine fehlerhafte Konfigurationsdatei nicht durch die Standardwerte. Sehen Sie sich den JSON-Fehler im Log an und korrigieren Sie die Datei oder spielen Sie Ihr Backup zurück.
  • css_plugins reload #1 meldet Could not reload plugin: Geben Sie die Nummer ohne # ein oder verwenden Sie den Namen buchstabengenau wie in der Ausgabe von list.
  • Ein Metamod-Plugin fehlt in meta list oder scheint nicht zu funktionieren: Es wurde das Paket für das falsche Betriebssystem heruntergeladen, die .vdf-Datei liegt außerhalb von addons/metamod, der Pfad bei file ist falsch geschrieben, oder der Build des Plugins ist nicht mit der aktuellen CS2-Version kompatibel.
  • Zugriffsfehler unter Linux (Permission denied): Die Dateien gehören dem Benutzer root; führen Sie den Befehl chown aus Schritt 2 aus.

Häufig gestellte Fragen

Muss ich den Server neu starten, um ein Plugin zu installieren?

Nicht zwingend. Ein neues CS#-Plugin können Sie mit css_plugins load und ein aktualisiertes Plugin per Hot Reload oder mit css_plugins reload in Betrieb nehmen, ohne den Server herunterzufahren. Ein Neuladen kann die Daten zurücksetzen, die das Plugin gerade im Arbeitsspeicher hält; verlangt die README einen Neustart, halten Sie sich daran. Bei Metamod-Plugins ist ein Neustart des Servers der sicherste Weg.

Wie entferne ich ein Plugin vollständig?

Halten Sie es zuerst mit css_plugins unload und der ID-Nummer an, löschen Sie dann seinen Ordner unter plugins oder verschieben Sie ihn nach plugins/disabled. Die Konfigurationsdatei bleibt unter configs/plugins erhalten; wenn Sie das Plugin nicht mehr verwenden werden, können Sie auch sie entfernen. Bei einem Metamod-Plugin entfernen Sie in addons/metamod die .vdf-Datei und den Ordner des Plugins unter addons und starten den Server neu.

Was wird für Admin- und VIP-Plugins benötigt?

Bei CS#-Plugins werden Admin-Befehle meist über das Rechtesystem von CS# geprüft (z. B. @css/ban); Admins werden in der Datei configs/admins.json definiert. Diese Datei wird in Schritt 7 der Installationsanleitung beschrieben. Zu reservierten Slots und VIP-Einstellungen lesen Sie die Anleitung zum CS2-VIP-System.

Verlangsamen viele Plugins den Server?

Plugins laufen im selben Prozess wie der Gameserver; Plugins, die bei jedem Server-Update-Schritt (Tick) arbeiten oder sich häufig mit einer Datenbank verbinden, erhöhen die CPU-Last. Beobachten Sie beim Hinzufügen von Plugins die CPU-Auslastung in den Live-Nutzungsgrafiken im Kundenbereich und verschieben Sie nicht genutzte Plugins nach plugins/disabled. Die von uns für Gameserver empfohlene Familie ist AMD Ryzen 9 9950X VDS mit hoher Single-Core-Leistung; zu den Einstellungen lesen Sie die Anleitung zur Performance von CS2-Servern.

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.