MatchZy
MatchZy is a plugin for CS2 gameserver to run and manage Practice/Pugs/Scrims, with our fully integrated solution you can get started right away. Here we explain how easy it is to activate and use (!help) this addon on your CKRAS server.
Why MatchZy & CKRAS BOT
With CKRAS BOT and MatchZy you can easily manage (!help) your CS2 gameserver, no matter if it is a scrim or !prac, you can save nade lineups, !rethrow (!nade), use !spawns, !timer, !fastforward, !clear and many more commands.
MatchZy Commands
Find all currently available commands to easily manage your CS2 server.
Custom Commands
| Commands | Description |
|---|---|
| !help | Lists the most important available commands. (CKRAS BOT) |
| !ready | Marks the player ready |
| !unready | Marks the player unready |
| !pause | Pauses the match in freezetime (Tactical or normal pause, depends on matchzy_use_pause_command_for_tactical_pause |
| !tech | Pauses the match in freezetime. |
| !unpause | Request for unpausing the match. Both teams need to type .unpause to unpause the match |
| !stay | Stays on the same side (For knife winner, after the knife round) |
| !switch !swap | Switches the side (For knife winner, after the knife round) |
| !stop | Restore the backup of the current round (Both teams need to type !stop to restore the current round) |
| !tac | Starts a tactical timeout |
| !coach <side> | Starts coaching on the specified side <ct|t>
Example: !coach t, to start coaching as a terrorist |
| !uncoach | Removes Coach |
Practice Mode Commands
>> Assign admin <<
| Commands | Description |
|---|---|
| !spawn <number> | Spawns to the provided competitive spawn number of same team |
| !ctspawn <number> | Spawns to the provided competitive spawn number of CT |
| !tspawn <number> | Spawns to the provided competitive spawn number of T |
| !bot | Adds a bot on user's current position |
| !nobots | Removes all the bots |
| !crouchbot | Adds a crouched bot on user's current position |
| !boost | Adds a bot on current position and boosts player on it |
| !crouchboost | Adds a crouched bot on current position and boosts player on it |
| !ct / !t / !spec | Changes player team to the requested team |
| !watchme / !fas | Forces all players into spectator except the player who called this command. |
| !nade (NEW) | Displays an extra menu with all commands for nades only (alias: !nades) |
| Nade Commands: | |
| !rethrow | command will rethrow the exact same last smoke, flash, molly or HE you threw. |
| !last | command which teleports the player to the last thrown grenade position |
| !timer | command which starts a timer immediately and stops it when you type !timer again, telling you the duration of time |
| !back <number> | command which teleports you back to the provided position in your grenade history |
| !throwindex <index> <optional index> <optional index> | Command which throws grenade of provided position(s) from your grenade thrown history. Example: !throwindex 1 2 will throw your 1st and 2nd grenade. !throwindex 4 5 8 9 will throw your 4th, 5th, 8th and 9th grenade (If you've added delay in grenades, they'll be thrown with their specific delay).
|
| !delay <delay_in_seconds> | command which sets a delay on your last grenade.
This is only used when using !rethrow or !throwindex |
| !lastindex | command which prints index (position) number of your last thrown grenade. |
| !rethrowsmoke
!rethrownade !rethrowflash !rethrowmolotov !rethrowdecoy |
Added grenade-specific rethrow commands for every grenade type (!nade = Nade Menu) |
| !clear | Clears all the active smokes, molotoves and incendiaries |
| !noflash | Toggles immunity for flashbang (it will still blind others with noflash disabled) |
| !savenade <name> <optional description> | Saves a lineup |
| !loadnade <name> | Loads a lineup |
| .delnade <name> | Deletes a lineup from file (alias !deletenade) |
| .importnade <code> | Upon saving a lineup a code will be printed to chat, alternatively those can be retrieved from the savednades.cfg |
| .listnades <optional filter> | Lists either all saved lineups ever or if given a filter only those that match the filter |
| .globalnades | With .globalnades you can store your nades on the server for everyone to see. |
| more Practice Commands | |
| !fastforward | Fastforwards the server time to 20 seconds (Alias !ff) |
| !dryrun | Turns on dry-run mode |
| !god | Turns on god mode |
| !break | Breaks all the breakable entities (glass windows, wooden doors, vents, etc) |
Admin Commands
>> Assign admin <<
| Commands | Description |
|---|---|
| !help | Lists the most important available commands. |
| !restart | Force restarts/resets a match |
| !rcon <command> | RCON Commands - Example: "!rcon say test" -> RCON Commands |
| !start | Force starts a match. |
| !endmatch | Force ends a match. |
| !forcepause | Pauses the match as an admin (Players cannot unpause the admin-paused match).
(Alias !fp) |
| !forceunpause | Force unpauses the match. (Alias: !fup) |
| !prac | Starts the Prac Mode | Train (Practice cmds. above) |
| !exitprac | Exits from practice mode and loads Match mode. |
| !restore <round> | Restore a Round with (!restore 8 = 8 round) |
| !map <name> | Switches to the desired map e.g. "!map de_dust2" |
| !skipveto | Skips the current veto phase. (Alias: !sv) |
| !tvrecord | Demo starts automatically if you setup correct, see Note, to start manually the demo you can use the cmd !tvrecord (alias !startrecord !record)
NOTE: CSTV - Port (tv_enable 1 must be set in the server.cfg) |
| !tvstop | Stops a demo on your CSTV server (alias !stoprecord, !stoptv, !stop) |
| !roundknife | Toggles the knife round. If disabled, match will directly go from Warmup phase to Live phase.
(Alias: !rk) |
| !playout | Toggles playout (If playout is enabled, all rounds would be played irrespective of winner. Useful in !scrim) |
| !whitelist | Toggles whitelisting of players. To whitelist a player, add the steam64id insteam64id in cfg/MatchZy/whitelist.cfg (FTP) |
| !readyrequired <number> | Sets the number of ready players required to start the match. If set to 0, all connected players will have to ready-up to start the match. |
| !settings | Displays the current setting, like whether knife is enabled or not, value of readyrequired players, etc. |
| !asay <message> | Say as an admin in all chat |
| !reload_admins | Reloads admins from admins.json (via FTP editable) |
| !team1 <name> | Sets name for Team 1 (CT by default) |
| !team2 <name> | Sets name for Team 1 (CT by default) |
Note: Any command can be entered with .help or !help
If you have any suggestions for additional features, please let us know: support@ckras.com
Install MatchZy
MatchZy requires Metamod for installation, you can easily install MM in the webinterface, then you can click on Install MatchZy and restart the server once. Now you just have to assign admins for the beginning, see more in the next step.
MatchZy is not compatible with Coach-Addon or CS2 Scrim (COACH outdated 12.February 2024). We recommend to use only MatchZy in the future, because in addition to the pure !coach <ct|t> function, features such as !spawn, !noflash, !clear, !rethrow, !nade and many more are available with MatchZy, see the commands in detail above in this wiki.
You need Support? Join Discord:
ADD Admin (become Admin)
You can become a MatchZy admin by adding yourself as an admin at CKRAS BOT, see here how you can do this: become admin
Example Webpanel - here you can add your Steam ID3 or SteamID64
[Example: HOW TO ADD ADMINS IN THE PANEL]
The admin.json can also be edited manually, you will find it on your FTP in the folder: /cs2/game/csgo/addons/counterstrikesharp/configs
If you have already added admins to the CKRAS BOT, you can skip this step as we have automatically added you as an admin to the server.
>> Note: MatchZy offers a variety of different admin options (root, map, prac, chat...), you can see them for yourself in their WIKI. << We recommand to use our CKRAS BOT ADD ADMIN because its fully integrated.
Disable Admin Function
The admin query (requirement) can also be switched off in config.cfg (folder: /cs2/game/csgo/cfg/MatchZy).
To do this, insert and change this value.
matchzy_everyone_is_admin <true or false>
- true everyone is admin
- false only admins added in the admin.json or added via ADD ADMIN can execute cmds
TIPP: To use bindings for cmds you can use the following example.
bind <key> css_rcon sv_rethrow_last_grenade
Configuring Warmup/Knife/Live/Prac CFGs
If you want to integrate your own configs into MatchZy or edit the existing files, we will show you below what you need to do.
Advanced:
You can edit the Configs from the Plugin, inside csgo/cfg/MatchZy (FTP), files named warmup.cfg, knife.cfg, live.cfg and prac.cfg
These configs are executed when Warmup, Knife, Live and Practice Mode (!prac) is started respectively.
You can modify these files according to your requirements.
If these configs are not found in the expected location, MatchZy/CKRAS BOT executes the default configs which are present in the code.
Whitelisting players
You can add Players to a whitliste, please login to your ftp in navigate to the folder csgo/cfg/MatchZy (FTP), there will be a file called whitelist.cfg. You can add Steam64 id of whitelisted players like mentioned in the below example:
76561198154367261
MatchZy with CKRAS BOT
We have adapted our CKRAS BOT for this plugin (!help)
Now you can easily add admins in the panel as described above and the most common commands are displayed (!help) via our CKRAS BOT.
(Screenshot CKRAS BOT !help output in Chat, by Default available)
TIPP: Demos are recorded automatically (tv_enable 1 needed in server.cfg) but you can start demos via Chat CMDs aswell
If you do not want to activate the CKRAS BOT and do not need the additional HELP menu, you can also deactivate the CKRAS BOT in the webpanel at any time, so the full range of MatchZy functions will still be available to you.
Additional Information:
For CSTV demo we added the Commands !tvrecord (alias: !record) !tvstop to start/stop a CS2 Demo (see commands above) (please get sure that tv_enable 1 is set in your server.cfg), the demo is stored in the default ftp-folder: /cs2/game/csgo.
We install CounterStrikeSharp automatically when you install MatchZy, and we also install the latest versions of CSS automatically at regular intervals.
You need Support? Join Discord:
