Wat bouwt waarop voort?

De volgorde is belangrijk: MetaMod:Source laadt native uitbreidingen, CounterStrikeSharp levert het C#-pluginframework en MatchZy draait als CounterStrikeSharp-plugin. Na een CS2-update moeten de frameworkversies passen bij de actuele server-build.

Deze opbouw verklaart ook waarom fouten bijna altijd van onder naar boven doorwerken: als MetaMod niet laadt, start CounterStrikeSharp helemaal niet, en MatchZy verschijnt dan in geen enkele pluginlijst. Wie in deze situatie eerst MatchZy opnieuw installeert, repareert de verkeerde laag. Werk je daarom altijd van de onderste laag naar boven toe.

Vereisten

Controleer drie dingen voordat je begint:

  • Servertoegang: Je hebt toegang nodig tot de pluginmanager in het panel of tot het bestandsbeheer. Voor de handmatige variant is SFTP-toegang tot de gameserverbestanden nodig.
  • Een actuele back-up: Plugininstallaties grijpen in op game/csgo/addons/. Een back-up vóór de eerste schrijfactie bespaart je bij fouten een volledige herinstallatie.
  • Een gestopte server: Schrijf nooit naar addons/ terwijl de server draait. Half weggeschreven bestanden veroorzaken laadfouten die moeilijk te onderscheiden zijn van echte versieconflicten.

Installatie in het panel

  1. Maak een back-up en stop de server.
  2. Open de pluginmanager en installeer eerst MetaMod:Source.
  3. Installeer daarna CounterStrikeSharp.
  4. Start de server één keer. In het log moeten MetaMod en CounterStrikeSharp zonder laadfouten verschijnen.
  5. Stop de server opnieuw, installeer MatchZy en start hem.
  6. Controleer met css_plugins list in de serverconsole of MatchZy geladen is.

Bij een handmatige installatie horen MetaMod en CounterStrikeSharp onder game/csgo/addons/; MatchZy staat onder game/csgo/addons/counterstrikesharp/plugins/MatchZy/. Gebruik waar mogelijk de pluginmanager, zodat paden en compatibele versies automatisch worden gekozen.

De tussenstart na stap 3 is geen optionele extra stap. Hij scheidt twee foutbronnen netjes van elkaar: als de server hier al vastloopt, ligt het aan het framework en niet aan MatchZy. Installeer je alles in één keer en start de server daarna niet meer, dan moet je achteraf raden welke van de drie componenten de oorzaak is.

Basiscommando's voor een match

Spelers gebruiken de chatcommando's:

.ready       gereed melden
.unready     gereedheid intrekken
.pause       match pauzeren
.unpause     match hervatten

Afhankelijk van de MatchZy-configuratie kunnen dezelfde commando's ook met ! beginnen. Admins laden een matchconfiguratie via het laadcommando dat MatchZy beschikbaar stelt; controleer vooraf de concrete bestandsnaam in je MatchZy-configuratie.

Nuttige servercommando's:

status
mp_warmup_end
mp_restartgame 1
changelevel de_mirage
bot_kick

Als je matches regelmatig en zonder consolewerk wilt starten, is het CS2 Match Center met MatchZy de comfortabelere manier: teams, map, formaat en GOTV kun je daar in het formulier instellen, in plaats van elke instelling per commando te typen.

Fouten afbakenen

De drie meest voorkomende symptomen hebben duidelijk te onderscheiden oorzaken:

  • css_plugins list kent het commando niet. Dan is CounterStrikeSharp niet geladen. Controleer in het startlog of MetaMod überhaupt is geïnitialiseerd — zonder MetaMod is er geen CounterStrikeSharp.
  • css_plugins list werkt, maar MatchZy ontbreekt in de uitvoer. Framework en pluginlaag zijn in orde, maar MatchZy staat in de verkeerde map of past niet bij de geïnstalleerde CounterStrikeSharp-versie.
  • De server start na de installatie niet meer. Meestal is dit een versieconflict na een CS2-update. Verwijder MatchZy bij wijze van test, start de server en werk je weer naar boven toe.

Lees het startlog daarbij altijd van boven naar beneden. Het eerste Failed-, Error- of Exception-blok noemt de getroffen laag; alles daarna zijn meestal vervolgfouten die vanzelf verdwijnen zodra de oorzaak is opgelost.

Na een CS2-update

Als plugins plotseling ontbreken, installeer dan niet de hele gameserver opnieuw. Controleer eerst of MetaMod en CounterStrikeSharp nog laden, update beide frameworks en daarna MatchZy. Het eerste Failed-, Error- of Exception-blok in het startlog toont normaal gesproken de getroffen laag.

Valve brengt CS2-updates uit zonder rekening te houden met frameworks van derden. Tussen een update en de passende MetaMod- respectievelijk CounterStrikeSharp-versie kunnen daarom uren tot dagen zitten. Voor league-matches met een vaste datum loont het om automatische updates gericht te beheren, zodat een server niet vlak voor de match overstapt naar een build waarvoor nog geen compatibele plugins bestaan.

FAQ

Moet ik SourceMod extra installeren? Voor MatchZy niet. MatchZy bouwt voort op CounterStrikeSharp. SourceMod is een zelfstandig, parallel plugin-ecosysteem en is voor deze stack niet nodig.

In welke volgorde moet ik updaten? Altijd van onder naar boven: eerst MetaMod:Source, dan CounterStrikeSharp, als laatste MatchZy. Andersom laadt de bovenste plugin tegen een framework dat nog niet bij de server-build past.

Waarom reageren de chatcommando's niet? Of MatchZy is niet geladen — dat toont css_plugins list — of je configuratie gebruikt een ander commandoprefix. Zowel .ready als !ready komen veel voor.

Kan ik plugins installeren terwijl de server draait? Nee. Stop de server vooraf. Schrijfacties naar addons/ bij een draaiend proces veroorzaken onvolledige bestanden en laadfouten die eruitzien als versieconflicten.

Waar vind ik de officiële documentatie? De installatiestappen en configuratieopties van MatchZy staan in de MatchZy-documentatie. Voor versievragen rond de Metamod-/SourceMod-familie is het overzicht van benodigde versies bij AlliedModders de referentie.

De server draait, maar de performance zakt tijdens de match in. Dat is in engere zin geen pluginprobleem. Controleer tickrate en serverbelasting los van de plugin-stack — daarvoor is er een aparte gids over tickrate en performance op CS2-servers.