MatchZy: Difference between revisions

From CKRAS Wiki

No edit summary
Line 33: Line 33:


<div class="ck-lead">
<div class="ck-lead">
'''MatchZy''' is the only addon you need for your '''[[CS2]]''' gameserver to run and manage '''Practice, PUGs, Scrims''' (with multiple [[Coach|Coaches]]), and '''Matches''' (supports [[Wingman]]).
'''MatchZy''' is the only addon you need for your '''[[CS2]]''' gameserver to run and manage '''Practice, PUGs, Scrims''' (with multiple [[Coach|Coaches]]), and '''Matches''' (supports [[Wingman]]).&nbsp;&nbsp;
On CKRAS, MatchZy is '''fully integrated''' so you can start right away — including admin management via panel and streamlined in-game usage.
On CKRAS, MatchZy is '''fully integrated''' so you can start right away — including admin management via panel and streamlined in-game usage.
</div>
</div>
Line 48: Line 48:


<div class="ck-callout ck-callout--amber">
<div class="ck-callout ck-callout--amber">
<b>Note:</b> MatchZy works fully via in-game commands. You can use <b>!<cmd></b> or <b>.<cmd></b> (e.g., <code>!help</code> or <code>.help</code>).
<b>Note:</b> MatchZy works fully via in-game commands. You can use <b>!<cmd></b> or <b>.<cmd></b> (e.g., <code>!help</code> or <code>.help</code>).&nbsp;&nbsp;
CKRAS BOT enhances the experience by providing a more convenient help and menu system, easier admin management through the panel, and integration for extended features.
CKRAS BOT enhances the experience by providing a more convenient help and menu system, easier admin management through the panel, and integration for extended features.
</div>
</div>
Line 82: Line 82:
|-
|-
| !unready || Marks the player unready (Alias: <span style="color:#096AB7">!ur, !notready</span>)
| !unready || Marks the player unready (Alias: <span style="color:#096AB7">!ur, !notready</span>)
|-
| !forceready || Force-readies the player's team (Only works when using Match setup using JSON/Get5)
|-
|-
| !pause || Pauses the match in freezetime. (Alias: <span style="color:#096AB7">!p</span>)
| !pause || Pauses the match in freezetime. (Alias: <span style="color:#096AB7">!p</span>)
Line 105: Line 107:
<b>Multiple coaches:</b> If you get the message <code>team is full</code>, join the spectator slot or the other team first and then use <code>!coach t</code> or <code>!coach ct</code> to be assigned correctly.
<b>Multiple coaches:</b> If you get the message <code>team is full</code>, join the spectator slot or the other team first and then use <code>!coach t</code> or <code>!coach ct</code> to be assigned correctly.
</div>
</div>


=== Practice Mode Commands ===
=== Practice Mode Commands ===
Line 198: Line 199:
| !delay <seconds> || Sets a delay on your last grenade (used for .rethrow or .throwindex)
| !delay <seconds> || Sets a delay on your last grenade (used for .rethrow or .throwindex)
|-
|-
| !throwindex <idx> || Throws grenade(s) of provided position(s) from your history (Example: !throwindex 1 2)
| !throwindex <idx> || Throws grenade(s) from history (Example: <code>!throwindex 1 2</code>)
|-
|-
| !lastindex || Prints the index number of your last thrown grenade
| !lastindex || Prints the index number of your last thrown grenade
Line 252: Line 253:
| !roundknife || Toggles knife round (Alias: <span style="color:#096AB7">!rk</span>)
| !roundknife || Toggles knife round (Alias: <span style="color:#096AB7">!rk</span>)
|-
|-
| !playout || Toggles playout (match continues after 16 rounds)
| !playout || Toggles playout (match continues after winner is decided)
|-
| !asay <message> || Say as an admin in all chat
|-
| !reload_admins || Reloads admins from admins.json
|-
| !team1 <name> || Sets name for Team 1 (CT by default)
|-
| !team2 <name> || Sets name for Team 2 (Terrorist by default)
|-
| !skipveto || Skips the current veto phase (Alias: <span style="color:#096AB7">!sv</span>)
|-
| !whitelist || Toggles whitelisting of players
|-
| !readyrequired <num> || Sets the number of ready players required to start the match
|-
| !settings || Displays the current server settings
|}
|}



Revision as of 14:07, 20 March 2026


MatchZy PRO (CKRAS EDITION)

MatchZy PRO is an extended and modified version of MatchZy, developed and used exclusively on CKRAS CS2 servers for Practice, PUGs, Scrims, and Matches.
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.

CKRAS BOT also provides a convenient admin panel, allowing server owners to easily add or remove admins and manage server features without editing configuration files.

Note: MatchZy works fully via in-game commands. You can use !<cmd> or .<cmd> (e.g., !help or .help).   CKRAS BOT enhances the experience by providing a more convenient help and menu system, easier admin management through the panel, and integration for extended features.

Commands

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

Quick Guide: Use Custom Commands for scrims, Practice Mode Commands for training, and Admin Commands for server setup.

Custom Commands

Use these during normal scrims / matches.

!<cmd> / .<cmd> Description
!help Lists the most important available commands.
!ready Marks the player ready (Alias: !r)
!unready Marks the player unready (Alias: !ur, !notready)
!forceready Force-readies the player's team (Only works when using Match setup using JSON/Get5)
!pause Pauses the match in freezetime. (Alias: !p)
!tech Pauses the match for technical reasons.
!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 Switches the side after the knife round (Alias: !swap)
!stop Restores the backup of the current round. Both teams need to type !stop.
!tac Starts a tactical timeout.
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 spectator slot or the other team first and then use !coach t or !coach ct to be assigned correctly.

Practice Mode Commands

Available in practice mode: !prac. Exit with !exit.

!<cmd> / .<cmd> Description
!spawn <number> Spawns to the provided competitive spawn number of your 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 competitive spawn
!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. You can select spawns with "E" (Alias: !spawns)
!hidespawns Removes competitive spawn visuals
!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 your current position
!nobots Removes all bots
!cbot Adds a crouched bot on your current position (Alias: !crouchbot)
!boost Adds a bot and boosts the player on it
!crouchboost Adds a crouched bot on current position and boosts player on it
!ct / !t / !spec Changes the player to the requested team
!fas Forces all players into spectator except the player who called this command (Alias: !watchme)
!fastforward Fast-forwards server time (Alias: !ff)
!dryrun Turns on dry-run mode (Alias: !dry)
!clear Clears all the active smokes, molotovs and incendiaries
!noflash Toggles immunity for flashbang (Alias: !noblind)
!god Turns on god mode
!break Breaks all breakable entities (glass, vents, etc.)
!noclip Activates / deactivates noclip mode
!nade Displays the nade menu (requires CKRAS BOT) (Alias: !nades)
Nade & Position Commands:
!throw Rethrows your last thrown grenade (Alias: !rethrow)
!rethrowsmoke Rethrows your last thrown smoke grenade
!rethrownade Rethrows your last thrown HE grenade
!rethrowflash Rethrows your last thrown flashbang
!rethrowmolotov Rethrows your last thrown molotov/incendiary
!rethrowdecoy Rethrows your last thrown decoy
!last Teleports the player to the last thrown grenade position
!back <number> Teleports you back to the provided position in your grenade history
!delay <seconds> Sets a delay on your last grenade (used for .rethrow or .throwindex)
!throwindex <idx> Throws grenade(s) from history (Example: !throwindex 1 2)
!lastindex Prints the index number of your last thrown grenade
!savepos Saves your current position and viewangle
!loadpos Loads your last saved position and viewangle
!timer Starts/stops a movement/smoke timer
!savenade <name> Saves a lineup (Alias: !sn)
!loadnade <name> Loads a lineup (Alias: !ln)
!delnade <name> Deletes a lineup (Alias: !dn)
!importnade Imports a lineup from a code (Alias: !in)
!listnades <filter> Lists saved lineups (optional filter) (Alias: !lin)

Admin Commands

Admin required. See How to become Admin to manage your server.

!<cmd> / .<cmd> Description
!restart Force restarts the match (Alias: !rr)
!start Force starts a match (Alias: !scrim, !force)
!endmatch Force ends a match (Alias: !forceend)
!prac Starts practice mode (Alias: !tactics)
!exit Exits practice mode (Alias: !exitprac)
!map <name> Switches the map
!forcepause Pauses the match as admin (Alias: !fp)
!forceunpause Force unpauses the match (Alias: !fup)
!restore <round> Restore a specific backup round
!rcon <command> Sends RCON commands to the server
!roundknife Toggles knife round (Alias: !rk)
!playout Toggles playout (match continues after winner is decided)
!asay <message> Say as an admin in all chat
!reload_admins Reloads admins from admins.json
!team1 <name> Sets name for Team 1 (CT by default)
!team2 <name> Sets name for Team 2 (Terrorist by default)
!skipveto Skips the current veto phase (Alias: !sv)
!whitelist Toggles whitelisting of players
!readyrequired <num> Sets the number of ready players required to start the match
!settings Displays the current server settings

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 automatic. If not, click Update in the webpanel.

MatchZy Options

You can customize settings in the webpanel.

MatchZy-Pro Options

Knife Round Every player is admin Smoke Color Playout Prac / Tactic mode Damage Output Auto Record Autoteleport to Smoke Deathmatch during Warmup

Become Admin

You can become a MatchZy admin by adding yourself in the **CKRAS BOT** section of your panel.

1
Open Admin Management
Open admin management
Click on Add Admin in the CKRAS BOT / MatchZy section.
2
Add your SteamID64
Add SteamID64 in panel
Enter your SteamID64 and save. The plugin will recognize you instantly.

Note: The admin.json can also be edited manually via FTP if needed: /csgo/addons/counterstrikesharp/configs/admins.json

Advanced Configuration

CFG Files
/csgo/cfg/MatchZy

Contains warmup.cfg, knife.cfg, live.cfg and prac.cfg.

Player Whitelist
/csgo/cfg/MatchZy/whitelist.cfg

Add one SteamID64 per line to restrict access.

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

Change the global plugin language (DE, EN, FR, etc.).

Support and Recovery

Backup / Restore

Restore the current round with !stop. Admins use !restore <round>.

Useful Bindings
bind "KEY" "say !rethrow"
bind "KEY" "say !clear"
Help & Support

Support: support@ckras.com
Join Discord

PreFire | Retakes | Deathmatch

index.php?title=Category:CS2