MatchZy: Difference between revisions

From CKRAS Wiki

← Older edit
VisualWikitext
No edit summary
 
(284 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 & 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, 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=MatchZy helps you to run scrims, pracs, matches on your CS2 gameserver. You can use MatchZy with one click installation at 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 on your CS2 gameserver
|image_alt=MatchZy PRO – CS2 scrim and practice plugin for CKRAS servers
}}
}}
[[File:Matchzygaming.png|left|20x20px|MatchZy for CS2 Gameserver - start your Prac/Scrim with easy commands!|link=]]
'''MatchZy''' is a plugin for [[CS2]] gameserver to run and manage '''Practice, Pugs, Scrims, Matches,''' 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. > [https://wiki.ckras.com/wiki/index.php?title=MatchZy Deutsch] [[File:Germany.png|alt=Deutsch|20x20px|link=https://wiki.ckras.com/wiki/index.php?title=MatchZy]]


[[File:MATCHZY - CS2 Plugin.png|alt=MATCHZY - CS2 Plugin|125x125px|link=]]
<div class="ck-page">
 
<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 PRO (CKRAS EDITION)</h1>
<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 explore commands and guides.</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<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]]).&nbsp;&nbsp;
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#Help & Command Guide System|Help System]] • [[MatchZy#Commands|Commands]] • [[MatchZy#Install MatchZy|Install]] • [[MatchZy#MatchZy Options|Options]] • [[MatchZy#Become Admin|Become Admin]] • [[MatchZy#Support and Recovery|Support]]
</div>


== 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, !clear, !fastforward and many [[MatchZy#MatchZy Commands|more commands]].{{warning|1=Manage your Gameserver with easy commands <span style="color:#EE1289">'''!'''</span>'''help'''}}
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]].
 
<div class="ck-callout ck-callout--amber">
<b>Note:</b> MatchZy works fully via in-game commands. You can use <b>!<cmd></b> or <b>.<cmd></b> (e.g., <code>!help</code> or <code>.help</code>).&nbsp;&nbsp;
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.
</div>
 
== Help & Command Guide System ==
 
<div class="ck-callout">
<b><code>NEW</code> MatchZy-PRO Help:</b> Use <code>.help prac</code> or <code>!help prac</code> to display practice commands grouped into categories like Positions, Grenades, Bots and Utility. You can also use <code>.help &lt;command&gt;</code> or <code>!help &lt;command&gt;</code> to get instant help for specific commands directly in-game.
</div>
 
== Commands ==
 
<div class="ck-lead">
Find all important commands for training, scrims and matches on your [[CS2]] server.
</div>
 
<div class="ck-command-nav">
[[MatchZy#Custom Commands|Custom Commands]] • [[MatchZy#Practice Mode Commands|Practice Mode Commands]] • [[MatchZy#Admin Commands|Admin Commands]]
</div>
 
---


== MatchZy Commands ==
=== Custom Commands ===
Find all currently available commands to easily manage your [[CS2]] server.


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


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


===<big>Practice Mode Commands</big>===
<div class="ck-callout ck-callout--ok">
<b>Multiple coaches:</b> If you get the message <code>team is full</code>, join the spectator slot or the other team first and then use <code>!coach t</code> or <code>!coach ct</code> to be assigned correctly.
</div>
 
---
 
=== Practice Mode Commands ===
 
<div class="ck-callout">
<b>Available in practice mode: <code>!prac</code>.</b> Exit with <code>!exit</code>.
</div>
 
==== Spawns & Positions ====
{| class="wikitable"
{| class="wikitable"
|-
|-
! style="width: 175px;" | Commands
! style="width: 200px;" | !<cmd> / .<cmd>
! style="width: 600px;" | Description
! style="width: 600px;" | Description
|-
|-
|!spawn <number>||Spawns to the provided competitive spawn number of same team
| !spawn <nr> || Spawns to the provided competitive spawn number.
|-
|-
|!ctspawn <number>||Spawns to the provided competitive spawn number of CT
| !ctspawn / !tspawn || Spawns to CT or T competitive spawns (Alias: !cts / !ts).
|-
|-
|!tspawn <number>
| !bestspawn || Teleports to your team’s closest competitive spawn.
| Spawns to the provided competitive spawn number of T
|-
|-
|!bot||Adds a bot on user's current position
| !worstspawn || Teleports to your team's furthest spawn.
|-
|-
|!nobots
| !bestctspawn / !worstctspawn || Teleports to the closest / furthest CT spawn.
|Removes all the bots
|-
|-
|!crouchbot
| !besttspawn / !worsttspawn || Teleports to the closest / furthest T spawn.
|Adds a crouched bot on user's current position
|-
|-
|!boost
| !showspawns / !spawns || Shows competitive spawns (Select with "E").
|Adds a bot on current position and boosts player on it
|-
|-
|!crouchboost
| !hidespawns || Removes competitive spawn visuals.
|Adds a crouched bot on current position and boosts player on it
|}
 
==== Bot Control & Movement ====
{| class="wikitable"
|-
|-
|!ct / !t / !spec
! style="width: 200px;" | !<cmd> / .<cmd>
|Changes player team to the requested team
! style="width: 600px;" | Description
|-
|-
|!watchme / !fas
| !bot || Adds a bot on your current position.
|Forces all players into spectator except the player <u>who</u> called this command.
|-
|-
|!fastforward
| !nobots || Removes all bots from the server.
|Fastforwards the server time to 20 seconds (Alias !ff)
|-
|-
|!dryrun
| !cbot / !crouchbot || Adds a crouched bot on your position.
|Turns on dry-run mode
|-
|-
|!god
| !boost || Adds a bot and boosts the player on it.
|Turns on god mode
|-
|-
|!break
| !crouchboost || Adds a crouched bot and boosts the player.
|Breaks all the breakable entities (glass windows, wooden doors, vents, etc)
|-
|-
|!nade '''(<span style="color:#EE1289">NEW</span>)'''
| !ct / !t / !spec || Changes the player to the requested team.
|<u>Displays an extra menu</u> with all commands for nades only (alias: !nades)
|-
|-
| colspan="2" |
| !fas / !watchme || Forces all players into spectator except you.
|-
|-
| colspan="2" |'''Nade Commands (!nade):'''
| !god || Turns on god mode.
|-
|-
|!rethrow
| !noclip || Activates / deactivates noclip mode.
|command will rethrow the exact same last smoke, flash, molly or HE <u>you</u> threw.  
|-
|-
|!last
| !fastforward / !ff || Fast-forwards server time.
|command which teleports the player to the last thrown grenade position
|-
|-
|!timer
| !dryrun / !dry || Turns on dry-run mode.
|command which starts a timer immediately and ''stops'' it when you type ''!timer again'', telling you the duration of time
|-
|-
|!back <number>
| !solid || Toggle solid teammates on/off.
|command which teleports you back to the provided position in your grenade history
|-
|-
|!throwindex <index> <optional index> ''<optional index>''
| !impacts || Toggle bullet impacts on/off.
|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>
| !break || Breaks all breakable entities (glass, vents, etc.)
|command which sets a delay on your last grenade.
|}
This is only used when using ''!rethrow'' or ''!throwindex''
|-
|!lastindex
|command which prints index (position) number of your last thrown grenade.
|-
|!rethrowsmoke
<nowiki>!rethrownade </nowiki>


<nowiki>!rethrowflash </nowiki>
==== Replay & Path Recording (MatchZy PRO) ====


<nowiki>!rethrowmolotov </nowiki>
<div class="ck-callout ck-callout--amber">
<b>MatchZy PRO Feature:</b> Record movement paths and replay them using bots to simulate real player behavior. These commands are only available on CKRAS servers.
</div>


<nowiki>!rethrowdecoy </nowiki>
{| class="wikitable"
|Added grenade-specific rethrow commands for every grenade type (!nade = Nade Menu)
|-
! style="width: 200px;" | Command
! style="width: 600px;" | Description
|-
| !record / !rec <code>new</code>
| Record a movement path. Last 5 paths are kept in a temporary history buffer.
|-
|-
|!clear||Clears all the active smokes, molotoves and incendiaries
| !play [all/num/name] <code>new</code>
| Plays current path, specific buffer Slot (1-5), or <code>all</code> to play everyone simultaneously for execute training!
|-
|-
|!noflash
| !saveplay &lt;name&gt; <code>new</code>
|Toggles immunity for flashbang (it will still blind others with noflash disabled)
| Permanently saves your current recording buffer (''single'' path or ''multiple'' paths for an <u>execute</u>) for the current map.
|-
|-
|!savenade <name> ''<optional description>''
| !loop / !playloop <code>new</code>
|Saves a lineup
| Enables or disables infinite replay looping.
|-
|-
|!loadnade <name>
| !stop <code>new</code>
|Loads a lineup
| Stops active recording or replay (Practice Mode only).
|-
|-
|.delnade <name>
| !clearrec <code>new</code>
|Deletes a lineup from file (alias !deletenade)
| Deletes the current recorded path.
|-
|-
|.importnade <nowiki><code></nowiki>
|!loadplay <name> <code>new</code>
|Upon saving a lineup a code will be printed to chat, alternatively those can be retrieved from the ''savednades.cfg''
|Loads a previously saved path by name (includes smart-matching).
|-
|-
|.listnades <optional filter>
| !listplays <code>new</code>
|Lists either all saved lineups ever or if given a filter only those that match the filter
| Shows all recordings (both the 5-slot temporary buffer and permanent saved plays).
|-
|-
|.globalnades
| !delplay &lt;name&gt; <code>new</code>
|With .globalnades you can store your nades on the server for everyone to see.
| Deletes a saved path recording.
(Alias:  !save_nades_as_global)
|-
|!hud <code>new</code>
|Toggle center-screen HUD and visual menus (Practice status/Help Dashboard) for a cleaner UI.
|}
|}


===<big>Admin Commands</big>===
==== Nade Tools ====
>> [[MatchZy#ADD Admin (become Admin)|Assign admin]] <<
 
{| class="wikitable"
{| class="wikitable"
|-
|-
! style="width: 175px;" | Commands
! style="width: 200px;" | !<cmd> / .<cmd>
! style="width: 600px;" | Description
! style="width: 600px;" | Description
|-
|-
|!help||Lists the most important available commands.
| !throw / !rethrow || Rethrows your last thrown grenade.
|-
|-
|'''!restart'''|| Restarts the server after a couple of seconds (<s>Alias: !rr</s>)    | Force restarts/'''resets''' a match
| !rethrowsmoke || Rethrows your last thrown smoke grenade.
|-
|-
|!rcon <command>
| !rethrownade || Rethrows your last thrown HE grenade.
| 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>.
| !rethrowflash || Rethrows your last thrown flashbang.
|-
|-
|!endmatch
| !rethrowmolotov || Rethrows your last thrown molotov.
|Force <u>ends</u> a <u>match</u>.
|-
|-
|!forcepause
| !rethrowdecoy || Rethrows your last thrown decoy.
|Pauses the match as an admin (Players cannot unpause the admin-paused match).  
(Alias !fp)
|-
|-
|!forceunpause
| !last || Teleports you to the last thrown grenade position.
|Force unpauses the match. (Alias: !fup)
|-
|-
|!prac
| !back <nr> || Teleports you back in your grenade history. <code>!back</code> without number teleports you to last position  <code>new</code>
|Starts the '''<span style="color:#EE1289">Prac Mode</span>'''<nowiki> | Train (</nowiki>[[MatchZy#Practice Mode Commands|Practice cmds. above]])
|-
|-
|!exitprac
| !delay <sek> || Sets a delay for Rethrow/Index commands.
|'''Exits''' from <u>practice mode</u> and loads ''Match mode''.  
|-
|-
|!restore <round>
| !throwindex <idx> || Throws grenade(s) from history (Example: <code>!throwindex 1 2</code>).
|Restore a Round with (!restore 8 = 8 round)
|-
|-
|!map <name>||Switches to the desired map e.g. "''!map de_dust2"''
| !lastindex || Prints the index number of your last thrown grenade.
|-
|-
|!skipveto
|!resetnade / !resetnades <code>new</code>
|Skips the current veto phase. (Alias: !sv)
|Command to reset grenade history in Practice Mode
|-
|-
|!tvrecord
|!autogo <code>new</code>
|MatchZy starts Demos automatically, so no need to start manually!
|Teleports you to the landing position of your thrown smoke or molotov
But if you want to start manually use this cmds !tvrecord (alias !record)
''IMPORTANT'': [[CSTV]] - [[CSTV#TV%20PORT|Port]] (''tv_enable 1'' must be set in any case in the [https://wiki-en.ckras.com/wiki/index.php?title=Webinterface#Config_.2F.2F_Server.cfg_edit server.cfg])
|-
|-
|!tvstop
|!goto <code>new</code>
|Stops a demo on your [[CSTV]] server (alias !stoprecord, !stoptv, !stop)
|Teleport to a specific position index in grenade history.
|-
|-
|!roundknife
|!drop <code>new</code>
|Toggles the knife round. If disabled, match will directly go from Warmup phase to Live phase.
|Drops the player to the ground, fixing potential stuck-in-air issues after noclip.
(Alias: !rk)
|-
|-
|!playout
| !clear || Clears active smokes, molotovs and incendiaries.
|Toggles playout (If playout is enabled, all rounds would be played irrespective of winner. Useful in !scrim)
|-
|-
|!whitelist
| !traj / !pip || Toggle grenade trajectories and preview window.
|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>
| !noflash / !noblind || Toggles flashbang immunity.
|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
| !nade / !nades || Displays the nade menu (requires [[CKRAS BOT]]).
|Displays the current setting, like whether knife is enabled or not, value of readyrequired  players, etc.
|-
|-
|!asay <message>
| !savepos / !loadpos || Saves or loads your current position.
|Say as an admin in all chat
|-
|-
|!reload_admins
| !timer || Starts/stops a movement or smoke timer.
|Reloads admins from admins.json (via [https://wiki-en.ckras.com/wiki/index.php?title=CS2#FTP_Installation FTP] editable)
|-
|-
|!team1 <name>
| !savenade / !sn || Saves a lineup permanently.
|Sets name for Team 1 (CT by default)
|-
|-
|!team2 <name>
| !loadnade / !ln || Loads a saved lineup.
|Sets name for Team 1 (CT by default)
|-
| !delnade / !dn || Deletes a saved lineup.
|-
| !importnade / !in || Imports a lineup from a code.
|-
| !listnades / !lin || Lists saved lineups (optional filter).
|}
|}


---


<br>
=== Admin Commands ===


{{warning|1=Note: Any command can be entered with <span style="color:#EE1289">'''.'''</span>'''help''' or <span style="color:#EE1289">'''!'''</span>'''help'''}}
<div class="ck-callout ck-callout--amber">
<b>Admin required.</b> See [[MatchZy#Become Admin|How to become Admin]] to manage your server.
</div>


If you have any suggestions for additional features, please let us know: support@ckras.com
{| class="wikitable"
|-
! style="width: 200px;" | !<cmd> / .<cmd>
! style="width: 600px;" | Description
|-
| !restart / !rr || Force restarts the match.
|-
| !start / !force || Force starts a match (Alias: !scrim).
|-
| !endmatch / !forceend || Force ends a match. (ALies: !exit)
|-
| !prac / !tactics || Starts practice mode.
|-
| !exit / !exitprac || Exits practice mode + <code>new</code> reset the current match state (warmup) even during a live game
|-
| !map <name> || Switches the map (e.g., <code>!map de_inferno</code>).
|-
|!dm / !deathmatch <code>new</code>
|toggles deathmatch mode during warmup on and off, see [[MatchZy#MatchZy Options|options]]
|-
| !forcepause / !fp || Pauses the match as admin (Players cannot unpause).
|-
| !forceunpause / !fup || Force unpauses the match.
|-
| !restore <round> || Restore a specific backup round.
|-
| !rcon <command> || Sends RCON commands to the server. (alternative via console css_rcon <cmd>
|-
| !roundknife / !rk / !knife <code>new</code>|| Toggles knife round.
|-
| !playout / !clinch <code>new</code>|| Toggles playout (match continues after winner is decided).
|-
|!overtime / !ot <code>new</code>
|Toggles overtime for the match. Overtime is enabled by default in live.cfg.
|-
| !asay <message> || Say as an admin in all chat.
|-
| !reload_admins || Reloads admins from admins.json.
|-
| !team1 / !team2 <name> || Sets name for Team 1 or Team 2.
|-
| !skipveto / !sv || Skips the current veto phase.
|-
| !whitelist || Toggles whitelisting of players.
|-
| !readyrequired <num> || Sets the number of ready players required to start.
|-
| !settings || Displays the current server settings.
|}


== Install MatchZy ==
== Install MatchZy ==
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]].
[[File:Matchzy.png|alt=MatchZy easy Manage for Scrim, Pracc, Pug with Nades Save and more|350x350px|link=]]
''<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>''
'''You need Support? Join [https://discord.gg/gWaPQhSDsY Discord]:'''
[[File:Discord.png|alt=Discord|50x50px|link=https://discord.gg/gWaPQhSDsY]]
== ADD Admin (become Admin) ==
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)|link=]] 
Example Webpanel  - here you can add your Steam ID3 or SteamID64
[[File:CKRAS BOT ADMIN ASSIGN.png|alt=CKRAS BOT ADMIN (Example)|500x500px|link=]]
''<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.
<code>'''bind <key> css_rcon''' '''''sv_rethrow_last_grenade'''''</code>
== Configuring Warmup/Knife/Live/Prac CFGs ==
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.
<u>Advanced:</u>
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''' 
These configs are executed when Warmup, Knife, Live and Practice Mode (!prac) is started respectively.
''You can modify these files according to your requirements.''
If these configs are not found in the expected location, MatchZy/[[CKRAS BOT]] executes the default configs which are present in the code.
=== Whitelisting players ===
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:
<code>76561198154367261</code>


MatchZy requires [[Metamod]]. Install Metamod first in the [[webinterface]], then activate [[CounterStrikeSharp]] and MatchZy.


== Display in the Chat !help ==
<div class="ck-callout ck-callout--amber">
We have adapted our [[CKRAS BOT]] for this plugin (!help)
'''Note:''' MatchZy is preinstalled on all our [[CS2]] gameservers.
</div>


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 & !nade) via our CKRAS BOT.
<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">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>


[[File:CKRAS BOT MatchZy .png|alt=CKRAS BOT MatchZy |500x500px|link=]]
<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>


<u>(Screenshot [[CKRAS BOT]] !help output in Chat, by Default available)</u>
<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 automatic. If not, click <b>Update</b> in the webpanel.</div>
</div>
</div>


== MatchZy Options ==


You can customize settings in the [[Webinterface|webpanel]].


<u>TIPP</u>: Demos are recorded automatically ('''tv_enable 1''' needed in '''server.cfg''') but you can start demos manually via Chat [[MatchZy#MatchZy Commands|CMDs aswell]]
[[File:MatchZy options.png|alt=MatchZy-Pro Options|750x750px]]


<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>
<span class="ck-feature-pill">Autoteleport to Smoke</span>
<span class="ck-feature-pill">Deathmatch during Warmup</span>
</div>


<span id="Become_Admin"></span>


== Become Admin ==


You can become a MatchZy admin by adding yourself in the **CKRAS BOT** section of your panel.


<u>''NOTE:''</u>  
<div class="ck-step-grid">
If you do not want to activate the [[CKRAS BOT]] and do not need the additional HELP Chat menu, you can also deactivate the CKRAS BOT in the webpanel at any time, so the full range of MatchZy functions will still be available to you (expect !nade menu).
<div class="ck-step-card">
<div class="ck-step-top">
<div class="ck-step-num">1</div>
<div class="ck-step-title">Open Admin Management</div>
</div>
<div class="ck-media-frame">[[File:Add-admins.png|450px|alt=Open admin management|link=]]</div>
<div class="ck-step-desc">Click on <b>Add Admin</b> in the CKRAS BOT / MatchZy section.</div>
</div>


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


<u>Additional Information:</u>
<div class="ck-callout">
<b>Note:</b> The <code>admin.json</code> can also be edited manually via FTP if needed: <code>/csgo/addons/counterstrikesharp/configs/admins.json</code>
</div>


For [[CSTV|CSTV demo]] we added the Commands !tvrecord (alias: !record) !tvstop to start/stop a [[CS2]] Demo ([[MatchZy#MatchZy Commands|see commands above]]) (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.'''
== Advanced Configuration ==


We install [[CounterStrikeSharp]] automatically when you install MatchZy, and we also install the latest versions of CSS automatically at regular intervals.  
<div class="ck-section-grid">
<div class="ck-mini-card">
<div class="ck-mini-title">CFG Files</div>
<div class="ck-pathbox"><code>/csgo/cfg/MatchZy</code></div>
Contains <code>warmup.cfg</code>, <code>knife.cfg</code>, <code>live.cfg</code>, <code>deathmatch.cfg</code> and <code>prac.cfg</code>.
</div>


<div class="ck-mini-card">
<div class="ck-mini-title">Player Whitelist</div>
<div class="ck-pathbox"><code>/csgo/cfg/MatchZy/whitelist.cfg</code></div>
Add one SteamID64 per line to restrict access.
</div>


<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>
Change the global plugin language (DE, EN, FR, etc.).
</div>
</div>


== Support and Recovery ==


'''You need Support? Join [https://discord.gg/gWaPQhSDsY Discord]:'''
<div class="ck-section-grid">
<div class="ck-mini-card">
<div class="ck-mini-title">Backup / Restore</div>
Restore the current round with <code>!stop</code>. Admins use <code>!restore <round></code>.
</div>


[[File:Discord.png|alt=Discord|50x50px|link=https://discord.gg/gWaPQhSDsY]]
<div class="ck-mini-card">
<div class="ck-mini-title">Useful Bindings</div>
<div class="ck-pathbox"><code>bind "KEY" "say !rethrow"</code></div>
<div class="ck-pathbox"><code>bind "KEY" "say !clear"</code></div>
</div>


<div class="ck-mini-card">
<div class="ck-mini-title">Help & Support</div>
Support: [mailto:support@ckras.com support@ckras.com]
[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]]


[[Category:CS2]]
</div>
[[index.php?title=Category:CS2]]
[[index.php?title=Category:CS2]]
[[index.php?title=Category:CS2]]

Latest revision as of 14:50, 1 April 2026


MatchZy PRO (CKRAS EDITION)

MatchZy PRO is an extended and modified version of MatchZy, developed and used exclusively on CKRAS CS2 servers for Practice, PUGs, Scrims, and Matches.
Quick Start: Type !help or .help in-game to explore commands and guides.

▶ Start on CKRAS CKRAS Website Play Deutsch 🇩🇪

MatchZy is the only addon you need for your CS2 gameserver to run and manage Practice, PUGs, Scrims (with multiple Coaches), and Matches (supports Wingman).   On CKRAS, MatchZy is fully integrated so you can start right away — including admin management via panel and streamlined in-game usage.

Jump to: Help System • Commands • Install • Options • Become Admin • Support

Why MatchZy & CKRAS BOT

With CKRAS BOT and MatchZy you can easily manage your CS2 gameserver, whether it is a scrim (with coaches) or training (!prac / !tactics). You can train and save nade lineups, use !throw, !spawns, !timer, !clear, !fastforward and many more commands.

Note: MatchZy works fully via in-game commands. You can use !<cmd> or .<cmd> (e.g., !help or .help).   CKRAS BOT enhances the experience by providing a more convenient help and menu system, easier admin management through the panel, and integration for extended features.

Help & Command Guide System

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

Commands

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

Custom Commands • Practice Mode Commands • Admin Commands

---

Custom Commands

Use these during normal scrims / matches.

!<cmd> / .<cmd> Description
!help Lists the most important available commands.
!ready / !r / !rdy Marks the player ready.
!unready / !ur Marks the player unready.
!forceready Force-readies the player's team (JSON/Get5 setups).
!pause / !p Pauses the match in freezetime.
!tech Pauses the match for technical reasons.
!unpause Requests match unpause (both teams needed).
!stay Stay on the same side after the knife round.
!switch / !swap Switches the side after the knife round.
!stop / !restore Restores the backup of the current round (both teams needed).
!tac Starts a tactical timeout.
!coach <side> Starts coaching the specified side. Example: !coach t
!uncoach Removes coach status.

Multiple coaches: If you get the message team is full, join the spectator slot or the other team first and then use !coach t or !coach ct to be assigned correctly.

---

Practice Mode Commands

Available in practice mode: !prac. Exit with !exit.

Spawns & Positions

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

Bot Control & Movement

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

Replay & Path Recording (MatchZy PRO)

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

Command Description
!record / !rec new Record a movement path. Last 5 paths are kept in a temporary history buffer.
!play [all/num/name] new Plays current path, specific buffer Slot (1-5), or all to play everyone simultaneously for execute training!
!saveplay <name> new Permanently saves your current recording buffer (single path or multiple paths for an execute) for the current map.
!loop / !playloop new Enables or disables infinite replay looping.
!stop new Stops active recording or replay (Practice Mode only).
!clearrec new Deletes the current recorded path.
!loadplay <name> new Loads a previously saved path by name (includes smart-matching).
!listplays new Shows all recordings (both the 5-slot temporary buffer and permanent saved plays).
!delplay <name> new Deletes a saved path recording.
!hud new Toggle center-screen HUD and visual menus (Practice status/Help Dashboard) for a cleaner UI.

Nade Tools

!<cmd> / .<cmd> Description
!throw / !rethrow Rethrows your last thrown grenade.
!rethrowsmoke Rethrows your last thrown smoke grenade.
!rethrownade Rethrows your last thrown HE grenade.
!rethrowflash Rethrows your last thrown flashbang.
!rethrowmolotov Rethrows your last thrown molotov.
!rethrowdecoy Rethrows your last thrown decoy.
!last Teleports you to the last thrown grenade position.
!back <nr> Teleports you back in your grenade history. !back without number teleports you to last position new
!delay <sek> Sets a delay for Rethrow/Index commands.
!throwindex <idx> Throws grenade(s) from history (Example: !throwindex 1 2).
!lastindex Prints the index number of your last thrown grenade.
!resetnade / !resetnades new Command to reset grenade history in Practice Mode
!autogo new Teleports you to the landing position of your thrown smoke or molotov
!goto new Teleport to a specific position index in grenade history.
!drop new Drops the player to the ground, fixing potential stuck-in-air issues after noclip.
!clear Clears active smokes, molotovs and incendiaries.
!traj / !pip Toggle grenade trajectories and preview window.
!noflash / !noblind Toggles flashbang immunity.
!nade / !nades Displays the nade menu (requires CKRAS BOT).
!savepos / !loadpos Saves or loads your current position.
!timer Starts/stops a movement or smoke timer.
!savenade / !sn Saves a lineup permanently.
!loadnade / !ln Loads a saved lineup.
!delnade / !dn Deletes a saved lineup.
!importnade / !in Imports a lineup from a code.
!listnades / !lin Lists saved lineups (optional filter).

---

Admin Commands

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

!<cmd> / .<cmd> Description
!restart / !rr Force restarts the match.
!start / !force Force starts a match (Alias: !scrim).
!endmatch / !forceend Force ends a match. (ALies: !exit)
!prac / !tactics Starts practice mode.
!exit / !exitprac Exits practice mode + new reset the current match state (warmup) even during a live game
!map <name> Switches the map (e.g., !map de_inferno).
!dm / !deathmatch new toggles deathmatch mode during warmup on and off, see options
!forcepause / !fp Pauses the match as admin (Players cannot unpause).
!forceunpause / !fup Force unpauses the match.
!restore <round> Restore a specific backup round.
!rcon <command> Sends RCON commands to the server. (alternative via console css_rcon <cmd>
!roundknife / !rk / !knife new Toggles knife round.
!playout / !clinch new Toggles playout (match continues after winner is decided).
!overtime / !ot new Toggles overtime for the match. Overtime is enabled by default in live.cfg.
!asay <message> Say as an admin in all chat.
!reload_admins Reloads admins from admins.json.
!team1 / !team2 <name> Sets name for Team 1 or Team 2.
!skipveto / !sv Skips the current veto phase.
!whitelist Toggles whitelisting of players.
!readyrequired <num> Sets the number of ready players required to start.
!settings Displays the current server settings.

Install MatchZy

MatchZy requires Metamod. Install Metamod first in the webinterface, then activate CounterStrikeSharp and MatchZy.

Note: MatchZy is preinstalled on all our CS2 gameservers.

1
Install Metamod
Install Metamod
Install and activate Metamod in the webinterface first.
2
Activate CSS + MatchZy
Activate CounterStrikeSharp and MatchZy
After Metamod is active, CounterStrikeSharp (CSS) and MatchZy can be installed.
3
Update MatchZy
Update MatchZy
Updates are usually automatic. If not, click Update in the webpanel.

MatchZy Options

You can customize settings in the webpanel.

MatchZy-Pro Options

Knife Round Every player is admin Smoke Color Playout Prac / Tactic mode Damage Output Auto Record Autoteleport to Smoke Deathmatch during Warmup

Become Admin

You can become a MatchZy admin by adding yourself in the **CKRAS BOT** section of your panel.

1
Open Admin Management
Open admin management
Click on Add Admin in the CKRAS BOT / MatchZy section.
2
Add your SteamID64
Add SteamID64 in panel
Enter your SteamID64 and save. The plugin will recognize you instantly.

Note: The admin.json can also be edited manually via FTP if needed: /csgo/addons/counterstrikesharp/configs/admins.json

Advanced Configuration

CFG Files
/csgo/cfg/MatchZy

Contains warmup.cfg, knife.cfg, live.cfg, deathmatch.cfg and prac.cfg.

Player Whitelist
/csgo/cfg/MatchZy/whitelist.cfg

Add one SteamID64 per line to restrict access.

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

Change the global plugin language (DE, EN, FR, etc.).

Support and Recovery

Backup / Restore

Restore the current round with !stop. Admins use !restore <round>.

Useful Bindings
bind "KEY" "say !rethrow"
bind "KEY" "say !clear"
Help & Support

Support: support@ckras.com Join Discord

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

Start on CKRAS Order CS2 Gameserver

PreFire | Retakes | Deathmatch

index.php?title=Category:CS2 index.php?title=Category:CS2 index.php?title=Category:CS2

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