MatchZy for CS2: Install the Match and Practice Plugin on Your Server
MatchZy is a plugin that turns a regular CS2 server into something you can run scrims, pugs and matches on. It adds a ready-up flow, pauses, knife rounds, automatic demo recording, match stats and a practice mode. Many teams use it because it's free and open source, and it can read Get5-style match files.
Everything here comes from MatchZy's own README and documentation, checked on November 21, 2026. It's third-party software that you choose and maintain, like the rest of the CounterStrikeSharp ecosystem. We can help with the server, but we can't troubleshoot a plugin's behavior. If you haven't installed the base layers, read the Metamod and CounterStrikeSharp guide first.
- MatchZy needs CounterStrikeSharp v369 or newer with the .NET 10 runtime, on top of Metamod.
- Extract the release into
game/csgo/, restart, then runcss_plugins list. - It creates
cfg/MatchZyfiles likeadmins.jsonanddatabase.jsonon first need.
On this page
What MatchZy gives you
- Best-of-1, best-of-3 and best-of-5 matches with a veto, when you load a match config.
- Automatic demo recording that starts and stops with the match. The README says this needs
tv_enable 1. - Match stats saved to a local SQLite database (MySQL is also supported), plus a CSV with per-player stats for each match.
- Round restore, which uses Valve's own backup system.
- A knife round to decide sides, with a defined tiebreak: more players wins, then more HP, then random.
- A practice mode with bots, spawns and grenade lineups. See the practice commands guide.
What it needs
MatchZy loads through CounterStrikeSharp, which loads through Metamod. The documentation says it needs CounterStrikeSharp v369 or newer with the .NET 10 runtime, and that it won't load on older versions. Use CounterStrikeSharp's with-runtime download, since that's the one that bundles the runtime. If you use a MatchZy release that bundles CounterStrikeSharp, you can skip that separate install.
The docs don't give a Metamod version number, and they cover the Windows build of CounterStrikeSharp. They also don't say which CS2 versions MatchZy supports, so after any Valve update, check the project's release page before blaming the server.
Install steps
- Back up
Take a Backups entry first. Plugin installs add files and change how the game loads.
- Install Metamod and CounterStrikeSharp
On ChicagoServers the Updates tab does both with one click each, Metamod first. Restart afterward.
- Check both loaded
On the Console tab run
meta list. It should show CounterStrikeSharp by Roflmuffin.meta list - Get MatchZy
Download the latest release from MatchZy's GitHub page.
- Upload it
Open the Files tab and go to
game/csgo/. Upload the zip, right-click it and choose Extract here. MatchZy's docs say to extract to thecsgo/directory, and the release contains its ownaddonsandcfgfolders, so they'll merge with what's there. - Restart and check
Restart, then run
css_plugins liston the Console tab. MatchZy by WD- should appear.css_plugins list
What it adds to your server
addons/counterstrikesharp/gamedata/matchzy.jsoncomes in the release. Practice mode uses it to rethrow smokes, HE grenades, molotovs and decoys. The docs say a new version of this file can fix rethrows after a CS2 update without a new plugin build, so keep it updated with MatchZy.- A
cfg/MatchZyfolder. MatchZy createsadmins.json,database.json,savednades.jsonandwhitelist.cfgthere when it needs them. They aren't in the release itself. - When you update MatchZy, extracting the new files keeps those created files. The
.cfgfiles incfg/MatchZyare replaced by updates, so back up any you've edited.
Next steps: set up admins, the database and demos, and write a match config.
If it doesn't show up
meta listdoesn't show CounterStrikeSharp: fix that layer first. The base plugin guide has the order and the checks.css_plugins listdoesn't show MatchZy: make sure CounterStrikeSharp is v369 or newer, and that the files landed undergame/csgo/addons/counterstrikesharp/plugins/and not one folder deeper.- It worked until a Valve update: check for new CounterStrikeSharp, Metamod and MatchZy releases. Game updates can break plugins until their authors catch up.
Frequently asked questions
What does MatchZy need to run?
CounterStrikeSharp v369 or newer with the .NET 10 runtime, which in turn needs Metamod. The docs say it won't load on older CounterStrikeSharp versions.
How do I check MatchZy is installed?
Run <code>css_plugins list</code> on the console. MatchZy by WD- should appear in the list.
Where do I put the MatchZy files?
Extract the release into the server's csgo directory. On ChicagoServers that's <code>game/csgo/</code> on the Files tab.
Does updating MatchZy erase my settings?
The files MatchZy creates, like admins.json and database.json, are kept when you extract an update. The .cfg files in cfg/MatchZy are replaced, so back up any you edited.
Does MatchZy record demos?
Yes. The README says recording starts and stops with the match and needs <code>tv_enable 1</code>.