Was baut worauf auf?

Die Reihenfolge ist wichtig: MetaMod:Source lädt native Erweiterungen, CounterStrikeSharp stellt das C#-Plugin-Framework bereit und MatchZy läuft als CounterStrikeSharp-Plugin. Nach einem CS2-Update müssen die Framework-Versionen zum aktuellen Server-Build passen.

Dieser Aufbau erklärt auch, warum Fehler fast immer von unten nach oben durchschlagen: Lädt MetaMod nicht, startet CounterStrikeSharp gar nicht erst, und MatchZy taucht dann in keiner Plugin-Liste auf. Wer in dieser Situation zuerst MatchZy neu installiert, repariert die falsche Schicht. Arbeite dich deshalb immer von der untersten Ebene nach oben vor.

Voraussetzungen

Bevor du startest, prüfe drei Dinge:

  • Server-Zugriff: Du brauchst Zugriff auf den Plugin-Manager im Panel oder auf die Dateiverwaltung. Für die manuelle Variante ist ein SFTP-Zugang zu den Gameserver-Dateien nötig.
  • Ein aktuelles Backup: Plugin-Installationen greifen in game/csgo/addons/ ein. Ein Backup vor dem ersten Schreibzugriff spart im Fehlerfall die komplette Neuinstallation.
  • Ein gestoppter Server: Schreibe nie in addons/, während der Server läuft. Halb geschriebene Dateien führen zu Ladefehlern, die schwer von echten Versionskonflikten zu unterscheiden sind.

Installation im Panel

  1. Erstelle ein Backup und stoppe den Server.
  2. Öffne den Plugin-Manager und installiere zuerst MetaMod:Source.
  3. Installiere danach CounterStrikeSharp.
  4. Starte den Server einmal. Im Log müssen MetaMod und CounterStrikeSharp ohne Ladefehler erscheinen.
  5. Stoppe den Server erneut, installiere MatchZy und starte ihn.
  6. Prüfe mit css_plugins list in der Serverkonsole, ob MatchZy geladen ist.

Bei manueller Installation gehören MetaMod und CounterStrikeSharp unter game/csgo/addons/; MatchZy liegt unter game/csgo/addons/counterstrikesharp/plugins/MatchZy/. Nutze den Plugin-Manager, wenn möglich, damit Pfade und kompatible Versionen automatisch gewählt werden.

Der Zwischenstart nach Schritt 3 ist kein optionaler Zusatzschritt. Er trennt zwei Fehlerquellen sauber voneinander: Wenn der Server hier bereits klemmt, liegt es am Framework und nicht an MatchZy. Installierst du alles in einem Rutsch und der Server startet nicht mehr, musst du hinterher raten, welche der drei Komponenten schuld ist.

Basisbefehle für ein Match

Spieler verwenden die Chat-Befehle:

.ready       bereit melden
.unready     Bereitschaft zurücknehmen
.pause       Match pausieren
.unpause     Match fortsetzen

Je nach MatchZy-Konfiguration können dieselben Befehle auch mit ! beginnen. Admins laden eine Match-Konfiguration über den von MatchZy bereitgestellten Ladebefehl; prüfe den konkreten Dateinamen vorher in deiner MatchZy-Konfiguration.

Nützliche Serverbefehle:

status
mp_warmup_end
mp_restartgame 1
changelevel de_mirage
bot_kick

Wenn du Matches regelmäßig und ohne Konsolenarbeit starten willst, ist das CS2 Match Center mit MatchZy der bequemere Weg: Teams, Map, Format und GOTV lassen sich dort im Formular setzen, statt jede Einstellung per Befehl zu tippen.

Fehler eingrenzen

Die drei häufigsten Symptome haben klar unterscheidbare Ursachen:

  • css_plugins list kennt den Befehl nicht. Dann ist CounterStrikeSharp nicht geladen. Prüfe im Startlog, ob MetaMod überhaupt initialisiert wurde — ohne MetaMod gibt es kein CounterStrikeSharp.
  • css_plugins list läuft, MatchZy fehlt aber in der Ausgabe. Framework und Plugin-Ebene sind in Ordnung, MatchZy liegt jedoch im falschen Verzeichnis oder passt nicht zur installierten CounterStrikeSharp-Version.
  • Der Server startet nach der Installation nicht mehr. Meist ein Versionskonflikt nach einem CS2-Update. Entferne testweise MatchZy, starte den Server und arbeite dich wieder nach oben.

Lies das Startlog dabei immer von oben nach unten. Der erste Failed-, Error- oder Exception-Block nennt die betroffene Schicht; alles danach sind meist Folgefehler, die von selbst verschwinden, sobald die Ursache behoben ist.

Nach einem CS2-Update

Wenn Plugins plötzlich fehlen, installiere nicht den ganzen Gameserver neu. Prüfe zuerst, ob MetaMod und CounterStrikeSharp noch laden, aktualisiere beide Frameworks und danach MatchZy. Der erste Failed, Error oder Exception-Block im Startlog zeigt normalerweise die betroffene Schicht.

Valve veröffentlicht CS2-Updates ohne Rücksicht auf Drittanbieter-Frameworks. Zwischen einem Update und der passenden MetaMod- beziehungsweise CounterStrikeSharp-Version können deshalb Stunden bis Tage liegen. Für Ligaspiele mit festem Termin lohnt es sich, automatische Updates gezielt zu steuern, damit ein Server nicht unmittelbar vor dem Match auf einen Build wechselt, für den es noch keine kompatiblen Plugins gibt.

FAQ

Muss ich SourceMod zusätzlich installieren? Für MatchZy nicht. MatchZy setzt auf CounterStrikeSharp auf. SourceMod ist ein eigenständiges, paralleles Plugin-Ökosystem und wird für diesen Stack nicht benötigt.

In welcher Reihenfolge muss ich aktualisieren? Immer von unten nach oben: erst MetaMod:Source, dann CounterStrikeSharp, zuletzt MatchZy. Andersherum lädt das obere Plugin gegen ein Framework, das noch nicht zum Server-Build passt.

Warum reagieren die Chat-Befehle nicht? Entweder ist MatchZy nicht geladen — das zeigt css_plugins list — oder deine Konfiguration nutzt ein anderes Befehlspräfix. Verbreitet sind sowohl .ready als auch !ready.

Kann ich Plugins im laufenden Betrieb installieren? Nein. Stoppe den Server vorher. Schreibzugriffe auf addons/ bei laufendem Prozess erzeugen unvollständige Dateien und Ladefehler, die wie Versionskonflikte aussehen.

Wo finde ich die offizielle Dokumentation? Die Installationsschritte und Konfigurationsoptionen von MatchZy stehen in der MatchZy-Dokumentation. Für Versionsfragen rund um die Metamod-/SourceMod-Familie ist die Übersicht der benötigten Versionen bei AlliedModders die Referenz.

Der Server läuft, aber die Performance bricht im Match ein. Das ist kein Plugin-Problem im engeren Sinne. Prüfe Tickrate und Serverauslastung getrennt vom Plugin-Stack — dazu gibt es einen eigenen Leitfaden zu Tickrate und Performance auf CS2-Servern.