MatchZy

From CKRAS Wiki


MatchZy for CS2

MatchZy is a CS2 plugin for managing Practice, PUGs, Scrims, and Matches on CKRAS servers.
Quick Start: Type !help or .help in-game to view commands.

MatchZy is the only addon you need for your CS2 gameserver to run and manage Practice, PUGs, Scrims (with multiple Coaches), and Matches (supports Wingman). On CKRAS, MatchZy is fully integrated so you can start right away — including admin management via panel and streamlined in-game usage.

Jump to: CommandsInstallOptionsBecome AdminSupport

Why MatchZy & CKRAS BOT

With CKRAS BOT and MatchZy you can easily manage your CS2 gameserver, whether it is a scrim (with coaches) or training (!prac / !tactics). You can train and save nade lineups, use !throw, !spawns, !timer, !clear, !fastforward and many more commands. Admins can also be added or removed easily through the panel.

Note: Even without CKRAS BOT, MatchZy works via in-game commands (!help/.help, etc.). CKRAS BOT mainly improves the help/menu experience and panel integration.

Commands

Find all important commands for training, scrims and matches on your CS2 server.

Quick Guide: Use Custom Commands for scrims and normal match flow, Practice Mode Commands for training and nade work, and Admin Commands if you manage the server or match setup.

Note: Any command can be entered with .help or !help

Custom Commands

Use these during normal scrims / matches.

Command Description
!help Lists the most important available commands. (see: CKRAS BOT)
!ready Marks the player ready (Alias: !r)
!unready Marks the player unready (Alias: !ur, !notready)
!pause Pauses the match in freezetime (tactical or normal pause, depending on matchzy_use_pause_command_for_tactical_pause) (Alias: !p)
!tech Pauses the match in freezetime.
!unpause Requests match unpause. Both teams need to type .unpause to continue. (Alias: !up)
!stay Stay on the same side after the knife round.
!switch | !swap Switches the side after the knife round.
!stop Restores the backup of the current round. Both teams need to type !stop.
!tac Starts a tactical timeout.
!coach <ct|t> Starts coaching the specified side. Example: !coach t
!uncoach Removes coach status.

Multiple coaches: If you get the message team is full, join the other team first and then use !coach t or !coach ct so you are assigned correctly after the round.

Practice Mode Commands

These commands are only available in to start: .prac / !prac. Ends practice mode with .exit / !exit

Command Description
!spawn <number> Spawns to the provided competitive spawn number of the same team
!ctspawn <number> Spawns to the provided competitive spawn number of CT (Alias: !cts)
!tspawn <number> Spawns to the provided competitive spawn number of T (Alias: !ts)
!bestspawn Teleports you to your team’s closest spawn from your current position
!worstspawn Teleports you to your team’s furthest spawn from your current position
!bestctspawn Teleports you to CT team’s closest spawn from your current position
!worstctspawn Teleports you to CT team’s furthest spawn from your current position
!besttspawn Teleports you to T team’s closest spawn from your current position
!worsttspawn Teleports you to T team’s furthest spawn from your current position
!showspawns Shows competitive spawns in !prac mode (example picture)
>> New: you can select spawns with "E" << (Alias: !spawns)
!hidespawns Removes competitive spawns in prac mode
!solid Toggle solid teammates on/off
!impacts Toggle bullet impacts on/off
!traj Toggle grenade trajectories on/off (Alias: !pip)
!bot Adds a bot on the user’s current position
!nobots Removes all bots
!cbot Adds a crouched bot on the user’s current position (Alias: !crouchbot)
!boost Adds a bot on the current position and boosts the player on it
!crouchboost Adds a crouched bot and boosts the player on it
!ct / !t / !spec Changes the player to the requested team
!watchme / !fas Forces all players into spectator except the player who called this command
!fastforward Fast-forwards server time to 20 seconds (Alias: !ff)
!dryrun Turns on dry-run mode (Alias: !dry)
!god Turns on god mode
!break Breaks all breakable entities (glass windows, wooden doors, vents, etc.)
!noclip Activates / deactivates noclip mode
!nade Displays the nade menu if CKRAS BOT is enabled (Alias: !nades)
Nade Commands (!nade):
!throw Rethrows the exact same last grenade you threw (Alias: !rethrow)
!last Teleports the player to the last thrown grenade position
!autogo (soon)
!drop (soon)
!auton (soon)
!autoff (soon)
!savepos Saves your current position and viewangle
!loadpos Loads your last saved position and viewangle in prac mode
!timer Starts a timer and stops it when you use !timer again
!back Teleports you back to the last recorded grenade position
!back <number> Teleports you back to the selected grenade history position
!throwindex <index> Throws grenade(s) from your grenade history
!delay <delay_in_seconds> Sets a delay on your last grenade
!lastindex Prints the index number of your last thrown grenade
!rethrowsmoke / !rethrownade / !rethrowflash / !rethrowmolotov / !rethrowdecoy Grenade-specific rethrow commands
!clear Clears active smokes, molotovs and incendiaries
!noblind Toggles flashbang immunity (Alias: !noflash)
!savenade <name> Saves a lineup (Alias: !sn)
!loadnade <name> Loads a lineup (Alias: !ln)
!delnade <name> Deletes a lineup (Alias: !deletenade, !dn)
!importnade Prints an import code to chat after saving
!listnades Lists saved lineups (Alias: !lin)
!globalnades Stores nades globally on the server (Alias: !save_nades_as_global)

New: !ln / .ln supports smart name matching. Example: .ln mid can load a lineup called midflash.

Admin Commands

Admin required. If you are not admin yet, go to Become Admin.

Command Description
!restart Force restarts / resets a match (Alias: !rr)
!scrim or !start Force starts a match (Alias: !forcestart, !force)
!endmatch Force ends a match (Alias: !forceend)
!prac or !tactics Starts prac mode
!exit Exits practice mode and loads match mode (Alias: !exitprac)
!map <name> Switches to the desired map
!forcepause Pauses the match as admin (Alias: !fp)
!forceunpause Force unpauses the match (Alias: !fup)
!restore <round> Restore / backup a round
!rcon <command> Sends RCON commands
!skipveto Skips the current veto phase (Alias: !sv)
!roundknife Toggles knife round (Alias: !rk)
!playout Toggles playout (useful in scrim)
!tvrecord Starts a demo manually (see CSTV)
!tvstop Stops a demo (Alias: !stoprecord, !stoptv)
!whitelist Toggles whitelisting (cfg/MatchZy/whitelist.cfg)
!readyrequired <number> Sets required ready players
!settings Displays current settings
!asay <message> Say as admin in all chat
!reload_admins Reloads admins from admins.json
!reloadmap Reloads the current map (Alias: !rmap)
!team1 <name> Sets Team 1 name
!team2 <name> Sets Team 2 name

If you have any suggestions for additional features, please let us know: support@ckras.com

Install MatchZy

MatchZy requires Metamod. Install Metamod first in the webinterface, then activate CounterStrikeSharp and MatchZy.

Note: MatchZy is preinstalled on all our CS2 gameservers.

1
Install Metamod

Install Metamod

Install and activate Metamod in the webinterface first.

2
Activate CSS + MatchZy

Activate CounterStrikeSharp and MatchZy

After Metamod is active, CounterStrikeSharp (CSS) and MatchZy can be installed.

3
Update MatchZy

Update MatchZy

Updates are usually installed automatically. If not, click Update in the webpanel and restart the server.

Tip: To use all admin commands, assign admins in the panel afterwards. See Become Admin.

You need Support? Join Discord: Discord

MatchZy Options

You can customize settings in the webpanel (or manually by editing config.cfg).

MatchZy Options

Knife Round Every player is admin Smoke Color Playout Prac / Tactic mode Damage Output Auto Record

Color Smokes in Prac Mode

Example for Smoke Color in Prac Mode

Would you like to customise other features? Contact us in Discord or via support@ckras.com

Become Admin

You can become a MatchZy admin by adding yourself as an admin in CKRAS BOT: become admin

Note: The CKRAS Bot does not need to be activated for adding admins.

1
Open Admin Management

Open admin management

Open the admin section in the panel to manage MatchZy admins.

2
Add your SteamID64

Add SteamID64 in panel

Enter your SteamID64 in the webpanel and save the new admin entry.

3
Confirm Setup

Confirm admin setup

Check the created admin entry in the panel and confirm the setup.

Optional: The admin.json can also be edited manually via FTP:
/cs2/game/csgo/addons/counterstrikesharp/configs

Advanced Configuration

Advanced setup for MatchZy, including config files, whitelist, coach spawns and language settings.

CFG Files
/csgo/cfg/MatchZy

Edit the main MatchZy configuration files here:

  • warmup.cfg
  • knife.cfg
  • live.cfg
  • prac.cfg
Player Whitelist
/csgo/cfg/MatchZy/whitelist.cfg

Add one SteamID64 per line.

76561198154367261
Custom Coach Spawns
addons/counterstrikesharp/plugins/MatchZy/spawns/coach/<map_name>.json

Use this file to define custom coach spawn positions per map.

Language
/csgo/addons/counterstrikesharp/configs/core.json

Available languages: DE, EN, FR, PT, RU, UZ, HU, JP

Integrations and Recording

Optional integrations, stats and recording related features.

Database & Stats

Setup Database in the CKRAS panel to use MatchZy Stats.

Official MatchZy stats guide

Demos / CSTV

MatchZy records demos automatically. Make sure CSTV is activated.

CS2 Battle Discord Bot

GitHub Repository

Workshop

Workshop Guide

Support and Recovery

Everything related to restore, in-game help, binds and support contact.

Backup / Restore

Users can restore the current round with .stop or !stop.

Admins can restore backups with .restore or !restore.

Useful Bindings
bind <key> css_rcon "sv_rethrow_last_grenade"
bind <key> say .clear
Help & Support

CKRAS BOT improves the help output, but MatchZy also works without it via !help and .help.

Support: support@ckras.com
Join Discord

PreFire | Retakes | Deathmatch index.php?title=Category:CS2