MatchZy: Difference between revisions

From CKRAS Wiki

← Older edit
VisualWikitext
No edit summary
No edit summary
 
(88 intermediate revisions by the same user not shown)
Line 2: Line 2:


{{#seo:
{{#seo:
|title=Scrim/Prac Solution for your CS2 Gameserver - CKRAS WIKI
|title=Scrim & Practice Plugin for CS2 Gameservers - CKRAS WIKI
|title_mode=append
|title_mode=append
|keywords=ckras, wiki, cs2, gameserver, help, guide, csgo, webinterface, webpanel, scrim, coach, coaches, easy, matches, bo1, bo3, setup, get5, nade, spawn, setup, full-integrated, ckras
|keywords=ckras, cs2, matchzy, matchzy pro, scrim plugin, practice plugin, cs2 scrim, cs2 practice, cs2 matches, gameserver, nade practice, coach system, bo1, bo3, competitive matches, cs2 server plugin
|description=With MatchZy for CS2 you can run pracs, matches / scrims with multiple coaches on your gameserver. You can use MatchZy with a one click installation on CKRAS.
|description=MatchZy PRO is a custom extended version of MatchZy used exclusively on CKRAS CS2 servers. It allows you to run scrims, practice sessions and competitive matches with features like coaches, nade practice and automated match control.
|image=MATCHZY - CS2 Plugin.png
|image=MATCHZY - CS2 Plugin.png
|image_alt=MatchZy - Play Scrim/Prac plugin with multiple coaches on your CS2 gameserver
|image_alt=MatchZy PRO – CS2 scrim and practice plugin for CKRAS servers
}}
}}


<div class="ck-page">
<div class="ck-page">


<div class="ck-hero ck-hero--dark">
<div class="ck-hero--dark">
  <div class="ck-hero-inner">
{| style="background:transparent; border:none; width:100%;"
    <div class="ck-hero-logo">
|-
      [[File:MATCHZY - CS2 Plugin.png|110px|alt=MatchZy - CS2 Plugin|link=MatchZy]]
| style="vertical-align:top; width:130px; padding-right:20px;" |
    </div>
<div class="ck-hero-logo">[[File:MATCHZY - CS2 Plugin.png|110px|alt=MatchZy - CS2 Plugin|link=MatchZy]]</div>
 
| style="vertical-align:top;" |
    <div class="ck-hero-content">
<div class="ck-hero-content">
      <div class="ck-hero-title">MatchZy for CS2</div>
<h1 class="ck-hero-title">MatchZy PRO (CKRAS EDITION)</h1>
      <div class="ck-hero-sub">
<div class="ck-hero-sub">MatchZy PRO is an extended and modified version of MatchZy, developed and used exclusively on CKRAS CS2 servers for Practice, PUGs, Scrims, and Matches.</div>
        Practice • PUGs • Scrims (Multiple Coaches) • Matches • Wingman — fully integrated on CKRAS
<div class="ck-hero-meta"><b>Quick Start:</b> Type <code>!help</code> or <code>.help</code> in-game to explore commands and guides.</div>
      </div>
<div class="ck-hero-actions">
 
[https://iface.ckras.com <span class="ck-btn ck-btn-primary">▶ Start on CKRAS</span>]
      <div class="ck-hero-meta">
[https://www.ckras.com/en/ <span class="ck-btn ck-btn-ghost">CKRAS Website</span>]
        <b>Quick Start:</b> Type <code>!help</code> or <code>.help</code> in-game to view commands.
[https://play.ckras.com <span class="ck-btn ck-btn-ghost">Play</span>]
      </div>
[https://wiki.ckras.com/wiki/index.php?title=MatchZy<span class="ck-btn ck-btn-ghost">Deutsch 🇩🇪</span>]
 
</div>
      <div class="ck-hero-actions">
</div>
        [https://iface.ckras.com <span class="ck-btn ck-btn-primary">▶ Start on CKRAS</span>]
|}
        [https://www.ckras.com/en/ <span class="ck-btn ck-btn-ghost">CKRAS Website</span>]
        [https://wiki.ckras.com/wiki/index.php?title=MatchZy_Deutsch <span class="ck-btn ck-btn-ghost">Deutsch 🇩🇪</span>]
      </div>
    </div>
  </div>
</div>
</div>
[[File:Matchzygaming.png|right|260px|alt=MatchZy for CS2 Gameserver|link=]]


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


<div class="ck-jump">
<div class="ck-jump">
<b>Jump to:</b> [[#MatchZy_Commands|Commands]] • [[#Install_MatchZy|Install]] • [[#MatchZy_Options|Options]] • [[#ADD_Admin_(become_Admin)|Add Admin]]
<b>Jump to:</b> [[MatchZy#Help & Command Guide System|Help System]] • [[MatchZy#Commands|Commands]] • [[MatchZy#Install MatchZy|Install]] • [[MatchZy#MatchZy Options|Options]] • [[MatchZy#Become Admin|Become Admin]] • [[MatchZy#Support and Recovery|Support]]
</div>
</div>


<div class="ck-tocbox">
== Why MatchZy & CKRAS BOT ==
<div class="ck-toc-title">On this page</div>
 
* [[#Why_MatchZy_&_CKRAS_BOT|Why MatchZy & CKRAS BOT]]
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]].
* [[#MatchZy_Commands|MatchZy Commands]]
 
** [[#Custom_Commands|Custom Commands]]
<div class="ck-callout ck-callout--amber">
** [[#Practice_Mode_Commands|Practice Mode Commands]]
<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;
** [[#Admin_Commands|Admin Commands]]
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.
* [[#Install_MatchZy|Install MatchZy]]
* [[#MatchZy_Options|MatchZy Options]]
* [[#ADD_Admin_(become_Admin)|ADD Admin (become Admin)]]
* [[#Configuring_Warmup/Knife/Live/Prac_CFGs|Configuring CFGs]]
* [[#Database|Database]]
* [[#Change_Language|Change Language]]
* [[#Demos|Demos]]
* [[#Backup|Backup]]
* [[#Display_in_the_Chat_!help|Display in the Chat !help]]
* [[#Bindings|Bindings]]
* [[#Feedback_/_Suggestions|Feedback / Suggestions]]
</div>
</div>


----
== Help & Command Guide System ==


== Why MatchZy & CKRAS BOT ==
<div class="ck-callout">
<b><code>NEW</code> MatchZy-PRO Help:</b> Use <code>.help prac</code> or <code>!help prac</code> to display practice commands grouped into categories like Positions, Grenades, Bots and Utility. You can also use <code>.help &lt;command&gt;</code> or <code>!help &lt;command&gt;</code> to get instant help for specific commands directly in-game.
</div>
 
== Commands ==


With [[CKRAS BOT]] and MatchZy you can easily manage your [[CS2]] gameserver, no matter if it is a scrim (with [[Coach|coaches]]) or training (!prac | !tactics), you can train/save your nade lineups for nade practice on your gameserver, add/remove [[MatchZy#ADD Admin (become Admin)|admins]] easy with our panel. Train with nades !throw (''!nade''s), use !spawns, !timer, !clear, !fastforward and many [[MatchZy#MatchZy Commands|more commands]]. (BOT temp not available)
<div class="ck-lead">
Find all important commands for training, scrims and matches on your [[CS2]] server.
</div>


<div class="ck-callout ck-callout--amber">
<div class="ck-command-nav">
<b>Note:</b> Even without CKRAS BOT, MatchZy works via in-game commands (<code>!help</code>/<code>.help</code>, etc.). CKRAS BOT primarily improves the help/menu experience and panel integration.
[[MatchZy#Custom Commands|Custom Commands]] • [[MatchZy#Practice Mode Commands|Practice Mode Commands]] • [[MatchZy#Admin Commands|Admin Commands]]
</div>
</div>


== MatchZy Commands ==
---
Find '''all''' currently available '''commands''' to easily manage your [[CS2]] server for ''training, scrim or matches''.
<br><br>


{{warning|1=<span style="color:#EE1289;">Note:</span> Any command can be entered with <span style="color:#EE1289">'''.'''</span>'''help''' or <span style="color:#EE1289">'''!'''</span>'''help'''}}
=== Custom Commands ===


===<big>Custom Commands</big>===
<div class="ck-callout">
<b>Use these during normal scrims / matches.</b>
</div>


{| class="wikitable"
{| class="wikitable"
|-
|-
! style="width: 175px;" | Commands
! style="width: 200px;" | !<cmd> / .<cmd>
! style="width: 600px;" | Description
! style="width: 600px;" | Description
|-
|-
| !help || Lists the most important available commands. (see: [[CKRAS BOT]])
| !help || Lists the most important available commands.
|-
| !ready / !r / !rdy || Marks the player ready.
|-
|-
| !ready || Marks the player ready (Alias: <span style="color:#096AB7">!r</span>)
| !unready / !ur || Marks the player unready.
|-
|-
| !unready || Marks the player unready (Alias: <span style="color:#096AB7">!ur, !notready</span>)
| !forceready || Force-readies the player's team (JSON/Get5 setups).
|-
|-
| !pause || Pauses the match in freezetime (Tactical or normal pause, depends on ''matchzy_use_pause_ command_for_tactical_pause'') (Alias: <span style="color:#096AB7">!p</span>)
| !pause / !p || Pauses the match in freezetime.
|-
|-
| !tech || Pauses the match in freezetime.
| !tech || Pauses the match for technical reasons.
|-
|-
| !unpause || Request for unpausing the match. Both teams need to type .unpause to unpause the match (Alias: <span style="color:#096AB7">!up</span>)
| !unpause || Requests match unpause (both teams needed).
|-
|-
| !stay || Stays on the same side (For knife winner, after the knife round)
| !stay || Stay on the same side after the knife round.
|-
|-
| <nowiki>!switch | !swap</nowiki> || Switches the side (For knife winner, after the knife round)
| !switch / !swap || Switches the side after the knife round.
|-
|-
| !stop || ''Restore the backup'' of the current round (Both teams need to type !stop to restore the current round)
| !stop / !restore || Restores the backup of the current round (both teams needed).
|-
|-
| !tac || Starts a tactical timeout
| !tac || Starts a tactical timeout.
|-
|-
| <nowiki>!coach <ct|t></nowiki> || Starts coaching the specified side
| !coach <ct|!coach <side> || Starts coaching the specified side. Example: <code>!coach t</code>
Example: '''!coach t''', to start coaching as a terrorist
|-
| !uncoach || Removes coach status.
|}
 
<div class="ck-callout ck-callout--ok">
<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>
 
---
 
=== Practice Mode Commands ===
 
<div class="ck-callout">
<b>Available in practice mode: <code>!prac</code>.</b> Exit with <code>!exit</code>.
</div>


('''''NEW:''' Multiple Coaches on each side are now available, if you get the msg '''team is full''' you can also join the other team and type <code>!coach t or ct</code> so that you are correctly assigned after the round)''
==== Spawns & Positions ====
{| class="wikitable"
|-
|-
| !uncoach || Removes Coach Status
! style="width: 200px;" | !<cmd> / .<cmd>
! style="width: 600px;" | 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.
|}
|}
<br>
===<big>Practice Mode Commands</big>===
''Note:'' These following commands are only available if the <code>.prac or !prac</code> mode is active - You can end the !prac mode with <code>.exitprac</code>


==== Bot Control & Movement ====
{| class="wikitable"
{| class="wikitable"
|-
|-
! style="width: 175px;" | Commands
! style="width: 200px;" | !<cmd> / .<cmd>
! style="width: 600px;" | Description
! style="width: 600px;" | Description
|-
|-
|!spawn <number>||Spawns to the provided competitive spawn number of same team
| !bot || Adds a bot on your current position.
|-
| !nobots || Removes all bots from the server.
|-
| !cbot / !crouchbot || Adds a crouched bot on your position.
|-
|-
|!ctspawn <number>||Spawns to the provided competitive spawn number of CT ''(Alias: <span style="color:#096AB7">!cts)</span>''
| !boost || Adds a bot and boosts the player on it.
|-
|-
|!tspawn <number>||Spawns to the provided competitive spawn number of T ''(Alias: <span style="color:#096AB7">!ts)</span>''
| !crouchboost || Adds a crouched bot and boosts the player.
|-
|-
|!bestspawn||Teleports you to your team's closest spawn from your current position
| !ct / !t / !spec || Changes the player to the requested team.
|-
|-
|!worstspawn||Teleports you to your team's furthest spawn from your current position
| !fas / !watchme || Forces all players into spectator except you.
|-
|-
|!bestctspawn||Teleports you to CT team's closest spawn from your current position
| !god || Turns on god mode.
|-
|-
|!worstctspawn||Teleports you to CT team's furthest spawn from your current position
| !noclip || Activates / deactivates noclip mode.
|-
|-
|!besttspawn||Teleports you to T team's closest spawn from your current position
| !fastforward / !ff || Fast-forwards server time.
|-
|-
|!worsttspawn||Teleports you to T team's furthest spawn from your current position
| !dryrun / !dry || Turns on dry-run mode.
|-
|-
|!showspawns||Shows competitive spawns in "!prac" mode ([[:File:Spawns-example.png|example picture]])
| !solid || Toggle solid teammates on/off.
<code>>> New you can select spawns with "E" << ''<span style="color:#096AB7">(Alias: !spawns)</span>''</code>
|-
|-
|!hidespawns||Remove competitive spawns in prac mode
| !impacts || Toggle bullet impacts on/off.
|-
|-
|!solid||<nowiki>Toogle (on|off) solid teammates</nowiki>
| !break || Breaks all breakable entities (glass, vents, etc.)
|}
 
==== Replay & Path Recording (MatchZy PRO) ====
 
<div class="ck-callout ck-callout--amber">
<b>MatchZy PRO Feature:</b> Record movement paths and replay them using bots to simulate real player behavior. These commands are only available on CKRAS servers.
</div>
 
{| class="wikitable"
|-
|-
|!impacts||<nowiki>Toogle (on|off) bullet impacts</nowiki>
! style="width: 200px;" | Command
! style="width: 600px;" | Description
|-
|-
|!traj||<nowiki>Toggle (on|off) grenade trajectories (Alias: </nowiki><span style="color:#096AB7">!pip</span>)
| !record / !rec <code>new</code>
| Record a movement path. Last 5 paths are kept in a temporary history buffer.
|-
|-
|!bot||Adds a bot on user's current position
| !play [all/num/name] <code>new</code>
| Plays current path, specific buffer Slot (1-5), or <code>all</code> to play everyone simultaneously for execute training!
|-
|-
|!nobots||Removes all the bots
| !saveplay [all] &lt;name&gt; <code>new</code>
| Permanently stores the current recording buffer for the active map. Supports single-path recordings as well as multi-path execute recordings. Add <code>all</code> to save the complete scenario.
|-
|-
|!cbot||Adds a crouched bot on user's current position (Alias: <span style="color:#096AB7">!crouchbot</span>)
| !loop / !playloop <code>new</code>
| Enables or disables infinite replay looping.
|-
|-
|!boost||Adds a bot on current position and boosts player on it
| !stop <code>new</code>
| Stops active recording or replay (Practice Mode only).
|-
|-
|!crouchboost||Adds a crouched bot on current position and boosts player on it
| !clearrec <code>new</code>
| Deletes the current recorded path.
|-
|-
|!ct / !t / !spec||Changes player team to the requested team
|!settrigger <code>new</code>
|Set a zone at your feet and walk into it later to start the playback!
|-
|-
|!watchme / !fas||Forces all players into spectator except the player <u>who</u> called this command.
|!showpatch <code>new</code>
|Toggles colored visual lines for recorded bot movements and start-markers.
|-
|-
|!fastforward||Fastforwards the server time to 20 seconds (Alias: <span style="color:#096AB7">!ff</span>)
|!loadplay <name> <code>new</code>
|Loads a previously saved path by name (includes smart-matching).
|-
|-
|!dryrun||Turns on dry-run mode (Alias: <span style="color:#096AB7">!dry</span>)
| !listplays <code>new</code>
| Shows all recordings (both the 5-slot temporary buffer and permanent saved plays).
|-
|-
|!god||Turns on god mode
| !delplay &lt;name&gt; <code>new</code>
| Deletes a saved path recording.
|-
|-
|!break||Breaks all the breakable entities (glass windows, wooden doors, vents, etc)
|!hud <code>new</code>
|Toggle center-screen HUD and visual menus (Practice status/Help Dashboard) for a cleaner UI.
|}
 
==== Nade Tools ====
{| class="wikitable"
|-
|-
|!noclip||Activates or deactivates NOCLIP mode, allowing the player to move freely through the map without collisions.
! style="width: 200px;" | !<cmd> / .<cmd>
! style="width: 600px;" | Description
|-
|-
|!nade||<u>Displays an extra menu</u> only with nades cmds [[CKRAS BOT]] turn "on" (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 Commands (!nade):'''
| !rethrownade || Rethrows your last thrown HE grenade.
|-
|-
|!throw||command will rethrow the exact same last smoke, flash, molly or HE <u>you</u> threw. (Alias: <span style="color:#096AB7">!rethrow</span>)
| !rethrowflash || Rethrows your last thrown flashbang.
|-
|-
|!last||command which teleports the player to the last thrown grenade position
| !rethrowmolotov || Rethrows your last thrown molotov.
|-
|-
|!autogo <code>new</code>||(soon)
| !rethrowdecoy || Rethrows your last thrown decoy.
|-
|-
|!drop<code>new</code>||(soon)
| !last || Teleports you to the last thrown grenade position.
|-
|-
|!auton <code>new</code>||(soon)
| !back <nr> || Teleports you back in your grenade history. <code>!back</code> without number teleports you to last position  <code>new</code>
|-
|-
|!autoff <code>new</code>||(soon)
| !delay <sek> || Sets a delay for Rethrow/Index commands.
|-
|-
|!savepos||command to save your current position and viewangle
| !throwindex <idx> || Throws grenade(s) from history (Example: <code>!throwindex 1 2</code>).
|-
|-
|!loadpos||command to load your last saved position & viewangle in .prac mode
| !lastindex || Prints the index number of your last thrown grenade.
|-
|-
|!timer||command which starts a timer immediately and ''stops'' it when you type ''!timer again'', telling you the duration of time
|!resetnade / !resetnades <code>new</code>
|Command to reset grenade history in Practice Mode
|-
|-
|!back <code>new</code>||Command which teleports you back to the last recorded grenade position. Specifiy selection !back <number> see next line
|!autogo <code>new</code>
|Teleports you to the landing position of your thrown smoke or molotov
|-
|-
|!back <number>||Command which teleports you back to the provided position in your grenade history
|!goto <code>new</code>
|Teleport to a specific position index in grenade history.
|-
|-
|!throwindex <index> <optional index> ''<optional index>''||Command which throws grenade of provided position(s) from your grenade thrown history.
|!drop <code>new</code>
|Drops the player to the ground, fixing potential stuck-in-air issues after noclip.
|-
|-
|!delay <delay_in_seconds>||command which sets a delay on your last grenade.
| !clear || Clears active smokes, molotovs and incendiaries.
|-
|-
|!lastindex||command which prints index (position) number of your last thrown grenade.
| !traj / !pip || Toggle grenade trajectories and preview window.
|-
|-
|!rethrowsmoke
| !noflash / !noblind || Toggles flashbang immunity.
<nowiki>!rethrownade</nowiki>
<nowiki>!rethrowflash</nowiki>
<nowiki>!rethrowmolotov</nowiki>
<nowiki>!rethrowdecoy</nowiki>
|Added grenade-specific rethrow commands for every grenade type (''!nade'' = Nade Menu)
|-
|-
|!clear||Clears all the active smokes, molotoves and incendiaries
| !nade / !nades || Displays the nade menu (requires [[CKRAS BOT]]).
|-
|-
|!noblind||Toggles immunity for flashbang (Alias: <span style="color:#096AB7">!noflash</span>)
| !savepos / !loadpos || Saves or loads your current position.
|-
|-
|!savenade <name> ''<optional description>''||Saves a lineup (Alias: <span style="color:#096AB7">!sn</span>)
| !timer || Starts/stops a movement or smoke timer.
|-
|-
|!loadnade <name>||Loads a lineup (Alias: <span style="color:#096AB7">!ln</span>)
| !savenade / !sn || Saves a lineup permanently.
|-
|-
|!delnade <name>||Deletes a lineup from file (Alias: <span style="color:#096AB7">!deletenade, !dn</span>)
| !loadnade / !ln || Loads a saved lineup.
|-
|-
|!importnade||Upon saving a lineup a code will be printed to chat
| !delnade / !dn || Deletes a saved lineup.
|-
|-
|!listnades <optional filter>||Lists either all saved lineups ever or filtered (Alias: <span style="color:#096AB7">!lin</span>)
| !importnade / !in || Imports a lineup from a code.
|-
|-
|!globalnades||Stores nades global on server (Alias: <span style="color:#096AB7">!save_nades_as_global</span>)
| !listnades / !lin || Lists saved lineups (optional filter).
|}
|}


{{warning|1=<span style="color:#EE1289;">Note:</span> Any command can be entered with <span style="color:#EE1289">'''.'''</span>'''help''' or <span style="color:#EE1289">'''!'''</span>'''help'''}}
---
<br><br>


===<big>Admin Commands</big>===
=== Admin Commands ===
>> [[MatchZy#ADD Admin (become Admin)|Assign admin]] <<
 
<div class="ck-callout ck-callout--amber">
<b>Admin required.</b> See [[MatchZy#Become Admin|How to become Admin]] to manage your server.
</div>


{| class="wikitable"
{| class="wikitable"
|-
|-
! style="width: 175px;" | Commands
! style="width: 200px;" | !<cmd> / .<cmd>
! style="width: 600px;" | Description
! style="width: 600px;" | Description
|-
|-
|!restart||Force restarts/'''resets''' a match (Alias: <span style="color:#096AB7">!rr</span>)
| !restart / !rr || Force restarts the match.
|-
|-
|!force or <span style="color:#096AB7">!start</span>||Force <u>starts</u> a <u>match</u>. (Alias: <span style="color:#096AB7">!forcestart</span>)
| !start / !force || Force starts a match (Alias: !scrim).
|-
|-
|!endmatch||Force <u>ends</u> a <u>match</u>. (Alias: <span style="color:#096AB7">!forceend</span>)
| !endmatch / !forceend || Force ends a match. (ALies: !exit)
|-
|-
|!prac or <span style="color:#096AB7">!tactics</span>||Starts Prac Mode
| !prac / !tactics || Starts practice mode.
|-
|-
|!exitprac||'''Exits''' practice mode and loads match mode
| !exit / !exitprac || Exits practice mode + <code>new</code> reset the current match state (warmup) even during a live game
|-
|-
|!map <name>||Switches to the desired map
| !map <name> || Switches the map (e.g., <code>!map de_inferno</code>).
|-
|-
|!forcepause||Pauses the match as an admin (Alias: <span style="color:#096AB7">!fp</span>)
|!dm / !deathmatch <code>new</code>
|toggles deathmatch mode during warmup on and off, see [[MatchZy#MatchZy Options|options]]
|-
|-
|!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 / Backup a round
| !forceunpause / !fup || Force unpauses the match.
|-
|-
|!rcon <command>||RCON Commands
| !restore <round> || Restore a specific backup round.
|-
|-
|!skipveto||Skips the current veto phase (Alias: <span style="color:#096AB7">!sv</span>)
| !rcon <command> || Sends RCON commands to the server. (alternative via console css_rcon <cmd>
|-
|-
|!roundknife||Toggles knife round (Alias: <span style="color:#096AB7">!rk</span>)
| !roundknife / !rk / !knife <code>new</code>|| Toggles knife round.
|-
|-
|!playout||Toggles playout (useful in scrim)
| !playout / !clinch <code>new</code>|| Toggles playout (match continues after winner is decided).
|-
|-
|!tvrecord||Start demo manually (see [[CSTV]])
|!overtime / !ot <code>new</code>
|Toggles overtime for the match. Overtime is enabled by default in live.cfg.
|-
|-
|!tvstop||Stops a demo (Alias: <span style="color:#096AB7">!stoprecord, !stoptv</span>)
| !asay <message> || Say as an admin in all chat.
|-
|-
|!whitelist||Toggles whitelisting (cfg/MatchZy/whitelist.cfg)
| !reload_admins || Reloads admins from admins.json.
|-
|-
|!readyrequired <number>||Sets ready players required
| !team1 / !team2 <name> || Sets name for Team 1 or Team 2.
|-
|-
|!settings||Displays current settings
| !skipveto / !sv || Skips the current veto phase.
|-
|-
|!asay <message>||Say as an admin in all chat
| !whitelist || Toggles whitelisting of players.
|-
|-
|!reload_admins||Reload admins from admins.json
| !readyrequired <num> || Sets the number of ready players required to start.
|-
|-
|!reloadmap||Reloads the current map
| !settings || Displays the current server settings.
|-
|!team1 <name>||Sets name for Team 1
|-
|!team2 <name>||Sets name for Team 2
|}
|}
<br>
{{warning|1=<span style="color:#EE1289;">Note:</span> Any command can be entered with <span style="color:#EE1289">'''.'''</span>'''help''' or <span style="color:#EE1289">'''!'''</span>'''help'''}}
<br>'''NEW:''' Loading Nades !ln | .ln:<br>
<code>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)</code>
If you have any suggestions for additional features, please let us know: support@ckras.com


== Install MatchZy ==
== 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.


'''<big>''Note:'' MatchZy is already pre-installed on all our gameservers by default.</big>'''
MatchZy requires [[Metamod]]. Install Metamod first in the [[webinterface]], then activate [[CounterStrikeSharp]] and MatchZy.


[[File:Install-metamod.png|alt=install metamod|750x750px|link=]]
<div class="ck-callout ck-callout--amber">
'''Note:''' MatchZy is preinstalled on all our [[CS2]] gameservers.
</div>


=== Activate CSS + MatchZy ===
<div class="ck-step-grid">
The following image shows that after activating Metamod, [[CounterStrikeSharp]] (CSS) and MatchZy can now be installed.
<div class="ck-step-card">
<div class="ck-step-top">
<div class="ck-step-num">1</div>
<div class="ck-step-title">Install Metamod</div>
</div>
<div class="ck-media-frame">[[File:Install-metamod.png|450px|alt=Install Metamod|link=]]</div>
<div class="ck-step-desc">Install and activate Metamod in the webinterface first.</div>
</div>


'''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 “[[MatchZy#ADD Admin (become Admin)|Become a MatchZy admin]]”.
<div class="ck-step-card">
<div class="ck-step-top">
<div class="ck-step-num">2</div>
<div class="ck-step-title">Activate CSS + MatchZy</div>
</div>
<div class="ck-media-frame">[[File:Install-matchzy-panel.png|450px|alt=Activate CounterStrikeSharp and MatchZy|link=]]</div>
<div class="ck-step-desc">After Metamod is active, [[CounterStrikeSharp]] (CSS) and MatchZy can be installed.</div>
</div>


[[File:Install-matchzy-panel.png|alt=Matchzy Installation|750x750px|link=]]
<div class="ck-step-card">
 
<div class="ck-step-top">
=== Update MatchZy ===
<div class="ck-step-num">3</div>
As a rule, MatchZy '''updates are installed automatically'''. If it is not installed automatically, click "Update" in the [[Webinterface|webpanel]] and restart the server.
<div class="ck-step-title">Update MatchZy</div>
 
</div>
[[File:Matchzy-update.png|alt=MatchZy How to Update|750x750px]]
<div class="ck-media-frame">[[File:Matchzy-update.png|450px|alt=Update MatchZy|link=]]</div>
 
<div class="ck-step-desc">Updates are usually automatic. If not, click <b>Update</b> in the webpanel.</div>
<small>To update MatchZy, click ''Update (Version)'' and the latest update will be installed.</small>
</div>
 
</div>
'''You need Support? Join [https://discord.gg/gWaPQhSDsY Discord]:'''
[[File:Discord.png|alt=Discord|50x50px|link=https://discord.gg/gWaPQhSDsY]]


== MatchZy Options ==
== MatchZy Options ==
You can customize settings in the [[Webinterface|webpanel]] (or manually by editing <code>config.cfg</code>).


[[File:Matchzy-options-new.png|alt=MatchZy Options|750x750px|link=]]
You can customize settings in the [[Webinterface|webpanel]].


<u>MatchZy Options in the CKRAS [[Webinterface]]:</u>
[[File:MatchZy options.png|alt=MatchZy-Pro Options|750x750px]]


* '''Knife Round'''
<div class="ck-feature-list">
* '''Every player is admin'''
<span class="ck-feature-pill">Knife Round</span>
* '''Smoke Color'''
<span class="ck-feature-pill">Every player is admin</span>
* '''Playout'''
<span class="ck-feature-pill">Smoke Color</span>
* '''Prac/Tactic mode'''
<span class="ck-feature-pill">Playout</span>
* '''Damage Output'''
<span class="ck-feature-pill">Prac / Tactic mode</span>
* '''Auto Record'''
<span class="ck-feature-pill">Damage Output</span>
<span class="ck-feature-pill">Auto Record</span>
<span class="ck-feature-pill">Autoteleport to Smoke</span>
<span class="ck-feature-pill">Deathmatch during Warmup</span>
</div>


[[File:Color-smokes.jpg|alt=Color Smokes in Prac Mode|750x750px|link=]]
<span id="Become_Admin"></span>
'''''<small>Example for Smoke Color in Prac Mode</small>'''''


Would you like to customise other features? Contact us in [https://discord.gg/gWaPQhSDsY Discord] or via support@ckras.com
== Become Admin ==


== ADD Admin (become Admin) ==
You can become a MatchZy admin by adding yourself in the **CKRAS BOT** section of your panel.
You can become a MatchZy admin by adding yourself as an admin at [[CKRAS BOT]]: [https://wiki-en.ckras.com/wiki/index.php?title=CKRAS_BOT#Add_Admin become admin]


''<u>Note:</u> The CKRAS Bot does not need to be activated for adding admins.''
<div class="ck-step-grid">
<div class="ck-step-card">
<div class="ck-step-top">
<div class="ck-step-num">1</div>
<div class="ck-step-title">Open Admin Management</div>
</div>
<div class="ck-media-frame">[[File:Add-admins.png|450px|alt=Open admin management|link=]]</div>
<div class="ck-step-desc">Click on <b>Add Admin</b> in the CKRAS BOT / MatchZy section.</div>
</div>


[[File:Add-admins.png|alt=ADD ADMINS PANEL|link=]]
<div class="ck-step-card">
<div class="ck-step-top">
<div class="ck-step-num">2</div>
<div class="ck-step-title">Add your SteamID64</div>
</div>
<div class="ck-media-frame">[[File:Add-user-webpanel-bot-admin.png|450px|alt=Add SteamID64 in panel|link=]]</div>
<div class="ck-step-desc">Enter your SteamID64 and save. The plugin will recognize you instantly.</div>
</div>
</div>


'''Example Webpanel — add your SteamID64'''
<div class="ck-callout">
<b>Note:</b> The <code>admin.json</code> can also be edited manually via FTP if needed: <code>/csgo/addons/counterstrikesharp/configs/admins.json</code>
</div>


[[File:Add-user-webpanel-bot-admin.png|alt=Add Admin in Panel|750x750px|link=]]
== Advanced Configuration ==
[[File:Add-user-admin-2.png|alt=Add Admin Panel|750x750px|link=]]
[[File:Add-user-admin-3.png|alt=Add Admin Panel|750x750px|link=]]


''<small>[Example Pictures: HOW TO ADD ADMINS IN THE PANEL]</small>''
<div class="ck-section-grid">
<div class="ck-mini-card">
<div class="ck-mini-title">CFG Files</div>
<div class="ck-pathbox"><code>/csgo/cfg/MatchZy</code></div>
Contains <code>warmup.cfg</code>, <code>knife.cfg</code>, <code>live.cfg</code>, <code>deathmatch.cfg</code> and <code>prac.cfg</code>.
</div>


The <u>admin.json</u> can also be edited manually (FTP): <u>/cs2/game/csgo/addons/counterstrikesharp/configs</u>
<div class="ck-mini-card">
<div class="ck-mini-title">Player Whitelist</div>
<div class="ck-pathbox"><code>/csgo/cfg/MatchZy/whitelist.cfg</code></div>
Add one SteamID64 per line to restrict access.
</div>


==== Disable Admin Function ====
<div class="ck-mini-card">
Edit in config:
<div class="ck-mini-title">Language</div>
<blockquote>matchzy_everyone_is_admin <true or false></blockquote>
<div class="ck-pathbox"><code>/csgo/addons/counterstrikesharp/configs/core.json</code></div>
Change the global plugin language (DE, EN, FR, etc.).
</div>
</div>


== Configuring Warmup/Knife/Live/Prac CFGs ==
== Support and Recovery ==
Advanced: edit configs in <code>/csgo/cfg/MatchZy</code> (FTP). Files: warmup.cfg, knife.cfg, live.cfg, prac.cfg.


=== Whitelisting players ===
<div class="ck-section-grid">
Edit <code>whitelist.cfg</code> in <code>csgo/cfg/MatchZy</code>.
<div class="ck-mini-card">
Example:
<div class="ck-mini-title">Backup / Restore</div>
<code>76561198154367261</code>
Restore the current round with <code>!stop</code>. Admins use <code>!restore <round></code>.
</div>


=== Custom Coach Spawns ===
<div class="ck-mini-card">
Spawns: <code>addons/counterstrikesharp/plugins/MatchZy/spawns/coach/&lt;map_name&gt;.json</code>.
<div class="ck-mini-title">Useful Bindings</div>
<div class="ck-pathbox"><code>bind "KEY" "say !rethrow"</code></div>
<div class="ck-pathbox"><code>bind "KEY" "say !clear"</code></div>
</div>


=== CS2 Battle Discord Bot ===
<div class="ck-mini-card">
https://github.com/Qwizi/cs2-battle-bot
<div class="ck-mini-title">Help & Support</div>
Support: [mailto:support@ckras.com support@ckras.com]
[https://discord.gg/gWaPQhSDsY Join Discord]
</div>
</div>


'''Workshop'''
<div class="ck-footer-cta">
[[Workshop|Workshop Guide]]
<div class="ck-footer-cta-title">Ready to run scrims, practice and matches?</div>
 
<div class="ck-footer-cta-sub">Start your CS2 gameserver on CKRAS with MatchZy fully integrated.</div>
== Database ==
<div class="ck-footer-cta-actions">
Setup [[Database]] in the CKRAS panel to use MatchZy Stats.
[https://iface.ckras.com <span class="ck-btn ck-btn-primary">Start on CKRAS</span>]
https://shobhit-pathak.github.io/MatchZy/database_stats/
[https://www.ckras.com/en/ <span class="ck-btn ck-btn-ghost">Order CS2 Gameserver</span>]
 
</div>
== Change Language ==
</div>
Edit <code>/csgo/addons/counterstrikesharp/configs/core.json</code> (FTP).
Available Languages: DE, EN, FR, PT, RU, UZ, HU, JP
 
== Demos ==
<u>NOTE</u>: [[Demos]] are recorded automatically with MatchZy — ensure [[CSTV]] is activated.
 
== Backup ==
MatchZy supports backups via .stop / !stop (users) and .restore / !restore (admins).
 
== Display in the Chat !help ==
CKRAS BOT improves help output. MatchZy also works without it.
 
=== Bindings ===
Examples:
<code>bind &lt;key&gt; css_rcon 'sv_rethrow_last_grenade'</code>
<code>bind &lt;key&gt; say .clear</code>
 
=== Feedback / Suggestions ===
Support: support@ckras.com
 
'''You need Support? Join [https://discord.gg/gWaPQhSDsY Discord]:'''
[[File:Discord.png|alt=Discord|50x50px|link=https://discord.gg/gWaPQhSDsY]]
 
[https://www.ckras.com/en/ '''<big>>>> Order here your CS2 Gameserver</big>''']


[[PreFire]] | [[Retakes]] | [[Deathmatch]]
[[PreFire]] | [[Retakes]] | [[Deathmatch]]
[[index.php?title=Category:CS2]]


</div>
</div>
[[Category:CS2]]

Latest revision as of 14:39, 11 May 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 explore commands and guides.

▶ Start on CKRAS CKRAS Website Play Deutsch 🇩🇪

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: Help System • Commands • Install • Options • Become Admin • Support

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.

Help & Command Guide System

NEW MatchZy-PRO Help: Use .help prac or !help prac to display practice commands grouped into categories like Positions, Grenades, Bots and Utility. You can also use .help <command> or !help <command> to get instant help for specific commands directly in-game.

Commands

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

Custom Commands • Practice Mode Commands • Admin Commands

---

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 / !restore Restores the backup of the current round (both teams needed).
!tac Starts a tactical timeout.
!coach <side> 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.)

Replay & Path Recording (MatchZy PRO)

MatchZy PRO Feature: Record movement paths and replay them using bots to simulate real player behavior. These commands are only available on CKRAS servers.

Command Description
!record / !rec new Record a movement path. Last 5 paths are kept in a temporary history buffer.
!play [all/num/name] new Plays current path, specific buffer Slot (1-5), or all to play everyone simultaneously for execute training!
!saveplay [all] <name> new Permanently stores the current recording buffer for the active map. Supports single-path recordings as well as multi-path execute recordings. Add all to save the complete scenario.
!loop / !playloop new Enables or disables infinite replay looping.
!stop new Stops active recording or replay (Practice Mode only).
!clearrec new Deletes the current recorded path.
!settrigger new Set a zone at your feet and walk into it later to start the playback!
!showpatch new Toggles colored visual lines for recorded bot movements and start-markers.
!loadplay <name> new Loads a previously saved path by name (includes smart-matching).
!listplays new Shows all recordings (both the 5-slot temporary buffer and permanent saved plays).
!delplay <name> new Deletes a saved path recording.
!hud new Toggle center-screen HUD and visual menus (Practice status/Help Dashboard) for a cleaner UI.

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. !back without number teleports you to last position new
!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.
!resetnade / !resetnades new Command to reset grenade history in Practice Mode
!autogo new Teleports you to the landing position of your thrown smoke or molotov
!goto new Teleport to a specific position index in grenade history.
!drop new Drops the player to the ground, fixing potential stuck-in-air issues after noclip.
!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. (ALies: !exit)
!prac / !tactics Starts practice mode.
!exit / !exitprac Exits practice mode + new reset the current match state (warmup) even during a live game
!map <name> Switches the map (e.g., !map de_inferno).
!dm / !deathmatch new toggles deathmatch mode during warmup on and off, see options
!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. (alternative via console css_rcon <cmd>
!roundknife / !rk / !knife new Toggles knife round.
!playout / !clinch new Toggles playout (match continues after winner is decided).
!overtime / !ot new Toggles overtime for the match. Overtime is enabled by default in live.cfg.
!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, deathmatch.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

Ready to run scrims, practice and matches?
Start your CS2 gameserver on CKRAS with MatchZy fully integrated.

Start on CKRAS Order CS2 Gameserver

PreFire | Retakes | Deathmatch

Retrieved from "https://wiki-en.ckras.com/wiki/index.php?title=MatchZy&oldid=3888"