MatchZy: Difference between revisions

From CKRAS Wiki

No edit summary
 
(17 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
}}
}}


Line 19: Line 19:
| style="vertical-align:top;" |
| style="vertical-align:top;" |
<div class="ck-hero-content">
<div class="ck-hero-content">
<h1 class="ck-hero-title">MatchZy for CS2</h1>
<h1 class="ck-hero-title">MatchZy PRO (CKRAS EDITION)</h1>
<div class="ck-hero-sub">MatchZy is a CS2 plugin for managing Practice, PUGs, Scrims, and Matches on CKRAS servers.</div>
<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>
<div class="ck-hero-meta"><b>Quick Start:</b> Type <code>!help</code> or <code>.help</code> in-game to view commands.</div>
<div class="ck-hero-meta"><b>Quick Start:</b> Type <code>!help</code> or <code>.help</code> in-game to view commands.</div>
<div class="ck-hero-actions">
<div class="ck-hero-actions">
Line 31: Line 31:
|}
|}
</div>
</div>
[[File:Matchzygaming.png|left|30px|alt=MatchZy for CS2 Gameserver|link=]]


<div class="ck-lead">
<div class="ck-lead">
Line 40: Line 38:


<div class="ck-jump">
<div class="ck-jump">
<b>Jump to:</b> [[MatchZy#MatchZy Commands|Commands]] • [[MatchZy#Install MatchZy|Install]] • [[MatchZy#MatchZy Options|Options]] • [[MatchZy#ADD Admin (become Admin)|Add Admin]]
<b>Jump to:</b> [[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>
 
* [[MatchZy#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#MatchZy Commands|MatchZy Commands]]
 
** [[MatchZy#Custom Commands|Custom 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.
** [[MatchZy#Practice Mode Commands|Practice Mode Commands]]
 
** [[MatchZy#Admin Commands|Admin Commands]]
<div class="ck-callout ck-callout--amber">
* [[MatchZy#Install MatchZy|Install MatchZy]]
<b>Note:</b> MatchZy works fully via in-game commands (<code>!help</code>/<code>.help</code>, etc.), even without CKRAS BOT. 
* [[MatchZy#MatchZy Options|MatchZy Options]]
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 such as additional menus.
* [[MatchZy#ADD Admin (become Admin)|ADD Admin (become Admin)]]
* [[MatchZy#Configuring Warmup/Knife/Live/Prac CFGs|Configuring CFGs]]
* [[MatchZy#Database|Database]]
* [[MatchZy#Change Language|Change Language]]
* [[MatchZy#Demos|Demos]]
* [[MatchZy#Backup|Backup]]
* [[MatchZy#Display in the Chat !help|Display in the Chat !help]]
* [[MatchZy#Bindings|Bindings]]
* [[MatchZy#Feedback / Suggestions|Feedback / Suggestions]]
</div>
</div>


----
== Commands ==


== Why MatchZy & CKRAS BOT ==
<div class="ck-lead">
Find all important commands for training, scrims and matches on your [[CS2]] server.
</div>


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-command-nav">
[[MatchZy#Custom Commands|Custom Commands]] [[MatchZy#Practice Mode Commands|Practice Mode Commands]] [[MatchZy#Admin Commands|Admin Commands]]
</div>


<div class="ck-callout ck-callout--amber">
<div class="ck-callout">
<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.
<b>Quick Guide:</b> Use <b>Custom Commands</b> for scrims and normal match flow, <b>Practice Mode Commands</b> for training and nade work, and <b>Admin Commands</b> if you manage the server or match setup.
</div>
</div>


== MatchZy Commands ==
{{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'''}}
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: 175px;" | Command
! style="width: 600px;" | Description
! style="width: 600px;" | Description
|-
|-
Line 92: Line 85:
| !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>)
|-
|-
| !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 || Pauses the match in freezetime (tactical or normal pause, depending on <code>matchzy_use_pause_command_for_tactical_pause</code>) (Alias: <span style="color:#096AB7">!p</span>)
|-
|-
| !tech || Pauses the match in freezetime.
| !tech || Pauses the match in freezetime.
|-
|-
| !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 need to type <code>.unpause</code> to continue. (Alias: <span style="color:#096AB7">!up</span>)
|-
|-
| !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)
| <nowiki>!switch | !swap</nowiki> || 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 || Restores the backup of the current round. Both teams need to type <code>!stop</code>.
|-
|-
| !tac || Starts a tactical timeout
| !tac || Starts a tactical timeout.
|-
|-
| <nowiki>!coach <ct|t></nowiki> || Starts coaching the specified side
| <nowiki>!coach <ct|t></nowiki> || Starts coaching the specified side. Example: <code>!coach t</code>
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 also join the other team and type <code>!coach t or ct</code> so that you are correctly assigned after the round)''
|-
|-
| !uncoach || Removes Coach Status
| !uncoach || Removes coach status.
|}
|}
<br>


===<big>Practice Mode Commands</big>===
<div class="ck-callout ck-callout--ok">
''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>
<b>Multiple coaches:</b> If you get the message <code>team is full</code>, join the other team first and then use <code>!coach t</code> or <code>!coach ct</code> so you are assigned correctly after the round.
</div>
 
=== Practice Mode Commands ===
 
<div class="ck-callout">
<b>These commands are only available in prac mode:  <code>.prac</code> / <code>!prac</code>.</b> Ends practice mode with <code>.exit <b>/</b> !exit</code>
</div>


{| class="wikitable"
{| class="wikitable"
|-
|-
! style="width: 175px;" | Commands
! style="width: 175px;" | Command
! style="width: 600px;" | Description
! style="width: 600px;" | Description
|-
|-
|!spawn <number>||Spawns to the provided competitive spawn number of same team
| !spawn &lt;number&gt; || Spawns to the provided competitive spawn number of the same team
|-
|-
|!ctspawn <number>||Spawns to the provided competitive spawn number of CT ''(Alias: <span style="color:#096AB7">!cts)</span>''
| !ctspawn &lt;number&gt; || Spawns to the provided competitive spawn number of CT (Alias: <span style="color:#096AB7">!cts</span>)
|-
|-
|!tspawn <number>||Spawns to the provided competitive spawn number of T ''(Alias: <span style="color:#096AB7">!ts)</span>''
| !tspawn &lt;number&gt; || Spawns to the provided competitive spawn number of T (Alias: <span style="color:#096AB7">!ts</span>)
|-
|-
|!bestspawn||Teleports you to your team's closest spawn from your current position
| !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
| !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
| !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
| !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
| !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
| !worsttspawn || Teleports you to T team’s furthest spawn from your current position
|-
|-
|!showspawns||Shows competitive spawns in "!prac" mode ([[:File:Spawns-example.png|example picture]])
| !showspawns || Shows competitive spawns in <code>!prac</code> mode ([[:File:Spawns-example.png|example picture]])<br><code>>> New: you can select spawns with "E" <<</code> (Alias: <span style="color:#096AB7">!spawns</span>)
<code>>> New you can select spawns with "E" << ''<span style="color:#096AB7">(Alias: !spawns)</span>''</code>
|-
|-
|!hidespawns||Remove competitive spawns in prac mode
| !hidespawns || Removes competitive spawns in prac mode
|-
|-
|!solid||<nowiki>Toogle (on|off) solid teammates</nowiki>
| !solid || Toggle solid teammates on/off
|-
|-
|!impacts||<nowiki>Toogle (on|off) bullet impacts</nowiki>
| !impacts || Toggle bullet impacts on/off
|-
|-
|!traj||<nowiki>Toggle (on|off) grenade trajectories (Alias: </nowiki><span style="color:#096AB7">!pip</span>)
| !traj || Toggle grenade trajectories on/off (Alias: <span style="color:#096AB7">!pip</span>)
|-
|-
|!bot||Adds a bot on user's current position
| !bot || Adds a bot on the user’s current position
|-
|-
|!nobots||Removes all the bots
| !nobots || Removes all bots
|-
|-
|!cbot||Adds a crouched bot on user's current position (Alias: <span style="color:#096AB7">!crouchbot</span>)
| !cbot || Adds a crouched bot on the user’s current position (Alias: <span style="color:#096AB7">!crouchbot</span>)
|-
|-
|!boost||Adds a bot on current position and boosts player on it
| !boost || Adds a bot on the current position and boosts the player on it
|-
|-
|!crouchboost||Adds a crouched bot on current position and boosts player on it
| !crouchboost || Adds a crouched bot and boosts the player on it
|-
|-
|!ct / !t / !spec||Changes player team to the requested team
| !ct / !t / !spec || Changes the player to the requested team
|-
|-
|!watchme / !fas||Forces all players into spectator except the player <u>who</u> called this command.
| !watchme / !fas || Forces all players into spectator except the player who called this command
|-
|-
|!fastforward||Fastforwards the server time to 20 seconds (Alias: <span style="color:#096AB7">!ff</span>)
| !fastforward || Fast-forwards server time to 20 seconds (Alias: <span style="color:#096AB7">!ff</span>)
|-
|-
|!dryrun||Turns on dry-run mode (Alias: <span style="color:#096AB7">!dry</span>)
| !dryrun || Turns on dry-run mode (Alias: <span style="color:#096AB7">!dry</span>)
|-
|-
|!god||Turns on god mode
| !god || Turns on god mode
|-
|-
|!break||Breaks all the breakable entities (glass windows, wooden doors, vents, etc)
| !break || Breaks all breakable entities (glass windows, wooden doors, vents, etc.)
|-
|-
|!noclip||Activates or deactivates NOCLIP mode, allowing the player to move freely through the map without collisions.
| !noclip || Activates / deactivates noclip mode
|-
|-
|!nade||<u>Displays an extra menu</u> only with nades cmds [[CKRAS BOT]] turn "on" (Alias: <span style="color:#096AB7">!nades</span>)
| !nade || Displays the nade menu if [[CKRAS BOT]] is enabled (Alias: <span style="color:#096AB7">!nades</span>)
|-
|-
| colspan="2" |
| colspan="2" |
|-
|-
| colspan="2" |'''Nade Commands (!nade):'''
| colspan="2" | '''Nade Commands (!nade):'''
|-
|-
|!throw||command will rethrow the exact same last smoke, flash, molly or HE <u>you</u> threw. (Alias: <span style="color:#096AB7">!rethrow</span>)
| !throw || Rethrows the exact same last grenade you threw (Alias: <span style="color:#096AB7">!rethrow</span>)
|-
|-
|!last||command which teleports the player to the last thrown grenade position
| !last || Teleports the player to the last thrown grenade position
|-
|-
|!autogo <code>new</code>||(soon)
| !autogo || (soon)
|-
|-
|!drop<code>new</code>||(soon)
| !drop || (soon)
|-
|-
|!auton <code>new</code>||(soon)
| !auton || (soon)
|-
|-
|!autoff <code>new</code>||(soon)
| !autoff || (soon)
|-
|-
|!savepos||command to save your current position and viewangle
| !savepos || Saves your current position and viewangle
|-
|-
|!loadpos||command to load your last saved position & viewangle in .prac mode
| !loadpos || Loads your last saved position and viewangle in prac mode
|-
|-
|!timer||command which starts a timer immediately and ''stops'' it when you type ''!timer again'', telling you the duration of time
| !timer || Starts a timer and stops it when you use <code>!timer</code> again
|-
|-
|!back <code>new</code>||Command which teleports you back to the last recorded grenade position. Specifiy selection !back <number> see next line
| !back || Teleports you back to the last recorded grenade position
|-
|-
|!back <number>||Command which teleports you back to the provided position in your grenade history
| !back &lt;number&gt; || Teleports you back to the selected grenade history position
|-
|-
|!throwindex <index> <optional index> ''<optional index>''||Command which throws grenade of provided position(s) from your grenade thrown history.
| !throwindex &lt;index&gt; || Throws grenade(s) from your grenade history
|-
|-
|!delay <delay_in_seconds>||command which sets a delay on your last grenade.
| !delay &lt;delay_in_seconds&gt; || Sets a delay on your last grenade
|-
|-
|!lastindex||command which prints index (position) number of your last thrown grenade.
| !lastindex || Prints the index number of your last thrown grenade
|-
|-
|!rethrowsmoke
| !rethrowsmoke / !rethrownade / !rethrowflash / !rethrowmolotov / !rethrowdecoy || Grenade-specific rethrow commands
<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
| !clear || Clears active smokes, molotovs and incendiaries
|-
|-
|!noblind||Toggles immunity for flashbang (Alias: <span style="color:#096AB7">!noflash</span>)
| !noblind || Toggles flashbang immunity (Alias: <span style="color:#096AB7">!noflash</span>)
|-
|-
|!savenade <name> ''<optional description>''||Saves a lineup (Alias: <span style="color:#096AB7">!sn</span>)
| !savenade &lt;name&gt; || Saves a lineup (Alias: <span style="color:#096AB7">!sn</span>)
|-
|-
|!loadnade <name>||Loads a lineup (Alias: <span style="color:#096AB7">!ln</span>)
| !loadnade &lt;name&gt; || Loads a lineup (Alias: <span style="color:#096AB7">!ln</span>)
|-
|-
|!delnade <name>||Deletes a lineup from file (Alias: <span style="color:#096AB7">!deletenade, !dn</span>)
| !delnade &lt;name&gt; || Deletes a lineup (Alias: <span style="color:#096AB7">!deletenade, !dn</span>)
|-
|-
|!importnade||Upon saving a lineup a code will be printed to chat
| !importnade || Prints an import code to chat after saving
|-
|-
|!listnades <optional filter>||Lists either all saved lineups ever or filtered (Alias: <span style="color:#096AB7">!lin</span>)
| !listnades || Lists saved lineups (Alias: <span style="color:#096AB7">!lin</span>)
|-
|-
|!globalnades||Stores nades global on server (Alias: <span style="color:#096AB7">!save_nades_as_global</span>)
| !globalnades || Stores nades globally on the server (Alias: <span style="color:#096AB7">!save_nades_as_global</span>)
|}
|}


{{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'''}}
<div class="ck-callout">
<br><br>
<b>New:</b> <code>!ln</code> / <code>.ln</code> supports smart name matching. Example: <code>.ln mid</code> can load a lineup called <code>midflash</code>.
</div>


===<big>Admin Commands</big>===
=== Admin Commands ===
>> [[MatchZy#ADD Admin (become Admin)|Assign admin]] <<
 
<div class="ck-callout ck-callout--amber">
<b>Admin required.</b> If you are not admin yet, go to [[MatchZy#Become Admin|Become Admin]].
</div>


{| class="wikitable"
{| class="wikitable"
|-
|-
! style="width: 175px;" | Commands
! style="width: 175px;" | Command
! style="width: 600px;" | Description
! style="width: 600px;" | Description
|-
|-
|!restart||Force restarts/'''resets''' a match (Alias: <span style="color:#096AB7">!rr</span>)
| !restart || Force restarts / resets a match (Alias: <span style="color:#096AB7">!rr</span>)
|-
|-
|!force or <span style="color:#096AB7">!start</span>||Force <u>starts</u> a <u>match</u>. (Alias: <span style="color:#096AB7">!forcestart</span>)
| !scrim or !start || Force starts a match (Alias: <span style="color:#096AB7">!forcestart</span>, <span style="color:#096AB7">!force</span>)
|-
|-
|!endmatch||Force <u>ends</u> a <u>match</u>. (Alias: <span style="color:#096AB7">!forceend</span>)
| !endmatch || Force ends a match (Alias: <span style="color:#096AB7">!forceend</span>)
|-
|-
|!prac or <span style="color:#096AB7">!tactics</span>||Starts Prac Mode
| !prac || Starts prac mode (Alias: <span style="color:#096AB7">!tactics</span>)
|-
|-
|!exitprac||'''Exits''' practice mode and loads match mode
| !exit || Exits practice mode and loads match mode (Alias: <span style="color:#096AB7">!exitprac</span>)
|-
|-
|!map <name>||Switches to the desired map
| !map &lt;name&gt; || Switches to the desired map
|-
|-
|!forcepause||Pauses the match as an admin (Alias: <span style="color:#096AB7">!fp</span>)
| !forcepause || Pauses the match as admin (Alias: <span style="color:#096AB7">!fp</span>)
|-
|-
|!forceunpause||Force unpauses the match (Alias: <span style="color:#096AB7">!fup</span>)
| !forceunpause || Force unpauses the match (Alias: <span style="color:#096AB7">!fup</span>)
|-
|-
|!restore <round>||Restore / Backup a round
| !restore &lt;round&gt; || Restore / backup a round
|-
|-
|!rcon <command>||RCON Commands
| !rcon &lt;command&gt; || Sends RCON commands
|-
|-
|!skipveto||Skips the current veto phase (Alias: <span style="color:#096AB7">!sv</span>)
| !skipveto || Skips the current veto phase (Alias: <span style="color:#096AB7">!sv</span>)
|-
|-
|!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 (useful in scrim)
| !playout || Toggles playout (useful in scrim)
|-
|-
|!tvrecord||Start demo manually (see [[CSTV]])
| !tvrecord || Starts a demo manually (see [[CSTV]])
|-
|-
|!tvstop||Stops a demo (Alias: <span style="color:#096AB7">!stoprecord, !stoptv</span>)
| !tvstop || Stops a demo (Alias: <span style="color:#096AB7">!stoprecord, !stoptv</span>)
|-
|-
|!whitelist||Toggles whitelisting (cfg/MatchZy/whitelist.cfg)
| !whitelist || Toggles whitelisting (<code>cfg/MatchZy/whitelist.cfg</code>)
|-
|-
|!readyrequired <number>||Sets ready players required
| !readyrequired &lt;number&gt; || Sets required ready players
|-
|-
|!settings||Displays current settings
| !settings || Displays current settings
|-
|-
|!asay <message>||Say as an admin in all chat
| !asay &lt;message&gt; || Say as admin in all chat
|-
|-
|!reload_admins||Reload admins from admins.json
| !reload_admins || Reloads admins from <code>admins.json</code>
|-
|-
|!reloadmap||Reloads the current map
| !reloadmap || Reloads the current map (Alias: <span style="color:#096AB7">!rmap</span>)
|-
|-
|!team1 <name>||Sets name for Team 1
| !team1 &lt;name&gt; || Sets Team 1 name
|-
|-
|!team2 <name>||Sets name for Team 2
| !team2 &lt;name&gt; || Sets Team 2 name
|}
|}
<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
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.
 
MatchZy requires [[Metamod]]. Install Metamod first in the [[webinterface]], then activate [[CounterStrikeSharp]] and MatchZy.


<div class="ck-callout ck-callout--amber">
<div class="ck-callout ck-callout--amber">
Line 307: Line 296:
</div>
</div>


<div class="ck-step-grid">


[[File:Install-metamod.png|alt=install metamod|750x750px|link=]]
<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>


=== Activate CSS + MatchZy ===
<div class="ck-step-card">
The following image shows that after activating Metamod, [[CounterStrikeSharp]] (CSS) and MatchZy can now be installed.
<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>


'''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">3</div>
<div class="ck-step-title">Update MatchZy</div>
</div>
<div class="ck-media-frame">
[[File:Matchzy-update.png|450px|alt=Update MatchZy|link=]]
</div>
<div class="ck-step-desc">
Updates are usually installed automatically. If not, click <b>Update</b> in the [[Webinterface|webpanel]] and restart the server.
</div>
</div>


[[File:Install-matchzy-panel.png|alt=Matchzy Installation|750x750px|link=]]
</div>


=== Update MatchZy ===
<div class="ck-callout">
As a rule, MatchZy '''updates are installed automatically'''. If it is not installed automatically, click "Update" in the [[Webinterface|webpanel]] and restart the server.
<b>Tip:</b> To use all admin commands, assign admins in the panel afterwards. See [[MatchZy#Become Admin|Become Admin]].
 
</div>
[[File:Matchzy-update.png|alt=MatchZy How to Update|750x750px]]
 
<small>To update MatchZy, click ''Update (Version)'' and the latest update will be installed.</small>


'''You need Support? Join [https://discord.gg/gWaPQhSDsY Discord]:'''
'''You need Support? Join [https://discord.gg/gWaPQhSDsY Discord]:'''
Line 328: Line 347:


== MatchZy Options ==
== MatchZy Options ==
You can customize settings in the [[Webinterface|webpanel]] (or manually by editing <code>config.cfg</code>).
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=]]
[[File:Matchzy-options-new.png|alt=MatchZy Options|750x750px|link=]]


<u>MatchZy Options in the CKRAS [[Webinterface]]:</u>
<div class="ck-feature-list">
 
<span class="ck-feature-pill">Knife Round</span>
* '''Knife Round'''
<span class="ck-feature-pill">Every player is admin</span>
* '''Every player is admin'''
<span class="ck-feature-pill">Smoke Color</span>
* '''Smoke Color'''
<span class="ck-feature-pill">Playout</span>
* '''Playout'''
<span class="ck-feature-pill">Prac / Tactic mode</span>
* '''Prac/Tactic mode'''
<span class="ck-feature-pill">Damage Output</span>
* '''Damage Output'''
<span class="ck-feature-pill">Auto Record</span>
* '''Auto Record'''
</div>


[[File:Color-smokes.jpg|alt=Color Smokes in Prac Mode|750x750px|link=]]
[[File:Color-smokes.jpg|alt=Color Smokes in Prac Mode|750x750px|link=]]
Line 348: Line 368:
Would you like to customise other features? Contact us in [https://discord.gg/gWaPQhSDsY Discord] or via support@ckras.com
Would you like to customise other features? Contact us in [https://discord.gg/gWaPQhSDsY Discord] or via support@ckras.com


== ADD Admin (become Admin) ==
<span id="ADD_Admin_(become_Admin)">&#8203;</span>
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]
== Become Admin ==
 
You can become a MatchZy admin by adding yourself as an admin in [[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.''
''<u>Note:</u> The CKRAS Bot does not need to be activated for adding admins.''


[[File:Add-admins.png|alt=ADD ADMINS PANEL|link=]]
<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">
Open the admin section in the panel to manage MatchZy admins.
</div>
</div>


'''Example Webpanel — add your SteamID64'''
<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 in the webpanel and save the new admin entry.
</div>
</div>


[[File:Add-user-webpanel-bot-admin.png|alt=Add Admin in Panel|750x750px|link=]]
<div class="ck-step-card">
[[File:Add-user-admin-2.png|alt=Add Admin Panel|750x750px|link=]]
<div class="ck-step-top">
[[File:Add-user-admin-3.png|alt=Add Admin Panel|750x750px|link=]]
<div class="ck-step-num">3</div>
<div class="ck-step-title">Confirm Setup</div>
</div>
<div class="ck-media-frame">
[[File:Add-user-admin-2.png|alt=Confirm admin setup|link=]]
</div>
<div class="ck-step-desc">
Check the created admin entry in the panel and confirm the setup.
</div>
</div>


''<small>[Example Pictures: HOW TO ADD ADMINS IN THE PANEL]</small>''
</div>


The <u>admin.json</u> can also be edited manually (FTP): <u>/cs2/game/csgo/addons/counterstrikesharp/configs</u>
<div class="ck-callout">
<b>Optional:</b> The <code>admin.json</code> can also be edited manually via FTP:<br>
<code>/cs2/game/csgo/addons/counterstrikesharp/configs</code>
</div>


== Advanced Configuration ==
== Advanced Configuration ==
Line 449: Line 507:
Users can restore the current round with <code>.stop</code> or <code>!stop</code>.<br><br>
Users can restore the current round with <code>.stop</code> or <code>!stop</code>.<br><br>
Admins can restore backups with <code>.restore</code> or <code>!restore</code>.
Admins can restore backups with <code>.restore</code> or <code>!restore</code>.
</div>
<div class="ck-mini-card">
<div class="ck-mini-title">In-Game Help</div>
CKRAS BOT improves the help output, but MatchZy also works without it via <code>!help</code> and <code>.help</code>.
</div>
</div>


Line 463: Line 516:


<div class="ck-mini-card">
<div class="ck-mini-card">
<div class="ck-mini-title">Feedback</div>
<div class="ck-mini-title">Help & Support</div>
Support: [mailto:support@ckras.com support@ckras.com]<br><br>
CKRAS BOT improves the help output, but MatchZy also works without it via <code>!help</code> and <code>.help</code>.<br><br>
Support: [mailto:support@ckras.com support@ckras.com]<br>
[https://discord.gg/gWaPQhSDsY Join Discord]
[https://discord.gg/gWaPQhSDsY Join Discord]
</div>
</div>
Line 470: Line 524:
</div>
</div>


[https://www.ckras.com/en/ '''<big>>>> Order here your CS2 Gameserver</big>''']
<div class="ck-footer-cta">
<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>
<div class="ck-footer-cta-actions">
[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">Order CS2 Gameserver</span>]
</div>
</div>


[[PreFire]] | [[Retakes]] | [[Deathmatch]]
[[PreFire]] | [[Retakes]] | [[Deathmatch]]

Latest revision as of 20:26, 11 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 (!help/.help, etc.), even without CKRAS BOT. 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 such as additional menus.

Commands

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

Quick Guide: Use Custom Commands for scrims and normal match flow, Practice Mode Commands for training and nade work, and Admin Commands if you manage the server or match setup.

Note: Any command can be entered with .help or !help

Custom Commands

Use these during normal scrims / matches.

Command 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, depending on matchzy_use_pause_command_for_tactical_pause) (Alias: !p)
!tech Pauses the match in freezetime.
!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 | !swap Switches the side after the knife round.
!stop Restores the backup of the current round. Both teams need to type !stop.
!tac Starts a tactical timeout.
!coach <ct|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 other team first and then use !coach t or !coach ct so you are assigned correctly after the round.

Practice Mode Commands

These commands are only available in prac mode: .prac / !prac. Ends practice mode with .exit / !exit

Command Description
!spawn <number> Spawns to the provided competitive spawn number of the 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 Shows competitive spawns in !prac mode (example picture)
>> New: you can select spawns with "E" << (Alias: !spawns)
!hidespawns Removes competitive spawns in prac mode
!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 the user’s current position
!nobots Removes all bots
!cbot Adds a crouched bot on the user’s current position (Alias: !crouchbot)
!boost Adds a bot on the current position and boosts the player on it
!crouchboost Adds a crouched bot and boosts the player on it
!ct / !t / !spec Changes the player to the requested team
!watchme / !fas Forces all players into spectator except the player who called this command
!fastforward Fast-forwards server time to 20 seconds (Alias: !ff)
!dryrun Turns on dry-run mode (Alias: !dry)
!god Turns on god mode
!break Breaks all breakable entities (glass windows, wooden doors, vents, etc.)
!noclip Activates / deactivates noclip mode
!nade Displays the nade menu if CKRAS BOT is enabled (Alias: !nades)
Nade Commands (!nade):
!throw Rethrows the exact same last grenade you threw (Alias: !rethrow)
!last Teleports the player to the last thrown grenade position
!autogo (soon)
!drop (soon)
!auton (soon)
!autoff (soon)
!savepos Saves your current position and viewangle
!loadpos Loads your last saved position and viewangle in prac mode
!timer Starts a timer and stops it when you use !timer again
!back Teleports you back to the last recorded grenade position
!back <number> Teleports you back to the selected grenade history position
!throwindex <index> Throws grenade(s) from your grenade history
!delay <delay_in_seconds> Sets a delay on your last grenade
!lastindex Prints the index number of your last thrown grenade
!rethrowsmoke / !rethrownade / !rethrowflash / !rethrowmolotov / !rethrowdecoy Grenade-specific rethrow commands
!clear Clears active smokes, molotovs and incendiaries
!noblind Toggles flashbang immunity (Alias: !noflash)
!savenade <name> Saves a lineup (Alias: !sn)
!loadnade <name> Loads a lineup (Alias: !ln)
!delnade <name> Deletes a lineup (Alias: !deletenade, !dn)
!importnade Prints an import code to chat after saving
!listnades Lists saved lineups (Alias: !lin)
!globalnades Stores nades globally on the server (Alias: !save_nades_as_global)

New: !ln / .ln supports smart name matching. Example: .ln mid can load a lineup called midflash.

Admin Commands

Admin required. If you are not admin yet, go to Become Admin.

Command Description
!restart Force restarts / resets a match (Alias: !rr)
!scrim or !start Force starts a match (Alias: !forcestart, !force)
!endmatch Force ends a match (Alias: !forceend)
!prac Starts prac mode (Alias: !tactics)
!exit Exits practice mode and loads match mode (Alias: !exitprac)
!map <name> Switches to the desired map
!forcepause Pauses the match as admin (Alias: !fp)
!forceunpause Force unpauses the match (Alias: !fup)
!restore <round> Restore / backup a round
!rcon <command> Sends RCON commands
!skipveto Skips the current veto phase (Alias: !sv)
!roundknife Toggles knife round (Alias: !rk)
!playout Toggles playout (useful in scrim)
!tvrecord Starts a demo manually (see CSTV)
!tvstop Stops a demo (Alias: !stoprecord, !stoptv)
!whitelist Toggles whitelisting (cfg/MatchZy/whitelist.cfg)
!readyrequired <number> Sets required ready players
!settings Displays current settings
!asay <message> Say as admin in all chat
!reload_admins Reloads admins from admins.json
!reloadmap Reloads the current map (Alias: !rmap)
!team1 <name> Sets Team 1 name
!team2 <name> Sets Team 2 name

If you have any suggestions for additional features, please let us know: support@ckras.com

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 installed automatically. If not, click Update in the webpanel and restart the server.

Tip: To use all admin commands, assign admins in the panel afterwards. See Become Admin.

You need Support? Join Discord: Discord

MatchZy Options

You can customize settings in the webpanel (or manually by editing config.cfg).

MatchZy Options

Knife Round Every player is admin Smoke Color Playout Prac / Tactic mode Damage Output Auto Record

Color Smokes in Prac Mode

Example for Smoke Color in Prac Mode

Would you like to customise other features? Contact us in Discord or via support@ckras.com

Become Admin

You can become a MatchZy admin by adding yourself as an admin in CKRAS BOT: become admin

Note: The CKRAS Bot does not need to be activated for adding admins.

1
Open Admin Management

Open admin management

Open the admin section in the panel to manage MatchZy admins.

2
Add your SteamID64

Add SteamID64 in panel

Enter your SteamID64 in the webpanel and save the new admin entry.

3
Confirm Setup

Confirm admin setup

Check the created admin entry in the panel and confirm the setup.

Optional: The admin.json can also be edited manually via FTP:
/cs2/game/csgo/addons/counterstrikesharp/configs

Advanced Configuration

Advanced setup for MatchZy, including config files, whitelist, coach spawns and language settings.

CFG Files
/csgo/cfg/MatchZy

Edit the main MatchZy configuration files here:

  • warmup.cfg
  • knife.cfg
  • live.cfg
  • prac.cfg
Player Whitelist
/csgo/cfg/MatchZy/whitelist.cfg

Add one SteamID64 per line.

76561198154367261
Custom Coach Spawns
addons/counterstrikesharp/plugins/MatchZy/spawns/coach/<map_name>.json

Use this file to define custom coach spawn positions per map.

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

Available languages: DE, EN, FR, PT, RU, UZ, HU, JP

Integrations and Recording

Optional integrations, stats and recording related features.

Database & Stats

Setup Database in the CKRAS panel to use MatchZy Stats.

Official MatchZy stats guide

Demos / CSTV

MatchZy records demos automatically. Make sure CSTV is activated.

CS2 Battle Discord Bot

GitHub Repository

Workshop

Workshop Guide

Support and Recovery

Everything related to restore, in-game help, binds and support contact.

Backup / Restore

Users can restore the current round with .stop or !stop.

Admins can restore backups with .restore or !restore.

Useful Bindings
bind <key> css_rcon "sv_rethrow_last_grenade"
bind <key> say .clear
Help & Support

CKRAS BOT improves the help output, but MatchZy also works without it via !help and .help.

Support: support@ckras.com
Join Discord

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