MatchZy
MatchZy is a the only addon you need for CS2 gameserver to run and manage Practice, Pugs, Scrims (with multiple Coaches), Matches (Supports Wingman), with our fully integrated gaming solution you can get started right away. Here we explain how easy it is to activate and use (!help) this CS2 addon on your CKRAS server. >> Deutsch 
Why MatchZy & CKRAS BOT
With CKRAS BOT and MatchZy you can easily manage your CS2 gameserver, no matter if it is a scrim (with coaches) or training (!prac | !tactics), you can train/save your nade lineups for nade practice on your gameserver, add/remove admins easy with our panel. Train with nades !throw (!nades), use !spawns, !timer, !clear, !fastforward and many more commands.
MatchZy Commands
Find all currently available commands to easily manage your CS2 server for training, scrim or matches.
|
Note: Any command can be entered with .help or !help |
Custom Commands
| Commands | 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, depends on matchzy_use_pause_ command_for_tactical_pause) (Alias: !p) |
| !tech | Pauses the match in freezetime. |
| !unpause | Request for unpausing the match. Both teams need to type .unpause to unpause the match (Alias: !up) |
| !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 <ct|t> | Starts coaching on the specified side ct|t>
Example: !coach t, to start coaching as a terrorist (NEW: Multiple Coaches on each side are now available, if you get the msg team is full you can can also join the other team and type |
| !uncoach | Removes Coach Status |
Practice Mode Commands
| 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 (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 | NEW: Shows competitive spawns in "!prac" mode (example picture) |
| !hidespawns | NEW: Remove competitive spawns in prac mode |
| !solid | Toogle (on|off) solid teammates |
| !impacts | Toogle (on|off) bullet impacts |
| !traj | Toggle (on|off) grenade trajectories (Alias: !pip) |
| !bot | Adds a bot on user's current position |
| !nobots | Removes all the bots |
| !cbot | Adds a crouched bot on user's current position (Alias: !crouchbot) |
| !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. |
| !fastforward | Fastforwards the server time to 20 seconds (Alias: !ff) |
| !dryrun | Turns on dry-run mode (Alias: !dry) |
| !god | Turns on god mode |
| !break | Breaks all the breakable entities (glass windows, wooden doors, vents, etc) |
| !nade | Displays an extra menu only with nades cmds CKRAS BOT turn "on" (Alias: !nades) |
| Nade Commands (!nade): | |
| !throw | command will rethrow the exact same last smoke, flash, molly or HE you threw.
(Alias: !rethrow) |
| !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 !throw 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 |
| !noblind | Toggles immunity for flashbang (it will still blind others with noflash disabled) (Alias: !noflash) |
| !savenade <name> <optional description> | Saves a lineup (Alias: !sn) |
| !loadnade <name> | Loads a lineup (Alias: !ln) |
| !delnade <name> | Deletes a lineup from file (Alias: !deletenade, !dn) |
| !importnade <code> | Upon saving a lineup a code will be printed to chat, alternatively those can be retrieved from the savednades.cfg (Alias: !in) |
| !listnades <optional filter> | Lists either all saved lineups ever or if given a filter only those that match the filter (Alias: !lin) |
| !globalnades | With .globalnades you can store your nades on the server for everyone to see. If you do not use .globalnades, the nades will only be visible to you.
(Alias: !save_nades_as_global) |
|
|
Note: Any command can be entered with .help or !help |
Admin Commands
>> Assign admin <<
| Commands | Description |
|---|---|
| !restart | Force restarts/resets a match (Alias: !rr) |
| !force or !start | Force starts a match. (Alias: !forcestart) |
| !endmatch | Force ends a match. (Alias: !forceend) |
| !prac or !tactics | Starts the Prac Mode | Train (Practice cmds. above) |
| !exitprac | Exits from practice mode and loads Match mode. |
| !map <name> | Switches to the desired map e.g. "!map dust2 or !map de_dust2" |
| !forcepause | Pauses the match as an admin (Players cannot unpause the admin-paused match).
(Alias: !fp) |
| !forceunpause | Force unpauses the match. (Alias: !fup) |
| !restore <round> | Restore / Backup a Round with (!restore 8 = 8 round) |
| !rcon <command> | RCON Commands - Example: "!rcon say test" -> RCON Commands |
| !skipveto | Skips the current veto phase. (Alias: !sv) |
| !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) |
| !tvrecord | MatchZy starts Demos automatically
But if you want to start record manually use this cmds !tvrecord IMPORTANT: CSTV - Port (tv_enable 1 set in server.cfg or activate CSTV in Panel.) |
| !tvstop | Stops a demo on your CSTV server (Alias: !stoprecord, !stoptv) |
| !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 or CKRAS BOT) |
| !reloadmap | Reloads the current Map |
| !team1 <name> | Sets name for Team 1 (CT by default) example: !team1 CKRAS |
| !team2 <name> | Sets name for Team 1 (CT by default) |
|
|
Note: Any command can be entered with .help or !help |
NEW: Loading Nades !ln | .ln:Added smart quering for nadenames, where the closest name is being selected for loading names (.ln mid can be used to load a nade with name midflash)
If you have any suggestions for additional features, please let us know: support@ckras.com
Install MatchZy
MatchZy requires Metamod, you can simply install MM in the webinterface (see picture). After you have installed and activated MM, you can install CounterStrikeSharp and MatchZy.
Note: MatchZy is already pre-installed on all our game servers by default.
Activate CSS + MatchZy
The following image shows that after activating Metamod, CounterStrikeSharp (CSS) and MatchZy can now be installed. Please click here once on “Install” and the respective plugin will be activated and installed.
Note: To use all commands, you now only need to assign admins in the panel (alternatively, see MatchZy options “Every player is admin”). More on this under “Become a MatchZy admin”.
Update MatchZy
As a rule, MatchZy updates are installed automatically, as the changes usually have a major impact on gameplay and new features. However, if it is not installed automatically, simply click on "Update" in the webpanel and then restart the server.
To update MatchZy, please click on Update (Version) and the latest update will be installed. See also the screenshot.
You need Support? Join Discord:
MatchZy Options
You can customize certain settings for your gameserver directly from the webpanel to your liking (or manually by editing config.cfg), see screenshot of your options in the webpanel.
MatchZy Options in the CKRAS Webinterface:
- Knife Round: This can be used to deactivate the Knife Round by default, otherwise you can also deactivate the Knife Round for Match Mode yourself at any time using the .rk command and the .settings command can be used to check whether the Knife Round is active
- Every player is admin: This would give every player in the connected full admin rights.
- Smoke Color: If selected, every smoke in Prac/Tactic Mode will be thrown in the respective player color.
- Playout: So that you can play all rounds in scrim, you can preselect the settings here, otherwise you can also adjust the settings to your wishes in the game with the .playout command.
- Prac/Tactic mode: If you only play trainings, it might be useful if the server automatically starts in Prac/Tactics mode.
- Damage Output: Convar to toggle damage report (matchmode) after every round.
Example for Smoke Color in Prac Mode
Would you like to customise other features directly from the web interface? Then please contact us in Discord or via support@ckras.com
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
Note: The CKRAS Bot does not need to be activated for adding admins, we have only combined the functions in the webinterface to make it as easy as possible for you as a user to use.
Example Webpanel - here you can add your "SteamID64"
[Example Pictures: 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 toogled on/off in the panel or edited manually in the config.cfg (folder: /cs2/game/csgo/cfg/MatchZy).
If you want to deactivate the admin query, you can use the toogle as mentioned or manually edit this line in the config file.
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
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. (FTP)
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 whitlist, 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
Custom Coach Spawns
Spawns will be defined in addons/counterstrikesharp/plugins/MatchZy/spawns/coach/<map_name>.json.
Each map will have its json file, in which there will be 2 keys, "3" and "2". 3 -> CT, 2 -> T and the values will be an array of Vector and QAngle objects.
CS2 Battle Discord Bot
Discord-Addon: The CS2 Battle Discord Bot is your go-to solution for seamlessly organizing and enjoying 5v5 matches with your friends directly on your Discord server.
https://github.com/Qwizi/cs2-battle-bot
Database
You can setup your Database (GAMING SQL) in the CKRAS Panel to get access to the Feature: MatchZy Stats.
With our Database you can connect to the MatchZy Stats see here: https://shobhit-pathak.github.io/MatchZy/database_stats/
If your MySQL database is correctly connected, the match data is automatically entered in the MatchZy Stats DB and you can analyse it conveniently with Excel (.csv) files.
"DatabaseType": "MySQL", "MySqlHost": "gamingsql.ckras.com", "MySqlDatabase": "db(yournumber)", "MySqlUsername": "sql(yournumber)", "MySqlPassword": "your_mysql_password", "MySqlPort": 3306
Change Language
You can adjust the Language of the Plugin by editing ServerLanguage for CSS/MatchZy in this file: /csgo/addons/counterstrikesharp/configs/core.json (FTP)
Available Languages (DE, EN, FR, PT, RU, UZ, HU, JP)
Demos
NOTE: Demos are recorded automatically with Matchzy, you only have to get sure that TV is activated, optional you can start demos manually via Chat CMDs aswell!
For CSTV demos we added the Commands to manually record with !tvrecord (alias: !record) !tvstop to start/stop a CS2 Demo (see commands above) (please get always sure that tv_enable 1 is set in your server.cfg or click activate in the panel), the demo is stored in the default CS2 ftp-folder: /cs2/game/csgo or in the MatchZy demo folder /cs2/game/csgo/MatchZy You can manage your Demos easily in the Webpanel - see Demo Section
Activate CSTV/GOTV in The Webpanel, turn the TV ON
NEW: Demo Section in the webpanel
Please note that the CSTV / GOTV server can crash, we hope that Valve will bring a fix here soon.
Backup
MatchZy offers several options to restore a backup for a running match (.start, .ready), see also above under Commands.
.stop or !stop for all Users: Restore the backup of the current round (Both teams need to type !stop to restore the current round)
.restore or !restore for Admins: Restore the backup a specify round, command for example !restore 8 (8 round)
Alternative:
matchzy_listbackups is the command in console to see the list of backups (You can find them on csgo/MatchZyDataBackup/ from your server's FTP.
matchzy_loadbackup filenamehere.json Example: matchzy_loadbackup matchzy_data_backup_13_0_round_03.json
Display in the Chat !help
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 & !nade) via our CKRAS BOT.
(Screenshot CKRAS BOT !help output in Chat, by Default available)
(Screenshot: This is the default display of the commands of MatchZy without our CKRAS BOT, command .help or !help)
Bindings
TIPP: To use bindings for cmds you can use the following examples.
bind <key> css_rcon sv_rethrow_last_grenade
bind <key> say .clear
NOTE: If you do not want to activate the CKRAS BOT and do not need the additional HELP Chat 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 (expect !nade menu).
Feedback / Suggestions
If you have any feedback on the plugin or requests for additional features, please feel free to contact us at any time in Discord or via email support@ckras.com
You need Support? Join Discord:
