MatchZy: Difference between revisions

From CKRAS Wiki

No edit summary
Line 44: Line 44:


With [[CKRAS BOT]] and MatchZy you can easily manage your [[CS2]] gameserver, whether it is a scrim (with [[Coach|coaches]]) or training (<code>!prac</code> / <code>!tactics</code>). You can train and save nade lineups, use <code>!throw</code>, <code>!spawns</code>, <code>!timer</code>, <code>!clear</code>, <code>!fastforward</code> and many more [[MatchZy#Commands|commands]].
With [[CKRAS BOT]] and MatchZy you can easily manage your [[CS2]] gameserver, whether it is a scrim (with [[Coach|coaches]]) or training (<code>!prac</code> / <code>!tactics</code>). You can train and save nade lineups, use <code>!throw</code>, <code>!spawns</code>, <code>!timer</code>, <code>!clear</code>, <code>!fastforward</code> and many more [[MatchZy#Commands|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.


<div class="ck-callout ck-callout--amber">
<div class="ck-callout ck-callout--amber">
Line 62: Line 60:
</div>
</div>


<div class="ck-callout">
---
<b>Quick Guide:</b> Use <b>Custom Commands</b> for scrims, <b>Practice Mode Commands</b> for training, and <b>Admin Commands</b> for server setup.
</div>


=== Custom Commands ===
=== Custom Commands ===
Line 74: Line 70:
{| class="wikitable"
{| class="wikitable"
|-
|-
! style="width: 175px;" | !<cmd> / .<cmd>
! style="width: 200px;" | !<cmd> / .<cmd>
! style="width: 600px;" | Description
! style="width: 600px;" | Description
|-
|-
| !help || Lists the most important available commands.
| !help || Lists the most important available commands.
|-
|-
| !ready || Marks the player ready (Alias: <span style="color:#096AB7">!r</span>)
| !ready / !r / !rdy || Marks the player ready.
|-
|-
| !unready || Marks the player unready (Alias: <span style="color:#096AB7">!ur, !notready</span>)
| !unready / !ur || Marks the player unready.
|-
|-
| !forceready || Force-readies the player's team (Only works when using Match setup using JSON/Get5)
| !forceready || Force-readies the player's team (JSON/Get5 setups).
|-
|-
| !pause || Pauses the match in freezetime. (Alias: <span style="color:#096AB7">!p</span>)
| !pause / !p || Pauses the match in freezetime.
|-
|-
| !tech || Pauses the match for technical reasons.
| !tech || Pauses the match for technical reasons.
|-
|-
| !unpause || Requests match unpause. Both teams need to type <code>!unpause</code> to continue. (Alias: <span style="color:#096AB7">!up</span>)
| !unpause || Requests match unpause (both teams needed).
|-
|-
| !stay || Stay on the same side after the knife round.
| !stay || Stay on the same side after the knife round.
|-
|-
| !switch || Switches the side after the knife round (Alias: <span style="color:#096AB7">!swap</span>)
| !switch / !swap || Switches the side after the knife round.
|-
|-
| !stop || Restores the backup of the current round. Both teams need to type <code>!stop</code>.
| !stop || Restores the backup of the current round (both teams needed).
|-
|-
| !tac || Starts a tactical timeout.
| !tac || Starts a tactical timeout.
|-
|-
| !coach <ct|<nowiki>!coach <ct|t></nowiki> || Starts coaching the specified side. Example: <code>!coach t</code>
| !coach <ct|t> || Starts coaching the specified side. Example: <code>!coach t</code>
|-
|-
| !uncoach || Removes coach status.
| !uncoach || Removes coach status.
Line 107: Line 103:
<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 114: Line 112:
</div>
</div>


==== Spawns & Positions ====
{| class="wikitable"
{| class="wikitable"
|-
|-
Line 119: Line 118:
! style="width: 600px;" | Description
! style="width: 600px;" | Description
|-
|-
| !spawn <number> || Spawns to the provided competitive spawn number of your team
| !spawn <nr> || Spawns to the provided competitive spawn number.
|-
|-
| !ctspawn <number> || Spawns to the provided competitive spawn number of CT (Alias: <span style="color:#096AB7">!cts</span>)
| !ctspawn / !tspawn || Spawns to CT or T competitive spawns (Alias: !cts / !ts).
|-
|-
| !tspawn <number> || Spawns to the provided competitive spawn number of T (Alias: <span style="color:#096AB7">!ts</span>)
| !bestspawn || Teleports to your team’s closest competitive spawn.
|-
|-
| !bestspawn || Teleports you to your team’s closest competitive spawn
| !worstspawn || Teleports to your team's furthest spawn.
|-
|-
| !worstspawn || Teleports you to your team's furthest spawn from your current position
| !bestctspawn / !worstctspawn || Teleports to the closest / furthest CT spawn.
|-
|-
| !bestctspawn || Teleports you to CT team's closest spawn from your current position
| !besttspawn / !worsttspawn || Teleports to the closest / furthest T spawn.
|-
|-
| !worstctspawn || Teleports you to CT team's furthest spawn from your current position
| !showspawns / !spawns || Shows competitive spawns (Select with "E").
|-
|-
| !besttspawn || Teleports you to T team's closest spawn from your current position
| !hidespawns || Removes competitive spawn visuals.
|}
 
==== Bot Control & Movement ====
{| class="wikitable"
|-
|-
| !worsttspawn || Teleports you to T team's furthest spawn from your current position
! style="width: 200px;" | !<cmd> / .<cmd>
|-
! style="width: 600px;" | Description
| !showspawns || Shows competitive spawns. You can select spawns with "E" (Alias: <span style="color:#096AB7">!spawns</span>)
|-
| !hidespawns || Removes competitive spawn visuals
|-
| !solid || Toggle solid teammates on/off
|-
| !impacts || Toggle bullet impacts on/off
|-
|-
| !traj || Toggle grenade trajectories on/off (Alias: <span style="color:#096AB7">!pip</span>)
| !bot || Adds a bot on your current position.
|-
|-
| !bot || Adds a bot on your current position
| !nobots || Removes all bots from the server.
|-
|-
| !nobots || Removes all bots
| !cbot / !crouchbot || Adds a crouched bot on your position.
|-
|-
| !cbot || Adds a crouched bot on your current position (Alias: <span style="color:#096AB7">!crouchbot</span>)
| !boost || Adds a bot and boosts the player on it.
|-
|-
| !boost || Adds a bot and boosts the player on it
| !crouchboost || Adds a crouched bot and boosts the player.
|-
|-
| !crouchboost || Adds a crouched bot on current position and boosts player on it
| !ct / !t / !spec || Changes the player to the requested team.
|-
|-
| !ct / !t / !spec || Changes the player to the requested team
| !fas / !watchme || Forces all players into spectator except you.
|-
|-
| !fas || Forces all players into spectator except the player who called this command (Alias: <span style="color:#096AB7">!watchme</span>)
| !god || Turns on god mode.
|-
|-
| !fastforward || Fast-forwards server time (Alias: <span style="color:#096AB7">!ff</span>)
| !noclip || Activates / deactivates noclip mode.
|-
|-
| !dryrun || Turns on dry-run mode (Alias: <span style="color:#096AB7">!dry</span>)
| !fastforward / !ff || Fast-forwards server time.
|-
|-
| !clear || Clears all the active smokes, molotovs and incendiaries
| !dryrun / !dry || Turns on dry-run mode.
|-
|-
| !noflash || Toggles immunity for flashbang (Alias: <span style="color:#096AB7">!noblind</span>)
| !solid || Toggle solid teammates on/off.
|-
|-
| !god || Turns on god mode
| !impacts || Toggle bullet impacts on/off.
|-
|-
| !break || Breaks all breakable entities (glass, vents, etc.)
| !break || Breaks all breakable entities (glass, vents, etc.)
|}
==== Nade Tools ====
{| class="wikitable"
|-
|-
| !noclip || Activates / deactivates noclip mode
! style="width: 200px;" | !<cmd> / .<cmd>
! style="width: 600px;" | Description
|-
|-
| !nade || Displays the nade menu (requires [[CKRAS BOT]]) (Alias: <span style="color:#096AB7">!nades</span>)
| !throw / !rethrow || Rethrows your last thrown grenade.
|-
|-
| colspan="2" |
| !rethrowsmoke || Rethrows your last thrown smoke grenade.
|-
|-
| colspan="2" | '''Nade & Position Commands:'''
| !rethrownade || Rethrows your last thrown HE grenade.
|-
|-
| !throw || Rethrows your last thrown grenade (Alias: <span style="color:#096AB7">!rethrow</span>)
| !rethrowflash || Rethrows your last thrown flashbang.
|-
|-
| !rethrowsmoke || Rethrows your last thrown smoke grenade
| !rethrowmolotov || Rethrows your last thrown molotov.
|-
|-
| !rethrownade || Rethrows your last thrown HE grenade
| !rethrowdecoy || Rethrows your last thrown decoy.
|-
|-
| !rethrowflash || Rethrows your last thrown flashbang
| !last || Teleports you to the last thrown grenade position.
|-
|-
| !rethrowmolotov || Rethrows your last thrown molotov/incendiary
| !back <nr> || Teleports you back in your grenade history.
|-
|-
| !rethrowdecoy || Rethrows your last thrown decoy
| !delay <sek> || Sets a delay for Rethrow/Index commands.
|-
|-
| !last || Teleports the player to the last thrown grenade position
| !throwindex <idx> || Throws grenade(s) from history (Example: <code>!throwindex 1 2</code>).
|-
|-
| !back <number> || Teleports you back to the provided position in your grenade history
| !lastindex || Prints the index number of your last thrown grenade.
|-
|-
| !delay <seconds> || Sets a delay on your last grenade (used for .rethrow or .throwindex)
| !clear || Clears active smokes, molotovs and incendiaries.
|-
|-
| !throwindex <idx> || Throws grenade(s) from history (Example: <code>!throwindex 1 2</code>)
| !traj / !pip || Toggle grenade trajectories and preview window.
|-
|-
| !lastindex || Prints the index number of your last thrown grenade
| !noflash / !noblind || Toggles flashbang immunity.
|-
|-
| !savepos || Saves your current position and viewangle
| !nade / !nades || Displays the nade menu (requires [[CKRAS BOT]]).
|-
|-
| !loadpos || Loads your last saved position and viewangle
| !savepos / !loadpos || Saves or loads your current position.
|-
|-
| !timer || Starts/stops a movement/smoke timer
| !timer || Starts/stops a movement or smoke timer.
|-
|-
| !savenade <name> || Saves a lineup (Alias: <span style="color:#096AB7">!sn</span>)
| !savenade / !sn || Saves a lineup permanently.
|-
|-
| !loadnade <name> || Loads a lineup (Alias: <span style="color:#096AB7">!ln</span>)
| !loadnade / !ln || Loads a saved lineup.
|-
|-
| !delnade <name> || Deletes a lineup (Alias: <span style="color:#096AB7">!dn</span>)
| !delnade / !dn || Deletes a saved lineup.
|-
|-
| !importnade <code> || Imports a lineup from a code (Alias: <span style="color:#096AB7">!in</span>)
| !importnade / !in || Imports a lineup from a code.
|-
|-
| !listnades <filter> || Lists saved lineups (optional filter) (Alias: <span style="color:#096AB7">!lin</span>)
| !listnades / !lin || Lists saved lineups (optional filter).
|}
|}
---


=== Admin Commands ===
=== Admin Commands ===
Line 228: Line 231:
{| class="wikitable"
{| class="wikitable"
|-
|-
! style="width: 175px;" | !<cmd> / .<cmd>
! style="width: 200px;" | !<cmd> / .<cmd>
! style="width: 600px;" | Description
! style="width: 600px;" | Description
|-
|-
| !restart || Force restarts the match (Alias: <span style="color:#096AB7">!rr</span>)
| !restart / !rr || Force restarts the match.
|-
| !start || Force starts a match (Alias: <span style="color:#096AB7">!scrim, !force</span>)
|-
|-
| !endmatch || Force ends a match (Alias: <span style="color:#096AB7">!forceend</span>)
| !start / !force || Force starts a match (Alias: !scrim).
|-
|-
| !prac || Starts practice mode (Alias: <span style="color:#096AB7">!tactics</span>)
| !endmatch / !forceend || Force ends a match.
|-
|-
| !exit || Exits practice mode (Alias: <span style="color:#096AB7">!exitprac</span>)
| !prac / !tactics || Starts practice mode.
|-
|-
| !map <name> || Switches the map
| !exit / !exitprac || Exits practice mode.
|-
|-
| !forcepause || Pauses the match as admin (Alias: <span style="color:#096AB7">!fp</span>)
| !map <name> || Switches the map (e.g., <code>!map de_inferno</code>).
|-
|-
| !forceunpause || Force unpauses the match (Alias: <span style="color:#096AB7">!fup</span>)
| !forcepause / !fp || Pauses the match as admin (Players cannot unpause).
|-
|-
| !restore <round> || Restore a specific backup round
| !forceunpause / !fup || Force unpauses the match.
|-
|-
| !rcon <command> || Sends RCON commands to the server
| !restore <round> || Restore a specific backup round.
|-
|-
| !roundknife || Toggles knife round (Alias: <span style="color:#096AB7">!rk</span>)
| !rcon <command> || Sends RCON commands to the server.
|-
|-
| !playout || Toggles playout (match continues after winner is decided)
| !roundknife / !rk || Toggles knife round.
|-
|-
| !asay <message> || Say as an admin in all chat
| !playout || Toggles playout (match continues after winner is decided).
|-
|-
| !reload_admins || Reloads admins from admins.json
| !asay <message> || Say as an admin in all chat.
|-
|-
| !team1 <name> || Sets name for Team 1 (CT by default)
| !reload_admins || Reloads admins from admins.json.
|-
|-
| !team2 <name> || Sets name for Team 2 (Terrorist by default)
| !team1 / !team2 <name> || Sets name for Team 1 or Team 2.
|-
|-
| !skipveto || Skips the current veto phase (Alias: <span style="color:#096AB7">!sv</span>)
| !skipveto / !sv || Skips the current veto phase.
|-
|-
| !whitelist || Toggles whitelisting of players
| !whitelist || Toggles whitelisting of players.
|-
|-
| !readyrequired <num> || Sets the number of ready players required to start the match
| !readyrequired <num> || Sets the number of ready players required to start.
|-
|-
| !settings || Displays the current server settings
| !settings || Displays the current server settings.
|}
|}


Line 395: Line 396:
<div class="ck-mini-card">
<div class="ck-mini-card">
<div class="ck-mini-title">Help & Support</div>
<div class="ck-mini-title">Help & Support</div>
Support: [mailto:support@ckras.com support@ckras.com]<br>
Support: [mailto:support@ckras.com support@ckras.com]
[https://discord.gg/gWaPQhSDsY Join Discord]
[https://discord.gg/gWaPQhSDsY Join Discord]
</div>
</div>

Revision as of 14:31, 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.

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.

---

Custom Commands

Use these during normal scrims / matches.

!<cmd> / .<cmd> Description
!help Lists the most important available commands.
!ready / !r / !rdy Marks the player ready.
!unready / !ur Marks the player unready.
!forceready Force-readies the player's team (JSON/Get5 setups).
!pause / !p Pauses the match in freezetime.
!tech Pauses the match for technical reasons.
!unpause Requests match unpause (both teams needed).
!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 needed).
!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.

Spawns & Positions

!<cmd> / .<cmd> Description
!spawn <nr> Spawns to the provided competitive spawn number.
!ctspawn / !tspawn Spawns to CT or T competitive spawns (Alias: !cts / !ts).
!bestspawn Teleports to your team’s closest competitive spawn.
!worstspawn Teleports to your team's furthest spawn.
!bestctspawn / !worstctspawn Teleports to the closest / furthest CT spawn.
!besttspawn / !worsttspawn Teleports to the closest / furthest T spawn.
!showspawns / !spawns Shows competitive spawns (Select with "E").
!hidespawns Removes competitive spawn visuals.

Bot Control & Movement

!<cmd> / .<cmd> Description
!bot Adds a bot on your current position.
!nobots Removes all bots from the server.
!cbot / !crouchbot Adds a crouched bot on your position.
!boost Adds a bot and boosts the player on it.
!crouchboost Adds a crouched bot and boosts the player.
!ct / !t / !spec Changes the player to the requested team.
!fas / !watchme Forces all players into spectator except you.
!god Turns on god mode.
!noclip Activates / deactivates noclip mode.
!fastforward / !ff Fast-forwards server time.
!dryrun / !dry Turns on dry-run mode.
!solid Toggle solid teammates on/off.
!impacts Toggle bullet impacts on/off.
!break Breaks all breakable entities (glass, vents, etc.)

Nade Tools

!<cmd> / .<cmd> Description
!throw / !rethrow Rethrows your last thrown grenade.
!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.
!rethrowdecoy Rethrows your last thrown decoy.
!last Teleports you to the last thrown grenade position.
!back <nr> Teleports you back in your grenade history.
!delay <sek> Sets a delay for Rethrow/Index commands.
!throwindex <idx> Throws grenade(s) from history (Example: !throwindex 1 2).
!lastindex Prints the index number of your last thrown grenade.
!clear Clears active smokes, molotovs and incendiaries.
!traj / !pip Toggle grenade trajectories and preview window.
!noflash / !noblind Toggles flashbang immunity.
!nade / !nades Displays the nade menu (requires CKRAS BOT).
!savepos / !loadpos Saves or loads your current position.
!timer Starts/stops a movement or smoke timer.
!savenade / !sn Saves a lineup permanently.
!loadnade / !ln Loads a saved lineup.
!delnade / !dn Deletes a saved lineup.
!importnade / !in Imports a lineup from a code.
!listnades / !lin Lists saved lineups (optional filter).

---

Admin Commands

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

!<cmd> / .<cmd> Description
!restart / !rr Force restarts the match.
!start / !force Force starts a match (Alias: !scrim).
!endmatch / !forceend Force ends a match.
!prac / !tactics Starts practice mode.
!exit / !exitprac Exits practice mode.
!map <name> Switches the map (e.g., !map de_inferno).
!forcepause / !fp Pauses the match as admin (Players cannot unpause).
!forceunpause / !fup Force unpauses the match.
!restore <round> Restore a specific backup round.
!rcon <command> Sends RCON commands to the server.
!roundknife / !rk Toggles knife round.
!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 / !team2 <name> Sets name for Team 1 or Team 2.
!skipveto / !sv Skips the current veto phase.
!whitelist Toggles whitelisting of players.
!readyrequired <num> Sets the number of ready players required to start.
!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