MatchZy

MatchZy is a plugin for your CS2 Gameserver to run and manage Practice/Pugs/Scrims/Coaching with easy configuration. Here we explain how easy you can install and use (!help) this plugin 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, prac, with simple commands (cmd list below) you can operate the CS2 server (!prac).

MatchZy Commands

Here you will find all available commands to manage your CS2 gameserver.

Custom Commands

Commands	Description
!help	Lists the most important available commands.
!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 the specified side. Example: !coach t, to start coaching terrorist side!
!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.
!rethrow NEW	command will rethrow the exact same last smoke, flash, molly or HE you threw.
!last NEW	command which teleports the player to the last thrown grenade position
!timer NEW	command which starts a timer immediately and stops it when you type .timer again, telling you the duration of time
!back <number> NEW	command which teleports you back to the provided position in your grenade history
!throwindex <index> <optional index> <optional index> NEW	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 NEW	command which sets a delay on your last grenade. This is only used when using .rethrow or .throwindex
!lastindex NEW	command which prints index (position) number of your last thrown grenade.
!rethrowsmoke NEW !rethrownade NEW !rethrowflash NEW !rethrowmolotov NEW !rethrowdecoy NEW	Added grenade-specific rethrow commands for every grenade type
!clear	Clears all the active smokes, molotoves and incendiaries
!fastforward	Fastforwards the server time to 20 seconds
!noflash	Toggles immunity for flashbang (it will still blind others with noflash disabled)
!dryrun	Turns on dry-run mode
!god	Turns on god mode
!break	Breaks all the breakable entities (glass windows, wooden doors, vents, etc)
.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 <optionale 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.

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.
!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 (Alias: !training, !pracc, !train)
!exitprac	Exits from practice mode and loads Match mode. (Alias !exittraining; exitpracc, !exittrain)
!restore <round>	Restore a Round with (!restore 8 = 8 round)
!map <name>	Switches to the desired map e.g. !map dust2 or de_dust2
!tvrecord	Start a demo on your CSTV Server (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)

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 (COACH outdated 12.February 2024). We recommend to use only MatchZy for the use of !coach <ct|t> in the future, because in addition to the pure coach function, features such as spawn, noflash, clear, rethrow and many more are available, see the commands in detail above in this wiki.

You need Support? Join Discord:

TIPP: To use bindings for cmds you can use the following example.

bind <key> css_rcon sv_rethrow_last_grenade

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 SteamID63

[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 a admin to the server.

>> MatchZy offers a variety of different admin options, you can see them for yourself in their WIKI. << We recommand to use our CKRAS ADD ADMIN because its fully integrated.

Configuring Warmup/Knife/Live/Prac CFGs

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 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

Again, inside 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

steamid2

steamid3

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: For CSTV demo we added the Commands !tvrecord (alias: !tvrecord) !tvstop to start/stop a CS2 Demo, the demo is stored in the default ftp-folder: /cs2/game/csgo.

You need Support? Join Discord:

Order here your CS2 Gameserver