MatchZy: Difference between revisions

From CKRAS Wiki

No edit summary
 
(366 intermediate revisions by the same user not shown)
Line 1: Line 1:
__NOTOC__
{{#seo:
{{#seo:
|title=Scrim/Pracc Plugin 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
|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, praccs, coaches on your CS2 server. In this WIKI we show you how to install MatchZy on 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/Pracc 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]] (Counterstrike 2) to run and manage '''Practice/Pugs/Scrims/Matches/Coach''' with easy configuration. Here we explain how easy you can install this plugin on your [https://www.ckras.com/en/ CKRAS] server.
<div class="ck-page">
 
<div class="ck-hero ck-hero--dark">
  <div class="ck-hero-inner">
 
    <div class="ck-hero-logo">
      [[File:MATCHZY - CS2 Plugin.png|110px|alt=MatchZy - CS2 Plugin|link=MatchZy]]
    </div>
 
    <div class="ck-hero-content">
      <div class="ck-hero-title">MatchZy for CS2</div>
 
      <div class="ck-hero-sub">
        Practice • PUGs • Scrims (Multiple Coaches) • Matches • Wingman — fully integrated on CKRAS
      </div>
 
      <div class="ck-hero-meta">
        <b>Quick Start:</b> Type <code>!help</code> or <code>.help</code> in-game to view commands.
      </div>


[[File:MATCHZY - CS2 Plugin.png|alt=MATCHZY - CS2 Plugin|125x125px]]
      <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://wiki.ckras.com/wiki/index.php?title=MatchZy_Deutsch <span class="ck-btn ck-btn-ghost">Deutsch 🇩🇪</span>]
      </div>
    </div>


== Install MatchZy at CKRAS PANEL ==
  </div>
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 MatchZy|admins]] for the beginning, see more in the [[MatchZy#ADD Admin MatchZy|next step]].
</div>


''MatchZy is not compatible with our [[Coach|COACH]] plugin, you have to deactivate it first. However, MatchZy also offers you the option to use [[Coach]] (see commands below) and many other functions such as Spawns, NoFlash, Clear and more.''
[[File:Matchzygaming.png|right|240px|alt=MatchZy for CS2 Gameserver|link=]]


[[File:Matchzy.png|alt=MatchZy easy Manage for Scrim, Pracc, Pug with Nades Save and more|500x500px]]
<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>


== ADD Admin MatchZy ==
<div class="ck-jump">
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]], but only a [https://wiki-en.ckras.com/wiki/index.php?title=CKRAS_BOT#Add_Admin full admin] option is available here.  MatchZy offers a variety of different options here, you can see them for yourself in [https://shobhit-pathak.github.io/MatchZy/configuration/#creating-admins their WIKI].
<b>Jump to:</b> [[#MatchZy_Commands|Commands]] • [[#Install_MatchZy|Install]] • [[#MatchZy_Options|Options]] • [[#ADD_Admin_(become_Admin)|Add Admin]]
</div>


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>
<div class="ck-tocbox">
<div class="ck-toc-title">On this page</div>
* [[#Why_MatchZy_&_CKRAS_BOT|Why MatchZy & CKRAS BOT]]
* [[#MatchZy_Commands|MatchZy Commands]]
** [[#Custom_Commands|Custom Commands]]
** [[#Practice_Mode_Commands|Practice Mode Commands]]
** [[#Admin_Commands|Admin Commands]]
* [[#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>


<code>If you have already added admins to the [[CKRAS BOT]], you can skip this step as we have automatically done this for you.</code>
----
 
== Why MatchZy & CKRAS BOT ==
 
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-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 primarily improves the help/menu experience and panel integration.
</div>


== MatchZy Commands ==
== MatchZy Commands ==
Here you will find all available commands to manage your [[CS2]] gameserver with MatchZy.
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'''}}
 
===<big>Custom Commands</big>===


===Custom Commands===
{| class="wikitable"
{| class="wikitable" width="750"
|-
|-
!Commands!!Description
! style="width: 175px;" | Commands
! style="width: 600px;" | Description
|-
|-
|!help||Lists the most important available commands.
| !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 <code>matchzy_use_pause_command_for_tactical_pause</code>.
| !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>)
|-
|-
|!tech  
| !tech || Pauses the match in freezetime.
|Pauses the match in freezetime.
|-
|-
|!unpause
| !unpause || Request for unpausing the match. Both teams need to type .unpause to unpause the match (Alias: <span style="color:#096AB7">!up</span>)
|Request for unpausing the match. Both teams need to type .unpause to unpause the match
|-
|-
|!stay
| !stay || Stays on the same side (For knife winner, 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 (For knife winner, after the knife round)
|Switches the side (For knife winner, after the knife round)
|-
|-
|!stop
| !stop || ''Restore the backup'' of the current round (Both teams need to type !stop to restore the current round)
|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.
| <nowiki>!coach <ct|t></nowiki> || Starts coaching the specified side
Example: '''!coach t''', to start coaching terrorist side!
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
| !uncoach || Removes Coach Status
|Removes Coach
|}
|}
<br>


TIPP: To Use <u>Rethrow Last Grenade</u> you can use this command.
===<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>


<code>bind <key> css_rcon sv_rethrow_last_grenade</code>
{| class="wikitable"
 
===Practice Mode Commands===
{| class="wikitable" width="750"
|-
|-
!Commands!!Description
! style="width: 175px;" | Commands
! style="width: 600px;" | Description
|-
|-
|!spawn <number>||Spawns to the provided competitive spawn number of same team
|!spawn <number>||Spawns to the provided competitive spawn number of same team
|-
|-
|!ctspawn <number>||Spawns to the provided competitive spawn number of CT
|!ctspawn <number>||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>''
|-
|!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 ([[:File:Spawns-example.png|example picture]])
<code>>> New you can select spawns with "E" << ''<span style="color:#096AB7">(Alias: !spawns)</span>''</code>
|-
|-
|!tspawn <number>
|!hidespawns||Remove competitive spawns in prac mode
| Spawns to the provided competitive spawn number of T
|-
|!solid||<nowiki>Toogle (on|off) solid teammates</nowiki>
|-
|!impacts||<nowiki>Toogle (on|off) bullet impacts</nowiki>
|-
|!traj||<nowiki>Toggle (on|off) grenade trajectories (Alias: </nowiki><span style="color:#096AB7">!pip</span>)
|-
|-
|!bot||Adds a bot on user's current position
|!bot||Adds a bot on user's current position
|-
|-
|!nobots
|!nobots||Removes all the bots
|Removes all the bots
|-
|!cbot||Adds a crouched bot on user's current position (Alias: <span style="color:#096AB7">!crouchbot</span>)
|-
|!boost||Adds a bot on current position and boosts player on it
|-
|!crouchboost||Adds a crouched bot on current position and boosts player on it
|-
|!ct / !t / !spec||Changes player team to the requested team
|-
|!watchme / !fas||Forces all players into spectator except the player <u>who</u> called this command.
|-
|!fastforward||Fastforwards the 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>)
|-
|!god||Turns on god mode
|-
|!break||Breaks all the 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.
|-
|!nade||<u>Displays an extra menu</u> only with nades cmds [[CKRAS BOT]] turn "on" (Alias: <span style="color:#096AB7">!nades</span>)
|-
| colspan="2" |
|-
| 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>)
|-
|!last||command which teleports the player to the last thrown grenade position
|-
|!autogo <code>new</code>||(soon)
|-
|!drop<code>new</code>||(soon)
|-
|-
|!crouchbot
|!auton <code>new</code>||(soon)
|Adds a crouched bot on user's current position
|-
|-
|!boost
|!autoff <code>new</code>||(soon)
|Adds a bot on current position and boosts player on it
|-
|-
|!crouchboost
|!savepos||command to save your current position and viewangle
|Adds a crouched bot on current position and boosts player on it
|-
|-
|!ct / !t / !spec
|!loadpos||command to load your last saved position & viewangle in .prac mode
|Changes player team to the requested team
|-
|-
|!fas / !watchme
|!timer||command which starts a timer immediately and ''stops'' it when you type ''!timer again'', telling you the duration of time
|Forces all players into spectator except the player who called this command.
|-
|-
|!clear||Clears all the active smokes, molotoves and incendiaries
|!back <code>new</code>||Command which teleports you back to the last recorded grenade position. Specifiy selection !back <number> see next line
|-
|!back <number>||Command which teleports you back to the provided position in your grenade history
|-
|!throwindex <index> <optional index> ''<optional index>''||Command which throws grenade of provided position(s) from your grenade thrown history.
|-
|!delay <delay_in_seconds>||command which sets a delay on your last grenade.
|-
|-
|!fastforward
|!lastindex||command which prints index (position) number of your last thrown grenade.
|Fastforwards the server time to 20 seconds
|-
|-
|!noflash
|!rethrowsmoke
|Toggles immunity for flashbang (it will still blind others with noflash disabled)
<nowiki>!rethrownade</nowiki>
<nowiki>!rethrowflash</nowiki>
<nowiki>!rethrowmolotov</nowiki>
<nowiki>!rethrowdecoy</nowiki>
|Added grenade-specific rethrow commands for every grenade type (''!nade'' = Nade Menu)
|-
|-
|!dryrun
|!clear||Clears all the active smokes, molotoves and incendiaries
|Turns on dry-run mode
|-
|-
|!god
|!noblind||Toggles immunity for flashbang (Alias: <span style="color:#096AB7">!noflash</span>)
|Turns on god mode
|-
|-
|!savenade <name> <optional description>
|!savenade <name> ''<optional description>''||Saves a lineup (Alias: <span style="color:#096AB7">!sn</span>)
|Saves a lineup
|-
|-
|!loadnade <name>
|!loadnade <name>||Loads a lineup (Alias: <span style="color:#096AB7">!ln</span>)
|Loads a lineup
|-
|-
|!deletenade <name>
|!delnade <name>||Deletes a lineup from file (Alias: <span style="color:#096AB7">!deletenade, !dn</span>)
|Deletes a lineup from file
|-
|-
|!importnade <nowiki><code></nowiki>
|!importnade||Upon saving a lineup a code will be printed to chat
|Upon saving a lineup a code will be printed to chat, alternatively those can be retrieved from the ''savednades.cfg''
|-
|-
|!listnades <optionale filter>
|!listnades <optional filter>||Lists either all saved lineups ever or filtered (Alias: <span style="color:#096AB7">!lin</span>)
|Lists either all saved lineups ever or if given a filter only those that match the filter
|-
|-
|!break
|!globalnades||Stores nades global on server (Alias: <span style="color:#096AB7">!save_nades_as_global</span>)
|Breaks all the breakable entities (glass windows, wooden doors, vents, etc)  
|}
|}


{{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>===
>> [[MatchZy#ADD Admin (become Admin)|Assign admin]] <<


===Admin Commands===
{| class="wikitable"
{| class="wikitable" width="750"
|-
|-
!Commands!!Description
! style="width: 175px;" | Commands
! style="width: 600px;" | Description
|-
|-
|!help||Lists the most important available commands.
|!restart||Force restarts/'''resets''' a match (Alias: <span style="color:#096AB7">!rr</span>)
|-
|-
|!restart||Restarts the server after a couple of seconds (<s>Alias: !rr</s>)
|!force or <span style="color:#096AB7">!start</span>||Force <u>starts</u> a <u>match</u>. (Alias: <span style="color:#096AB7">!forcestart</span>)
|-
|-
|!rcon <command>
|!endmatch||Force <u>ends</u> a <u>match</u>. (Alias: <span style="color:#096AB7">!forceend</span>)
| '''RCON Commands''' - Example: !rcon say test - [https://wiki-en.ckras.com/wiki/index.php?title=CS2#RCON_Commands RCON Commands]
|-
|-
|!start||Force starts a match.
|!prac or <span style="color:#096AB7">!tactics</span>||Starts Prac Mode
|-
|-
|!forcepause
|!exitprac||'''Exits''' practice mode and loads match mode
|Pauses the match as an admin (Players cannot unpause the admin-paused match).
(Alias !fp)
|-
|-
|!forceunpause
|!map <name>||Switches to the desired map
|Force unpauses the match. (Alias: !fup)
|-
|-
|!prac
|!forcepause||Pauses the match as an admin (Alias: <span style="color:#096AB7">!fp</span>)
|Starts the Train '''<nowiki>| Pracc</nowiki>''' Modus (<s>Alias:  !training, !pracc, !train</s>)
|-
|-
|!exitprac
|!forceunpause||Force unpauses the match (Alias: <span style="color:#096AB7">!fup</span>)
|Exits from practice mode and loads Match mode. (<s>Alias !exittraining; exitpracc, !exittrain</s>)
|-
|-
|!restore <round>
|!restore <round>||Restore / Backup a round
|Restore a Round with (!restore 8 = 8 round)
|-
|-
|!map <name>||Switches to the desired map e.g. ''!map dust2 or de_dust2''
|!rcon <command>||RCON Commands
|-
|-
|!record
|!skipveto||Skips the current veto phase (Alias: <span style="color:#096AB7">!sv</span>)
|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
|!roundknife||Toggles knife round (Alias: <span style="color:#096AB7">!rk</span>)
|Stops a demo on your [[CSTV]] server (alias !stoprecord, !stoptv, !stop)
|-
|-
|!roundknife
|!playout||Toggles playout (useful in scrim)
|Toggles the knife round. If disabled, match will directly go from Warmup phase to Live phase.
(Alias: !rk)
|-
|-
|!playout
|!tvrecord||Start demo manually (see [[CSTV]])
|Toggles playout (If playout is enabled, all rounds would be played irrespective of winner. Useful in !scrim)
|-
|-
|!whitelist
|!tvstop||Stops a demo (Alias: <span style="color:#096AB7">!stoprecord, !stoptv</span>)
|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)
|!whitelist||Toggles whitelisting (cfg/MatchZy/whitelist.cfg)
|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
|!readyrequired <number>||Sets ready players required
|Displays the current setting, like whether knife is enabled or not, value of readyrequired  players, etc.
|-
|-
|!asay <message>
|!settings||Displays current settings
|Say as an admin in all chat
|-
|-
|!reload_admins
|!asay <message>||Say as an admin in all chat
|Reloads admins from admins.json (via [https://wiki-en.ckras.com/wiki/index.php?title=CS2#FTP_Installation FTP] editable)
|-
|-
|!team1 <name>
|!reload_admins||Reload admins from admins.json
|Sets name for Team 1 (CT by default)
|-
|-
|!team2 <name"
|!reloadmap||Reloads the current map
|Sets name for Team 1 (CT by default)
|-
|!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 ==
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>'''
[[File:Install-metamod.png|alt=install metamod|750x750px|link=]]
=== Activate CSS + MatchZy ===
The following image shows that after activating Metamod, [[CounterStrikeSharp]] (CSS) and MatchZy can now be installed.
'''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]]”.
[[File:Install-matchzy-panel.png|alt=Matchzy Installation|750x750px|link=]]
=== Update MatchZy ===
As a rule, MatchZy '''updates are installed automatically'''. If it is not installed automatically, click "Update" in the [[Webinterface|webpanel]] and restart the server.
[[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]:'''
[[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>).
[[File:Matchzy-options-new.png|alt=MatchZy Options|750x750px|link=]]
<u>MatchZy Options in the CKRAS [[Webinterface]]:</u>
* '''Knife Round'''
* '''Every player is admin'''
* '''Smoke Color'''
* '''Playout'''
* '''Prac/Tactic mode'''
* '''Damage Output'''
* '''Auto Record'''
[[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
== ADD Admin (become Admin) ==
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.''
[[File:Add-admins.png|alt=ADD ADMINS PANEL|link=]]
'''Example Webpanel — add your SteamID64'''
[[File:Add-user-webpanel-bot-admin.png|alt=Add Admin in Panel|750x750px|link=]]
[[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>''
The <u>admin.json</u> can also be edited manually (FTP): <u>/cs2/game/csgo/addons/counterstrikesharp/configs</u>
==== Disable Admin Function ====
Edit in config:
<blockquote>matchzy_everyone_is_admin <true or false></blockquote>


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


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''' 
=== Whitelisting players ===
Edit <code>whitelist.cfg</code> in <code>csgo/cfg/MatchZy</code>.
Example:
<code>76561198154367261</code>


These configs are executed when Warmup, Knife, Live and Practice Mode is started respectively.
=== Custom Coach Spawns ===
Spawns: <code>addons/counterstrikesharp/plugins/MatchZy/spawns/coach/&lt;map_name&gt;.json</code>.


You can modify these files according to your requirements.
=== CS2 Battle Discord Bot ===
https://github.com/Qwizi/cs2-battle-bot


If these configs are not found in the expected location, MatchZy/[[CKRAS BOT]] executes the default configs which are present in the code.
'''Workshop'''
[[Workshop|Workshop Guide]]


=== Whitelisting players ===
== Database ==
Again, inside '''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:  
Setup [[Database]] in the CKRAS panel to use MatchZy Stats.
https://shobhit-pathak.github.io/MatchZy/database_stats/
 
== Change Language ==
Edit <code>/csgo/addons/counterstrikesharp/configs/core.json</code> (FTP).
Available Languages: DE, EN, FR, PT, RU, UZ, HU, JP


<code>76561198154367261</code>
== Demos ==
<u>NOTE</u>: [[Demos]] are recorded automatically with MatchZy — ensure [[CSTV]] is activated.


<code>steamid2</code>
== Backup ==
MatchZy supports backups via .stop / !stop (users) and .restore / !restore (admins).


<code>steamid3</code>
== Display in the Chat !help ==
CKRAS BOT improves help output. MatchZy also works without it.


== MatchZy with [[CKRAS BOT]] ==
=== Bindings ===
We have adapted our [[CKRAS BOT]] for this plugin, so you can easily add admins in the panel as described above and the most common commands are displayed via our CKRAS BOT.
Examples:
<code>bind &lt;key&gt; css_rcon 'sv_rethrow_last_grenade'</code>
<code>bind &lt;key&gt; say .clear</code>


[[File:CKRAS BOT MatchZy .png|alt=CKRAS BOT MatchZy |500x500px]]
=== Feedback / Suggestions ===
Support: support@ckras.com


(Screenshot [[CKRAS BOT]] !help output in Chat, by Default available)
'''You need Support? Join [https://discord.gg/gWaPQhSDsY Discord]:'''
[[File:Discord.png|alt=Discord|50x50px|link=https://discord.gg/gWaPQhSDsY]]


NEW: For [[CSTV|CSTV demo]] we added the Commands !record (alias: !tvrecord) !tvstop to start a [[CS2]] Demo.
[https://www.ckras.com/en/ '''<big>>>> Order here your CS2 Gameserver</big>''']


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


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

Latest revision as of 17:43, 3 March 2026


MatchZy for CS2
       Practice • PUGs • Scrims (Multiple Coaches) • Matches • Wingman — fully integrated on CKRAS
       Quick Start: Type !help or .help in-game to view commands.
MatchZy for CS2 Gameserver

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: CommandsInstallOptionsAdd Admin


Why MatchZy & CKRAS BOT

With CKRAS BOT and MatchZy you can easily manage your CS2 gameserver, no matter if it is a scrim (with coaches) or training (!prac | !tactics), you can train/save your nade lineups for nade practice on your gameserver, add/remove admins easy with our panel. Train with nades !throw (!nades), use !spawns, !timer, !clear, !fastforward and many more commands. (BOT temp not available)

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

MatchZy Commands

Find all currently available commands to easily manage your CS2 server for training, scrim or matches.

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

Custom Commands

Commands 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, depends on matchzy_use_pause_ command_for_tactical_pause) (Alias: !p)
!tech Pauses the match in freezetime.
!unpause Request for unpausing the match. Both teams need to type .unpause to unpause the match (Alias: !up)
!stay Stays on the same side (For knife winner, after the knife round)
!switch | !swap Switches the side (For knife winner, after the knife round)
!stop Restore the backup of the current round (Both teams need to type !stop to restore the current round)
!tac Starts a tactical timeout
!coach <ct|t> Starts coaching the specified side

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 !coach t or ct so that you are correctly assigned after the round)

!uncoach Removes Coach Status


Practice Mode Commands

Note: These following commands are only available if the .prac or !prac mode is active - You can end the !prac mode with .exitprac

Commands Description
!spawn <number> Spawns to the provided competitive spawn number of 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 Remove competitive spawns in prac mode
!solid Toogle (on|off) solid teammates
!impacts Toogle (on|off) bullet impacts
!traj Toggle (on|off) grenade trajectories (Alias: !pip)
!bot Adds a bot on user's current position
!nobots Removes all the bots
!cbot Adds a crouched bot on user's current position (Alias: !crouchbot)
!boost Adds a bot on current position and boosts player on it
!crouchboost Adds a crouched bot on current position and boosts player on it
!ct / !t / !spec Changes player team to the requested team
!watchme / !fas Forces all players into spectator except the player who called this command.
!fastforward Fastforwards the server time to 20 seconds (Alias: !ff)
!dryrun Turns on dry-run mode (Alias: !dry)
!god Turns on god mode
!break Breaks all the 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.
!nade Displays an extra menu only with nades cmds CKRAS BOT turn "on" (Alias: !nades)
Nade Commands (!nade):
!throw command will rethrow the exact same last smoke, flash, molly or HE you threw. (Alias: !rethrow)
!last command which teleports the player to the last thrown grenade position
!autogo new (soon)
!dropnew (soon)
!auton new (soon)
!autoff new (soon)
!savepos command to save your current position and viewangle
!loadpos command to load your last saved position & 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
!back new Command which teleports you back to the last recorded grenade position. Specifiy selection !back <number> see next line
!back <number> Command which teleports you back to the provided position in your grenade history
!throwindex <index> <optional index> <optional index> Command which throws grenade of provided position(s) from your grenade thrown history.
!delay <delay_in_seconds> command which sets a delay on your last grenade.
!lastindex command which prints index (position) number of your last thrown grenade.
!rethrowsmoke

!rethrownade !rethrowflash !rethrowmolotov !rethrowdecoy

Added grenade-specific rethrow commands for every grenade type (!nade = Nade Menu)
!clear Clears all the active smokes, molotoves and incendiaries
!noblind Toggles immunity for flashbang (Alias: !noflash)
!savenade <name> <optional description> Saves a lineup (Alias: !sn)
!loadnade <name> Loads a lineup (Alias: !ln)
!delnade <name> Deletes a lineup from file (Alias: !deletenade, !dn)
!importnade Upon saving a lineup a code will be printed to chat
!listnades <optional filter> Lists either all saved lineups ever or filtered (Alias: !lin)
!globalnades Stores nades global on server (Alias: !save_nades_as_global)
Note: Any command can be entered with .help or !help



Admin Commands

>> Assign admin <<

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


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


NEW: Loading Nades !ln | .ln:
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)

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

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.

Note: MatchZy is already pre-installed on all our gameservers by default.

install metamod

Activate CSS + MatchZy

The following image shows that after activating Metamod, CounterStrikeSharp (CSS) and MatchZy can now be installed.

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 “Become a MatchZy admin”.

Matchzy Installation

Update MatchZy

As a rule, MatchZy updates are installed automatically. If it is not installed automatically, click "Update" in the webpanel and restart the server.

MatchZy How to Update

To update MatchZy, click Update (Version) and the latest update will be installed.

You need Support? Join Discord: Discord

MatchZy Options

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

MatchZy Options

MatchZy Options in the CKRAS Webinterface:

  • 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

ADD Admin (become Admin)

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

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

ADD ADMINS PANEL

Example Webpanel — add your SteamID64

Add Admin in Panel Add Admin Panel Add Admin Panel

[Example Pictures: HOW TO ADD ADMINS IN THE PANEL]

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

Disable Admin Function

Edit in config:

matchzy_everyone_is_admin <true or false>

Configuring Warmup/Knife/Live/Prac CFGs

Advanced: edit configs in /csgo/cfg/MatchZy (FTP). Files: warmup.cfg, knife.cfg, live.cfg, prac.cfg.

Whitelisting players

Edit whitelist.cfg in csgo/cfg/MatchZy. Example: 76561198154367261

Custom Coach Spawns

Spawns: addons/counterstrikesharp/plugins/MatchZy/spawns/coach/<map_name>.json.

CS2 Battle Discord Bot

https://github.com/Qwizi/cs2-battle-bot

Workshop Workshop Guide

Database

Setup Database in the CKRAS panel to use MatchZy Stats. https://shobhit-pathak.github.io/MatchZy/database_stats/

Change Language

Edit /csgo/addons/counterstrikesharp/configs/core.json (FTP). Available Languages: DE, EN, FR, PT, RU, UZ, HU, JP

Demos

NOTE: 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: bind <key> css_rcon 'sv_rethrow_last_grenade' bind <key> say .clear

Feedback / Suggestions

Support: support@ckras.com

You need Support? Join Discord: Discord

>>> Order here your CS2 Gameserver

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