MatchZy: Difference between revisions

From CKRAS Wiki

← Older edit
VisualWikitext
 
(269 intermediate revisions by the same user not shown)
Line 1: Line 1:
__NOTOC__
{{#seo:
{{#seo:
|title=Scrim/Prac Solution for your CS2 Gameserver - CKRAS WIKI
|title=Scrim/Prac Solution for your CS2 Gameserver - CKRAS WIKI
|title_mode=append
|title_mode=append
|keywords=ckras, wiki, cs2, gameserver, help, guide, csgo, webinterface, webpanel, scrim, coach, easy, nade, spawn, setup, full-integrated, ckras
|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
|description=MatchZy helps you to run scrims, pracs on your CS2 gameserver. You can use MatchZy with one click installation at CKRAS.
|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.
|image=MATCHZY - CS2 Plugin.png
|image=MATCHZY - CS2 Plugin.png
|image_alt=MatchZy - Play Scrim/Prac plugin on your CS2 gameserver
|image_alt=MatchZy - Play Scrim/Prac plugin with multiple coaches on your CS2 gameserver
}}
}}


'''MatchZy''' is a plugin for [[CS2]] gameserver to run and manage '''Practice/Pugs/Scrims,''' with our fully integrated solution you can get started right away. Here we explain how easy it is to activate and [[MatchZy#MatchZy%20Commands|use]] (!help) this addon on your [https://www.ckras.com/ CKRAS] server.
<div class="ck-page">


[[File:MATCHZY - CS2 Plugin.png|alt=MATCHZY - CS2 Plugin|125x125px]]
<div class="ck-hero--dark">
{| style="background:transparent; border:none; width:100%;"
|-
| style="vertical-align:top; width:130px; padding-right:20px;" |
<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">
<h1 class="ck-hero-title">MatchZy for CS2</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-meta"><b>Quick Start:</b> Type <code>!help</code> or <code>.help</code> in-game to view commands.</div>
<div class="ck-hero-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">CKRAS Website</span>]
[https://play.ckras.com <span class="ck-btn ck-btn-ghost">Play</span>]
[https://wiki.ckras.com/wiki/index.php?title=MatchZy_Deutsch <span class="ck-btn ck-btn-ghost">Deutsch 🇩🇪</span>]
</div>
</div>
|}
</div>
 
<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]]). 
On CKRAS, MatchZy is '''fully integrated''' so you can start right away — including admin management via panel and streamlined in-game usage.
</div>
 
<div class="ck-jump">
<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>


== Why MatchZy & CKRAS BOT ==
== Why MatchZy & CKRAS BOT ==


With [[CKRAS BOT]] and MatchZy you can easily manage (''!help'') your [[CS2]] gameserver, no matter if it is a scrim or !prac, you can save nade lineups, !rethrow (''!nade''), use !spawns, !timer, !fastforward, !clear and many [[MatchZy#MatchZy Commands|more 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]]. Admins can also be added or removed easily through the panel.


<div class="ck-callout ck-callout--amber">
<b>Note:</b> Even without CKRAS BOT, MatchZy works via in-game commands (<code>!help</code>/<code>.help</code>, etc.). CKRAS BOT mainly improves the help/menu experience and panel integration.
</div>


== Commands ==


== MatchZy Commands ==
<div class="ck-lead">
Find all currently available commands to easily manage your [[CS2]] server.  
Find all important commands for training, scrims and matches on your [[CS2]] server.
</div>


===Custom Commands===
<div class="ck-command-nav">
{| class="wikitable" width="750"
[[MatchZy#Custom Commands|Custom Commands]] • [[MatchZy#Practice Mode Commands|Practice Mode Commands]] • [[MatchZy#Admin Commands|Admin Commands]]
</div>
 
<div class="ck-callout">
<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>
 
{{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 ===
 
<div class="ck-callout">
<b>Use these during normal scrims / matches.</b>
</div>
 
{| class="wikitable"
|-
|-
!Commands!!Description
! style="width: 175px;" | Command
! style="width: 600px;" | Description
|-
|-
|!help||Lists the most important available commands. ([[CKRAS BOT]])
| !help || Lists the most important available commands. (see: [[CKRAS BOT]])
|-
|-
|!ready||Marks the player ready
| !ready || Marks the player ready (Alias: <span style="color:#096AB7">!r</span>)
|-
|-
|!unready
| !unready || Marks the player unready (Alias: <span style="color:#096AB7">!ur, !notready</span>)
| Marks the player unready
|-
|-
|!pause||Pauses the match in freezetime (Tactical or normal pause, depends on ''matchzy_use_pause_command_for_tactical_pause''
| !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  
| !tech || Pauses the match in freezetime.
|Pauses the match in freezetime.
|-
|-
|!unpause
| !unpause || Requests match unpause. Both teams need to type <code>.unpause</code> to continue. (Alias: <span style="color:#096AB7">!up</span>)
|Request for unpausing the match. Both teams need to type .unpause to unpause the match
|-
|-
|!stay
| !stay || Stay on the same side after the knife round.
|Stays on the same side (For knife winner, after the knife round)
|-
|-
|!switch !swap
| <nowiki>!switch | !swap</nowiki> || Switches the side after the knife round.
|Switches the side (For knife winner, after the knife round)
|-
|-
|!stop
| !stop || Restores the backup of the current round. Both teams need to type <code>!stop</code>.
|Restore the backup of the current round (Both teams need to type !stop to restore the current round)
|-
|-
|!tac
| !tac || Starts a tactical timeout.
|Starts a tactical timeout
|-
|-
|!coach <side>||Starts coaching the specified side <ct|Starts coaching on the specified side <ct|t>
| <nowiki>!coach <ct|t></nowiki> || Starts coaching the specified side. Example: <code>!coach t</code>
Example: '''!coach t''', to start coaching as a terrorist
|-
|-
|!uncoach
| !uncoach || Removes coach status.
|Removes Coach
|}
|}


<div class="ck-callout ck-callout--ok">
<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>


===Practice Mode Commands===
{| class="wikitable"
>> [[MatchZy#ADD%20Admin%20(become%20Admin)|Assign admin]] <<
|-
{| class="wikitable" width="750"
! style="width: 175px;" | Command
! style="width: 600px;" | Description
|-
| !spawn &lt;number&gt; || Spawns to the provided competitive spawn number of the same team
|-
| !ctspawn &lt;number&gt; || Spawns to the provided competitive spawn number of CT (Alias: <span style="color:#096AB7">!cts</span>)
|-
| !tspawn &lt;number&gt; || Spawns to the provided competitive spawn number of T (Alias: <span style="color:#096AB7">!ts</span>)
|-
|-
!Commands!!Description
| !bestspawn || Teleports you to your team’s closest spawn from your current position
|-
|-
|!spawn <number>||Spawns to the provided competitive spawn number of same team
| !worstspawn || Teleports you to your team’s furthest spawn from your current position
|-
|-
|!ctspawn <number>||Spawns to the provided competitive spawn number of CT
| !bestctspawn || Teleports you to CT team’s closest spawn from your current position
|-
|-
|!tspawn <number>
| !worstctspawn || Teleports you to CT team’s furthest spawn from your current position
| Spawns to the provided competitive spawn number of T
|-
|-
|!bot||Adds a bot on user's current position
| !besttspawn || Teleports you to T team’s closest spawn from your current position
|-
|-
|!nobots
| !worsttspawn || Teleports you to T team’s furthest spawn from your current position
|Removes all the bots
|-
|-
|!crouchbot
| !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>)
|Adds a crouched bot on user's current position
|-
|-
|!boost
| !hidespawns || Removes competitive spawns in prac mode
|Adds a bot on current position and boosts player on it
|-
|-
|!crouchboost
| !solid || Toggle solid teammates on/off
|Adds a crouched bot on current position and boosts player on it
|-
|-
|!ct / !t / !spec
| !impacts || Toggle bullet impacts on/off
|Changes player team to the requested team
|-
|-
|!watchme / !fas
| !traj || Toggle grenade trajectories on/off (Alias: <span style="color:#096AB7">!pip</span>)
|Forces all players into spectator except the player <u>who</u> called this command.
|-
|-
|!nade '''(<span style="color:#EE1289">NEW</span>)'''
| !bot || Adds a bot on the user’s current position
|<u>Displays an extra menu</u> with all commands for nades only (alias: !nades)
|-
|-
| colspan="2" |'''Nade Commands:'''
| !nobots || Removes all bots
|-
|-
|!rethrow
| !cbot || Adds a crouched bot on the user’s current position (Alias: <span style="color:#096AB7">!crouchbot</span>)
|command will rethrow the exact same last smoke, flash, molly or HE <u>you</u> threw.
|-
|-
|!last
| !boost || Adds a bot on the current position and boosts the player on it
|command which teleports the player to the last thrown grenade position
|-
|-
|!timer
| !crouchboost || Adds a crouched bot and boosts the player on it
|command which starts a timer immediately and ''stops'' it when you type ''!timer again'', telling you the duration of time
|-
|-
|!back <number>
| !ct / !t / !spec || Changes the player to the requested team
|command which teleports you back to the provided position in your grenade history
|-
|-
|!throwindex <index> <optional index> ''<optional index>''
| !watchme / !fas || Forces all players into spectator except the player who called this command
|Command which throws grenade of provided position(s) from your grenade thrown history. Example: <code>!throwindex 1 2</code> will throw your 1st and 2nd grenade. <code>!throwindex 4 5 8 9</code> will throw your 4th, 5th, 8th and 9th grenade (If you've added delay in grenades, they'll be thrown with their specific delay).
|-
|-
|!delay <delay_in_seconds>  
| !fastforward || Fast-forwards server time to 20 seconds (Alias: <span style="color:#096AB7">!ff</span>)
|command which sets a delay on your last grenade.
This is only used when using ''!rethrow'' or ''!throwindex''
|-
|-
|!lastindex
| !dryrun || Turns on dry-run mode (Alias: <span style="color:#096AB7">!dry</span>)
|command which prints index (position) number of your last thrown grenade.
|-
|-
|!rethrowsmoke
| !god || Turns on god mode
<nowiki>!rethrownade </nowiki>
|-
 
| !break || Breaks all breakable entities (glass windows, wooden doors, vents, etc.)
<nowiki>!rethrowflash </nowiki>
|-
 
| !noclip || Activates / deactivates noclip mode
<nowiki>!rethrowmolotov </nowiki>
|-
 
| !nade || Displays the nade menu if [[CKRAS BOT]] is enabled (Alias: <span style="color:#096AB7">!nades</span>)
<nowiki>!rethrowdecoy </nowiki>
|-
|Added grenade-specific rethrow commands for every grenade type (!nade = Nade Menu)
| colspan="2" |
|-
| colspan="2" | '''Nade Commands (!nade):'''
|-
| !throw || Rethrows the exact same last grenade you threw (Alias: <span style="color:#096AB7">!rethrow</span>)
|-
| !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 <code>!timer</code> again
|-
| !back || Teleports you back to the last recorded grenade position
|-
|-
|!clear||Clears all the active smokes, molotoves and incendiaries
| !back &lt;number&gt; || Teleports you back to the selected grenade history position
|-
|-
|!noflash
| !throwindex &lt;index&gt; || Throws grenade(s) from your grenade history
|Toggles immunity for flashbang (it will still blind others with noflash disabled)
|-
|-
|!savenade <name> ''<optional description>''
| !delay &lt;delay_in_seconds&gt; || Sets a delay on your last grenade
|Saves a lineup
|-
|-
|!loadnade <name>
| !lastindex || Prints the index number of your last thrown grenade
|Loads a lineup
|-
|-
|.delnade <name>
| !rethrowsmoke / !rethrownade / !rethrowflash / !rethrowmolotov / !rethrowdecoy || Grenade-specific rethrow commands
|Deletes a lineup from file (alias !deletenade)
|-
|-
|.importnade <nowiki><code></nowiki>
| !clear || Clears active smokes, molotovs and incendiaries
|Upon saving a lineup a code will be printed to chat, alternatively those can be retrieved from the ''savednades.cfg''
|-
|-
|.listnades <optional filter>
| !noblind || Toggles flashbang immunity (Alias: <span style="color:#096AB7">!noflash</span>)
|Lists either all saved lineups ever or if given a filter only those that match the filter
|-
|-
|.globalnades
| !savenade &lt;name&gt; || Saves a lineup (Alias: <span style="color:#096AB7">!sn</span>)
|With .globalnades you can store your nades on the server for everyone to see.
|-
|-
| colspan="2" |'''more Practice Commands'''
| !loadnade &lt;name&gt; || Loads a lineup (Alias: <span style="color:#096AB7">!ln</span>)
|-
|-
|!fastforward
| !delnade &lt;name&gt; || Deletes a lineup (Alias: <span style="color:#096AB7">!deletenade, !dn</span>)
|Fastforwards the server time to 20 seconds (Alias !ff)
|-
|-
|!dryrun
| !importnade || Prints an import code to chat after saving
|Turns on dry-run mode
|-
|-
|!god
| !listnades || Lists saved lineups (Alias: <span style="color:#096AB7">!lin</span>)
|Turns on god mode
|-
|-
|!break
| !globalnades || Stores nades globally on the server (Alias: <span style="color:#096AB7">!save_nades_as_global</span>)
|Breaks all the breakable entities (glass windows, wooden doors, vents, etc)  
|}
|}


<div class="ck-callout">
<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>
=== Admin Commands ===
<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>


===[[MatchZy#ADD Admin (become Admin)|Admin]] Commands===
{| class="wikitable"
>> [[MatchZy#ADD Admin (become Admin)|Assign admin]] <<
|-
{| class="wikitable" width="750"
! style="width: 175px;" | Command
! style="width: 600px;" | Description
|-
|-
!Commands!!Description
| !restart || Force restarts / resets a match (Alias: <span style="color:#096AB7">!rr</span>)
|-
|-
|!help||Lists the most important available commands.
| !scrim or !start || Force starts a match (Alias: <span style="color:#096AB7">!forcestart</span>, <span style="color:#096AB7">!force</span>)
|-
|-
|'''!restart'''|| Restarts the server after a couple of seconds (<s>Alias: !rr</s>)   | Force restarts/'''resets''' a match
| !endmatch || Force ends a match (Alias: <span style="color:#096AB7">!forceend</span>)
|-
|-
|!rcon <command>
| !prac || Starts prac mode (Alias: <span style="color:#096AB7">!tactics</span>)
| RCON Commands - Example: "''!rcon say test''" -> [https://wiki-en.ckras.com/wiki/index.php?title=CS2#RCON_Commands RCON Commands]
|-
|-
|!start||Force <u>starts</u> a <u>match</u>.
| !exit || Exits practice mode and loads match mode (Alias: <span style="color:#096AB7">!exitprac</span>)
|-
|-
|!forcepause
| !map &lt;name&gt; || Switches to the desired map
|Pauses the match as an admin (Players cannot unpause the admin-paused match).
(Alias !fp)
|-
|-
|!forceunpause
| !forcepause || Pauses the match as admin (Alias: <span style="color:#096AB7">!fp</span>)
|Force unpauses the match. (Alias: !fup)
|-
|-
|!prac
| !forceunpause || Force unpauses the match (Alias: <span style="color:#096AB7">!fup</span>)
|Starts the '''<span style="color:#EE1289">Prac Mode</span>'''<nowiki> | Train (</nowiki>[[MatchZy#Practice Mode Commands|Practice cmds. above]])
|-
|-
|!exitprac
| !restore &lt;round&gt; || Restore / backup a round
|'''Exits''' from <u>practice mode</u> and loads ''Match mode''.
|-
|-
|!restore <round>
| !rcon &lt;command&gt; || Sends RCON commands
|Restore a Round with (!restore 8 = 8 round)
|-
|-
|!map <name>||Switches to the desired map e.g. "''!map de_dust2"''
| !skipveto || Skips the current veto phase (Alias: <span style="color:#096AB7">!sv</span>)
|-
|-
|!skipveto
| !roundknife || Toggles knife round (Alias: <span style="color:#096AB7">!rk</span>)
|Skips the current veto phase. (Alias: !sv)
|-
|-
|!tvrecord
| !playout || Toggles playout (useful in scrim)
|Start a demo on your [[CSTV]] Server (alias !startrecord !record)
''NOTE'': [[CSTV]] - [[CSTV#TV%20PORT|Port]] (tv_enable 1 must be set in the [https://wiki-en.ckras.com/wiki/index.php?title=Webinterface#Config_.2F.2F_Server.cfg_edit server.cfg])
|-
|-
|!tvstop
| !tvrecord || Starts a demo manually (see [[CSTV]])
|Stops a demo on your [[CSTV]] server (alias !stoprecord, !stoptv, !stop)
|-
|-
|!roundknife
| !tvstop || Stops a demo (Alias: <span style="color:#096AB7">!stoprecord, !stoptv</span>)
|Toggles the knife round. If disabled, match will directly go from Warmup phase to Live phase.
(Alias: !rk)
|-
|-
|!playout
| !whitelist || Toggles whitelisting (<code>cfg/MatchZy/whitelist.cfg</code>)
|Toggles playout (If playout is enabled, all rounds would be played irrespective of winner. Useful in !scrim)
|-
|-
|!whitelist
| !readyrequired &lt;number&gt; || Sets required ready players
|Toggles whitelisting of players. To whitelist a player, add the steam64id insteam64id in <u>cfg/MatchZy/whitelist.cfg</u> ([https://wiki-en.ckras.com/wiki/index.php?title=CS2#FTP_Installation FTP])
|-
|-
|!readyrequired <number>
| !settings || Displays current settings
|Sets the number of ready players required to start the match. If set to 0, all connected players will have to ready-up to start the match.
|-
|-
|!settings
| !asay &lt;message&gt; || Say as admin in all chat
|Displays the current setting, like whether knife is enabled or not, value of readyrequired  players, etc.
|-
|-
|!asay <message>
| !reload_admins || Reloads admins from <code>admins.json</code>
|Say as an admin in all chat
|-
|-
|!reload_admins
| !reloadmap || Reloads the current map (Alias: <span style="color:#096AB7">!rmap</span>)
|Reloads admins from admins.json (via [https://wiki-en.ckras.com/wiki/index.php?title=CS2#FTP_Installation FTP] editable)  
|-
|-
|!team1 <name>
| !team1 &lt;name&gt; || Sets Team 1 name
|Sets name for Team 1 (CT by default)
|-
|-
|!team2 <name>
| !team2 &lt;name&gt; || Sets Team 2 name
|Sets name for Team 1 (CT by default)
|}
|}


''Note: Any command can be entered with <span style="color:#EE1289">'''.'''</span>'''help''' or <span style="color:#EE1289">'''!'''</span>'''help'''''
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.


If you have any suggestions for additional features, please let us know: support@ckras.com
<div class="ck-callout ck-callout--amber">
== Install MatchZy ==
'''Note:''' MatchZy is preinstalled on all our [[CS2]] gameservers.
MatchZy requires [[Metamod]] for installation, you can easily install MM in the [https://iface.ckras.com webinterface], then you can click on Install MatchZy and restart the server once. Now you just have to assign [[MatchZy#ADD Admin (become Admin)|admins]] for the beginning, see more in the [[MatchZy#ADD Admin (become Admin)|next step]].
</div>


[[File:Matchzy.png|alt=MatchZy easy Manage for Scrim, Pracc, Pug with Nades Save and more|350x350px]]
<div class="ck-step-grid">


''<small>MatchZy is not compatible with [[Coach]]-Addon or CS2 Scrim (COACH outdated 12.February 2024). We recommend to use <u>only MatchZy</u> in the future, because in addition to the pure !coach <ct|t> function, features such as !spawn, !noflash, !clear, !rethrow, !nade and many more are available with MatchZy, see the commands in detail [[MatchZy#MatchZy Commands|above in this wiki]].</small>''
<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>


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


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


</div>


<div class="ck-callout">
<b>Tip:</b> To use all admin commands, assign admins in the panel afterwards. See [[MatchZy#Become Admin|Become Admin]].
</div>


'''You need Support? Join [https://discord.gg/gWaPQhSDsY Discord]:'''
'''You need Support? Join [https://discord.gg/gWaPQhSDsY Discord]:'''
[[File:Discord.png|alt=Discord|50x50px|link=https://discord.gg/gWaPQhSDsY]]
[[File:Discord.png|alt=Discord|50x50px|link=https://discord.gg/gWaPQhSDsY]]


== MatchZy Options ==


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


== ADD Admin (become Admin) ==
[[File:Matchzy-options-new.png|alt=MatchZy Options|750x750px|link=]]
You can become a MatchZy [https://wiki-en.ckras.com/wiki/index.php?title=CKRAS_BOT#Add_Admin admin] by adding yourself as an [https://wiki-en.ckras.com/wiki/index.php?title=CKRAS_BOT#Add_Admin admin] at [[CKRAS BOT]], see here how you can do this: [https://wiki-en.ckras.com/wiki/index.php?title=CKRAS_BOT#Add_Admin become admin]
 
[[File:Add-admin.png|alt=ADD ADMIN (CKRAS BOT)]] 
 
Example Webpanel  - here you can add your Steam ID3 or SteamID64
 
[[File:CKRAS BOT ADMIN ASSIGN.png|alt=CKRAS BOT ADMIN (Example)|500x500px]]
 
''<small>[Example: HOW TO ADD ADMINS IN THE PANEL]</small>''
 
The <u>admin.json</u> can also be edited manually, you will find it on your FTP in the folder: <u>/cs2/game/csgo/addons/counterstrikesharp/configs</u>
 
<code>If you have already added admins to the [[CKRAS BOT]], you can skip this step as we have automatically added you as an admin to the server.</code>
 
 
 
''>> <u>Note</u>: MatchZy offers a variety of different admin options (root, map, prac, chat...), you can see them for yourself in [https://shobhit-pathak.github.io/MatchZy/configuration/#creating-admins their WIKI]. << We recommand to use our '''CKRAS BOT ADD ADMIN''' because its [[CKRAS BOT#Add Admin|fully integrated]].''
 
 
 
==== Disable Admin Function ====
 
 
 
The admin query (requirement) can also be switched off in config.cfg (folder: /cs2/game/csgo/cfg/MatchZy).
 
To do this, insert and change this value.<blockquote>matchzy_everyone_is_admin '''<true or false>''' </blockquote>
 
* <u>true</u> everyone is admin
* <u>false</u> only admins added in the admin.json or added via ''[[MatchZy#ADD Admin (become Admin)|ADD ADMIN]]'' can execute cmds
 
 
 
 


''TIPP'': To use <u>bindings</u> for [[MatchZy#MatchZy Commands|cmds]] you can use the following example.
<div class="ck-feature-list">
<span class="ck-feature-pill">Knife Round</span>
<span class="ck-feature-pill">Every player is admin</span>
<span class="ck-feature-pill">Smoke Color</span>
<span class="ck-feature-pill">Playout</span>
<span class="ck-feature-pill">Prac / Tactic mode</span>
<span class="ck-feature-pill">Damage Output</span>
<span class="ck-feature-pill">Auto Record</span>
</div>


<code>'''bind <key> css_rcon''' '''''sv_rethrow_last_grenade'''''</code>
[[File:Color-smokes.jpg|alt=Color Smokes in Prac Mode|750x750px|link=]]


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


<span id="ADD_Admin_(become_Admin)">&#8203;</span>
== 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]


== Configuring Warmup/Knife/Live/Prac CFGs ==
''<u>Note:</u> The CKRAS Bot does not need to be activated for adding admins.''


If you want to integrate your own configs into MatchZy or edit the existing files, we will show you below what you need to do.
<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>


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


<u>Advanced:</u>  
<div class="ck-step-card">
<div class="ck-step-top">
<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>


You can edit the Configs from the Plugin, inside '''csgo/cfg/MatchZy ([https://wiki-en.ckras.com/wiki/index.php?title=CS2#FTP_Installation FTP])''', files named '''''warmup.cfg, knife.cfg, live.cfg'' and prac.cfg''' 
</div>


These configs are executed when Warmup, Knife, Live and Practice Mode is started respectively.
<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>


''You can modify these files according to your requirements.''
== Advanced Configuration ==


If these configs are not found in the expected location, MatchZy/[[CKRAS BOT]] executes the default configs which are present in the code.
<div class="ck-lead">
Advanced setup for MatchZy, including config files, whitelist, coach spawns and language settings.
</div>


<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>
Edit the main MatchZy configuration files here:
<ul>
<li><code>warmup.cfg</code></li>
<li><code>knife.cfg</code></li>
<li><code>live.cfg</code></li>
<li><code>prac.cfg</code></li>
</ul>
</div>


=== Whitelisting players ===
<div class="ck-mini-card">
You can add Players to a whitliste, please login to your ftp in navigate to the folder '''csgo/cfg/MatchZy ([https://wiki-en.ckras.com/wiki/index.php?title=CS2#FTP_Installation FTP])''', there will be a file called '''whitelist.cfg'''. You can add Steam64 id of whitelisted players like mentioned in the below example:
<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.
<div class="ck-pathbox"><code>76561198154367261</code></div>
</div>


<code>76561198154367261</code>
<div class="ck-mini-card">
<div class="ck-mini-title">Custom Coach Spawns</div>
<div class="ck-pathbox"><code>addons/counterstrikesharp/plugins/MatchZy/spawns/coach/&lt;map_name&gt;.json</code></div>
Use this file to define custom coach spawn positions per map.
</div>


<code>steamid2</code>
<div class="ck-mini-card">
<div class="ck-mini-title">Language</div>
<div class="ck-pathbox"><code>/csgo/addons/counterstrikesharp/configs/core.json</code></div>
Available languages: <b>DE, EN, FR, PT, RU, UZ, HU, JP</b>
</div>


<code>steamid3</code>
</div>


== Integrations and Recording ==


<div class="ck-lead">
Optional integrations, stats and recording related features.
</div>


== MatchZy with [[CKRAS BOT]] ==
<div class="ck-section-grid">
We have adapted our [[CKRAS BOT]] for this plugin (!help)


Now you can easily add admins in the panel as described [[MatchZy#ADD Admin (become Admin)|above]] and the most common commands are displayed (!help) via our CKRAS BOT.
<div class="ck-mini-card">
<div class="ck-mini-title">Database & Stats</div>
Setup [[Database]] in the CKRAS panel to use MatchZy Stats.<br><br>
[https://shobhit-pathak.github.io/MatchZy/database_stats/ Official MatchZy stats guide]
</div>


[[File:CKRAS BOT MatchZy .png|alt=CKRAS BOT MatchZy |500x500px]]
<div class="ck-mini-card">
<div class="ck-mini-title">Demos / CSTV</div>
MatchZy records demos automatically. Make sure [[CSTV]] is activated.
</div>


<u>(Screenshot [[CKRAS BOT]] !help output in Chat, by Default available)</u>
<div class="ck-mini-card">
<div class="ck-mini-title">CS2 Battle Discord Bot</div>
[https://github.com/Qwizi/cs2-battle-bot GitHub Repository]
</div>


<u>TIPP</u>: Demos are recorded automatically (tv_enable 1 needed in server.cfg) but you can start demos via Chat CMDs aswell
<div class="ck-mini-card">
<div class="ck-mini-title">Workshop</div>
[[Workshop|Workshop Guide]]
</div>


For [[CSTV|CSTV demo]] we added the Commands !tvrecord (alias: !record) !tvstop to start/stop a [[CS2]] Demo (please get sure that '''tv_enable 1''' is set in your [[Webinterface#Config .2F.2F Server.cfg edit|server.cfg]]), the demo is stored in the default ftp-folder: '''/cs2/game/csgo.'''
</div>


We install [[CounterStrikeSharp]] automatically when you install MatchZy, and we also install the latest versions of CSS automatically at regular intervals.
== Support and Recovery ==


<div class="ck-lead">
Everything related to restore, in-game help, binds and support contact.
</div>


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


<div class="ck-mini-card">
<div class="ck-mini-title">Backup / Restore</div>
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>.
</div>


'''You need Support? Join [https://discord.gg/gWaPQhSDsY Discord]:'''
<div class="ck-mini-card">
<div class="ck-mini-title">Useful Bindings</div>
<div class="ck-pathbox"><code>bind &lt;key&gt; css_rcon "sv_rethrow_last_grenade"</code></div>
<div class="ck-pathbox"><code>bind &lt;key&gt; say .clear</code></div>
</div>


[[File:Discord.png|alt=Discord|50x50px|link=https://discord.gg/gWaPQhSDsY]]
<div class="ck-mini-card">
<div class="ck-mini-title">Help & Support</div>
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]
</div>


</div>


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


[https://www.ckras.com/en/ '''<big>Order here your CS2 Gameserver</big>''']
[[PreFire]] | [[Retakes]] | [[Deathmatch]]
[[index.php?title=Category:CS2]]


[[Category:CS2]]
</div>

Latest revision as of 11:41, 10 March 2026


MatchZy for CS2

MatchZy is a CS2 plugin for managing Practice, PUGs, Scrims, and Matches on CKRAS servers.
Quick Start: Type !help or .help in-game to view commands.

▶ 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: 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. Admins can also be added or removed easily through the panel.

Note: Even without CKRAS BOT, MatchZy works via in-game commands (!help/.help, etc.). CKRAS BOT mainly improves the help/menu experience and panel integration.

Commands

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

Custom Commands • Practice Mode Commands • Admin Commands

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

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 index.php?title=Category:CS2

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