CS2 server setup
Configure CS2 servers manually (MatchZy Enhanced + RCON + webhooks).
Manual installation guide for setting up CS2 servers with the enhanced MatchZy plugin.
Recommended: Use CS2 Server Manager for automated setup. It installs everything you need with one command.
Prerequisites
Install CounterStrikeSharp
Follow the official CounterStrikeSharp getting started guide: Getting Started
After completing the guide:
- Verify Metamod is installed (server console):
meta listIf CounterStrikeSharp is installed correctly, you can also verify it with:
css_plugins listInstall MatchZy Enhanced
Important: This project requires an enhanced fork of MatchZy that emits additional events used for automation.
Download
- Latest release: MatchZy-Enhanced releases
- Docs: MatchZy Enhanced docs
Install
cd /path/to/cs2/game/csgo
unzip MatchZy-*.zipRestart your CS2 server.
Verify
Type css_plugins list in server console. You should see MatchZy listed.
Configure RCON
Add these to your server's autoexec.cfg or server.cfg:
rcon_password "your-secure-rcon-password"
hostport 27015Connect the server to MAT
Once the server can be reached by RCON, add it in MAT under Servers.
MAT configures MatchZy Enhanced automatically over RCON (webhook URL, demo upload URL, auth headers, etc.) when:
- The server is initialized, and
- Matches are loaded on that server
Make sure MAT has:
- A configured Webhook URL in Settings
SERVER_TOKENset in MAT’s.env(used as theX-MatchZy-Tokenheader for demo uploads and server-to-MAT requests)
Configure webhook reachability
Your CS2 server must be able to reach the MAT API.
curl http://your-tournament-ip:3069/api/events/testShould return something like:
{ "success": true, "message": "events route is working" }Network configuration notes
- Docker setup typically exposes MAT on port 3069
- Local dev uses port 3000 for the API
How is this guide?
Last updated on