Skip to content

MatchZy - Match Management ​

Matches, scrims and practice mode on your CS2 Pro server.

Pro Server Only

MatchZy is available on Pro servers only.

Overview ​

MatchZy runs PUGs, scrims, competitive matches and practice sessions. FSHOST runs a customized fork of MatchZy, maintained by Miksen. On top of the original it adds an auto-pause, a coach system, in-game admin menus, a remote log API and Get5 (G5API) compatibility.

This page covers what you need on a FSHOST server. The fork's full documentation, with every command and setting, is at matchzy.miksen.me.

Command Prefixes

The ., ! and / prefixes are interchangeable, so .ready, !ready and /ready are the same command. This page writes them with ., which is the convention most teams use for MatchZy. A few commands only exist with !, and are written that way below.

In the server console, type the command with css_ in front, for example css_ready.

MatchZy on FSHOST ​

MatchZy loads when the server starts, in match mode. Game mode commands from the Custom Commands plugin switch the server between MatchZy and the other modes:

CommandWhat it does
!matchzyLoads MatchZy in match mode. !matchzyon and !matchon do the same
!praccLoads MatchZy in practice mode
!matchoffUnloads MatchZy and goes back to competitive without it. !matchzyoff does the same

These need the g (map) admin flag. While MatchZy runs, !matchzy answers that it is already running; use .prac and .match inside MatchZy instead. See Installed vs. Loaded.

Who Can Use Which Command ​

LabelAdmin flagWho
PlayerNoneEveryone
Map/pracgCan switch modes, but not control a running match
ConfigiMatch admins
ChatjAdmin announcements
RootzEverything

The z flag passes every check. Admins and their flags are set on the Server admins page in the Pro Panel, see Become a Server Admin.

Quick Start: Run Your First 5v5 ​

These six steps are enough to play a match. Everything after them is optional.

Step 1: Load the Map ​

An admin picks the map before starting the match:

bash
!map de_dust2

Step 2: Start Match Mode ​

An admin types:

bash
.match

The server goes to warmup, with the ready check and the knife round turned on.

Step 3: Everyone Joins a Team ​

Players pick Terrorist or Counter-Terrorist as normal. MatchZy uses whichever teams people are on when the match starts.

Step 4: Everyone Readies Up ​

Each player types:

bash
.ready

Type .rc at any point to see who is still not ready. By default 10 players must be ready. When they are, the knife round starts on its own.

Step 5: Play the Knife Round ​

The winning team chooses a side:

bash
.stay      # Keep the current side
.switch    # Change sides

Step 6: Play ​

The match goes live straight after that choice. During the match:

CommandPurpose
.pausePause in the next freeze time
.unpauseYour team's vote to resume. Both teams must type it
.techTechnical pause
.tacTactical timeout

With CSTV turned on, MatchZy records a demo of the match into the demos folder. Download it from Demo files on the Files tab, see CSTV.

Practice Instead of a Match

Type .prac for practice mode with grenade tools, bots and spawn control. See Practice Mode Commands.

Switching Modes ​

These start a mode from warmup or from another mode. They are refused once a match has started.

CommandWhoWhat it does
.matchMap/pracMatch mode: warmup and ready check, then knife round, then the live match
.scrimMap/pracScrim mode: no knife round, and every round is played. .playout and .po do the same
.hillMap/pracLike a match without the knife round
.pracMap/pracPractice mode. .tactics and .training do the same
.exitpracMap/pracLeaves practice and goes back to match warmup. .noprac and .exittraining do the same
.dryrun [seconds]Map/pracPlays normal rounds with $16,000 and a 6 second freeze time, without a match. Add a number from 0 to 60 for another freeze time. .dry does the same
.exitdryMap/pracEnds the dry run and goes back to match warmup
.warmupConfigGoes back to warmup, not once a match has started
.sleepMap/pracIdle mode for an empty server

Match Commands ​

Warmup and Ready Check ​

CommandWhoWhat it does
.readyPlayerMarks you ready. .r and .rdy do the same. Pinging with the middle mouse button also toggles ready
.unreadyPlayerTakes back your ready. .ur, .notready and .nr do the same
.rcPlayerShows how many players are ready and who is missing. .readycheck and .rcheck do the same
.forcereadyPlayerReadies your whole team at once. Only in a match loaded from a match config
.startConfigStarts the match now, skipping the ready check. .force and .forcestart do the same
.readyrequired [n]ConfigSets how many ready players are needed, from 0 to 32. 0 means everyone connected. Without a number it shows the current value. .teamsize does the same
.knifeConfigTurns the knife round on or off for this match. .rk and .kr do the same
.team1 <name>ConfigNames the team on CT. .ctname does the same
.team2 <name>ConfigNames the team on T. .tname does the same
.whitelistConfigTurns the whitelist on or off. !wl does the same
.settingsConfigShows the current knife, match mode and scrim settings. .config and .configs do the same
.coach [t|ct]PlayerBecome your team's coach, see Coaching

Knife Round ​

CommandWhoWhat it does
.stayKnife winnersKeep your current side and go live
.switchKnife winnersSwap sides and go live. .swap does the same
.ct or .tKnife winnersPick a side by name

Live Match ​

CommandWhoWhat it does
.pausePlayerPauses the match in the next freeze time. .p does the same
.unpausePlayerYour team's vote to unpause. The game resumes when both teams have voted. .up does the same
.techPlayerTechnical pause. Each team gets 2 per map by default, and each lasts up to 300 seconds
.tacPlayerTactical timeout from your team's timeouts
.stopPlayerVote to replay the current round from its start. A player from each team must type it within 30 seconds
!ggPlayerSurrender vote. Your team must be 6 or more rounds behind, and all but one of its players must vote. Single-map matches only

A pause called by an admin can only be lifted by an admin.

Admin Match Control ​

CommandWhoWhat it does
.forcepauseConfigAdmin pause. .fp does the same
.forceunpauseConfigLifts any pause at once. .fup does the same
.restartConfigResets the match back to warmup. .abort does the same
.endmatchConfigStops the match and resets it. .stopmatch, .end, .forcestop, .endgame, .stopgame, .endscrim and .exitscrim do the same
.forceendConfigCancels the match
.surrenderConfigEnds a live match as a surrender. .matchgg does the same

Round Backups ​

MatchZy saves a backup at the start of every live round.

CommandWhoWhat it does
.backupsConfigLists the backups of this match, latest round first, with the restore command for each. .backup and .backupmenu do the same
.restore <round>ConfigRestores the match to the start of that round. Use the number .backups shows
.restorelastConfigRestores the previous round. .rl does the same
.restorecurrentConfigRestarts the current round from its start. .rrestore and .rr do the same
.recoverConfigBrings back a match that was interrupted by a crash or restart

Map Veto ​

Runs after a match config with a veto is loaded. Only each team's veto captain can use these.

CommandWhoWhat it does
.ban <map>CaptainRemoves a map from the pool
.pick <map>CaptainPicks a map to play
.ct or .tCaptainChooses the starting side on a map the other team picked
.skipvetoConfigSkips the veto and plays the maps in the listed order. .sv does the same

Other Commands ​

CommandWhoWhat it does
.helpPlayerLists the commands for the current phase
.mhelpAdminLists the admin commands you can run
.versionPlayerShows the MatchZy version
!color <0-4>PlayerPicks your teammate color: 0 blue, 1 green, 2 yellow, 3 orange, 4 purple
.asay <message>ChatSends an announcement to all chat with the admin prefix
.rmapRootReloads the current map

Auto-Pause ​

The fork pauses the match on its own when a team drops below 5 players, and resumes 3 seconds after both teams are full again. It only starts once the map has had at least twice that many players, so it does not trigger in smaller matches. It ignores bot teams.

CommandWhoWhat it does
.autopauseRootTurns auto-pause on or off
!autopause_minplayers <1-5>RootPlayers a team needs before auto-pause triggers
!autopause_delay <0-30>RootSeconds to wait before resuming once both teams are full again
!autopause_statusRootShows the auto-pause settings
!autopause_checkRootRuns the auto-pause check once now

Coaching ​

CommandWhoWhat it does
.coach [t|ct]PlayerBecome your own team's coach. Works in warmup and freeze time, not during a live round or in practice mode
.uncoachCoachGo back to playing. .play does the same

The coach stands at a viewing spot behind the team during freeze time, cannot be damaged, and spectates the round once freeze time ends. The coach belongs to the team, so after halftime they follow it to the other side.

Admins can set where coaches stand on each map:

CommandWhoWhat it does
.savecoachspawn [t|ct]ConfigSaves your position and view as this map's coach spot
.showcoachspawnsConfigShows the coach spot for both sides
.listcoachspawnsConfigLists the saved coach spots for this map
.clearcoachspawnsConfigRemoves the saved coach spots for this map

Practice Mode Commands ​

These work only in practice mode, started with .prac or !pracc. No admin rights are needed unless noted.

Spawns and Positions ​

CommandWhat it does
.ct, .t, .specSwitches your team
.spawn <n>Teleports you to your team's competitive spawn number n. .ctspawn <n> and .tspawn <n> pick the side
.bestspawnTeleports you to the spawn nearest to where you stand. .bestctspawn and .besttspawn pick the side
.worstspawnTeleports you to the spawn furthest from where you stand. .worstctspawn and .worsttspawn pick the side
.showspawnsDraws a numbered box at every competitive spawn. Aim at one and press E to teleport to it. .hidespawns hides them
.savepos [name]Saves your position and view. .loadpos [name] takes you back
.fasMoves every other player to spectator so they can watch you. .watchme does the same. Map/prac admins only

Bots ​

CommandWhat it does
.botSpawns a bot at your position, looking where you look. .ctbot and .tbot pick the team
.crouchbotSame, crouched. .cbot does the same
.boostSpawns a bot and puts you on its head. .crouchboost does the same with a crouched bot
.nobotRemoves the bot nearest to you
.nobotsRemoves all practice bots. .clearbots and .kickbots do the same

Grenades ​

CommandWhat it does
.lastTeleports you to where you threw your last grenade, with that grenade in hand
.back [n]Steps back through your grenade history. .back 3 jumps to entry 3
.rethrowThrows your last grenade again from the same spot. .rt and .throw do the same
.throwsmoke, .throwflash, .thrownade, .throwmolotov, .throwdecoyRethrows your last grenade of that type
.throwindex <n...>Throws one or more history entries by number, for example .throwindex 2 4 5
.lastindexShows the number of your last grenade in the history
.delay <seconds>Adds a delay to your last grenade when rethrown
.timerStopwatch: type once to start, again to stop

Saved Lineups ​

CommandWhat it does
.savenade <name> [throw] [comment]Saves your current lineup, with an optional throw style (normal, jump, run, walk or crouch) and comment. .sn does the same
.loadnade <name>Teleports you to a saved lineup with the grenade in hand. .ln does the same
.listnades [filter]Lists your lineups and the shared ones on this map. .lin does the same
.delnade <name>Deletes a lineup. .dn and .deletenade do the same
.shownadesShows a marker at every lineup on the map. Aim at one and press E to load it. .hidenades hides them
.globalnadesConfig admins: new lineups are saved for everyone instead of per player

Utility and Visuals ​

CommandWhat it does
.clearRemoves all smokes, fires and flying grenades. .cleanup does the same
.noflashFlashbangs do not blind you. .noblind does the same
.godYou take no damage. Type again to turn it off
.impactsTurns bullet impact markers off or on for you
.trajPicture-in-picture camera that follows your grenade. .pip, .cam and .nadecam do the same
.solidToggles whether teammates block each other
.ffSpeeds up time for 10 seconds, to wait out smokes and fires. .fastforward does the same
.breakBreaks all breakable glass, doors and props. .nobreak restores them
.rrRestarts the practice round for everyone. Map/prac admins only

The fork has many more practice tools, such as bot recordings, strategies and a lineup library. See the practice commands in the fork's documentation.

In-Game Menus ​

CommandWhoWhat it does
.matchadminConfigOpens the admin menu: force start, knife toggle, restart round, stop match, pause and unpause, switch modes. .ma does the same. Move with W and S, select with E
.matchsetupConfigOpens a wizard that builds a match (teams, series length, maps, veto) and loads it

Settings ​

MatchZy reads its settings from cfg/MatchZy/config.cfg each time it loads. You can also set any of them for the current session in the Console tab of the Pro Panel. To change the file itself you need FTP, see FTP Access.

Common settings, with the value in the default config.cfg:

SettingDefaultPurpose
matchzy_minimum_ready_required10Ready players needed to start. 0 means everyone connected
matchzy_knife_enabled_defaulttrueKnife round on by default
matchzy_playout_enabled_defaultfalsePlay out all rounds by default
matchzy_whitelist_enabled_defaultfalseWhitelist on by default
matchzy_warmup_enabledtrueUse warmup before a match
matchzy_enable_tech_pausetrueAllow .tech
matchzy_tech_pause_duration300Length of a tech pause in seconds
matchzy_max_tech_pauses_allowed2Tech pauses per team per map
matchzy_use_pause_command_for_tactical_pausefalseMake .pause a tactical timeout
matchzy_stop_command_availabletrueAllow .stop
matchzy_autopause_enabledtrueAuto-pause when a team is short
matchzy_autopause_minplayers5Players per team below which auto-pause triggers
matchzy_autopause_resume_delay3Seconds before resuming once teams are full again
matchzy_enable_damage_reporttrueDamage report after each round
matchzy_save_nades_as_global_enabledfalseSave lineups for everyone instead of per player
matchzy_match_end_auto_changelevel1Change map after a match ends. Turn off for G5API or tournament servers
matchzy_everyone_is_adminfalseGive every player MatchZy admin rights
matchzy_demo_pathdemos/Folder for demos, relative to csgo/

Every setting is listed in the fork's configuration reference.

Get5 / G5API ​

The fork accepts match configs and commands from Get5 panels such as G5API. Run these from the server console:

CommandWhat it does
matchzy_loadmatch <file>Loads a match config file, path relative to csgo/
matchzy_loadmatch_url <url> [header] [value]Loads a match config from a URL. Alias get5_loadmatch_url
matchzy_addplayer <steamid64> <team1|team2|spec> "<name>"Adds a player to the loaded match. Alias get5_addplayer
matchzy_removeplayer <steamid64>Removes a player from the loaded match. Alias get5_removeplayer
matchzy_loadbackup <file>Restores a round backup. Alias get5_loadbackup
get5_endmatch [team1|team2]Cancels the match, or ends the series with that team as winner
get5_statusStatus reply for Get5 panels

Match events can be sent to your own web service with matchzy_remote_log_url, and round backups with matchzy_remote_backup_url. See the fork's documentation for the event format.

Troubleshooting ​

Commands do nothing or say I have no permission

Check that you have the flag the command needs, see Who Can Use Which Command. Practice commands only work in practice mode, and match commands only in the matching phase. Type .help to see what works right now.

!matchzy says MatchZy is already running

MatchZy is loaded. Use .match or .prac to switch modes inside it.

MatchZy commands do nothing after playing deathmatch or retakes

MatchZy was unloaded when that mode started. Type !matchzy or !pracc to load it again.

Pause does not start straight away

.pause takes effect in the next freeze time, not in the middle of a round.

Auto-pause does not trigger

Auto-pause only starts once the map has had at least twice matchzy_autopause_minplayers players, so 10 by default. Check that it is on with !autopause_status.

No demo was recorded

MatchZy only records live maps (match, scrim and hill), not practice, and only with CSTV turned on. See CSTV.

Version Information ​

Current Version: 0.8.51 (FSHOST / Miksen fork)
Based on: MatchZy by shobhit-pathak
Framework: CounterStrikeSharp (.NET 10)

Check the running version in-game with .version, or in the console with css_matchzy_version.

Automatically updated

This version number is read from the latest published MatchZy release and is kept up to date automatically.

Still need help?

Search the site with Ctrl+K, or ask us. Pro customers get priority support through tickets.

FSHOST.me - Free and Premium Game Server Hosting