MatchZy: Difference between revisions
| (169 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, matches, bo1, bo3, setup, get5, 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 | |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 | ||
}} | }} | ||
[[File:MATCHZY - CS2 Plugin.png|alt= | <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 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 your [[CS2]] gameserver, | 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 == | |||
<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> | |||
= | <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" | {| class="wikitable" | ||
|- | |- | ||
! style="width: 175px;" | | ! style="width: 175px;" | Command | ||
! style="width: 600px;" | Description | ! style="width: 600px;" | Description | ||
|- | |- | ||
| Line 32: | Line 82: | ||
| !unready || Marks the player unready (Alias: <span style="color:#096AB7">!ur, !notready</span>) | | !unready || Marks the player unready (Alias: <span style="color:#096AB7">!ur, !notready</span>) | ||
|- | |- | ||
| !pause || Pauses the match in freezetime ( | | !pause || Pauses the match in freezetime (tactical or normal pause, depending on <code>matchzy_use_pause_command_for_tactical_pause</code>) (Alias: <span style="color:#096AB7">!p</span>) | ||
|- | |- | ||
| !tech || Pauses the match in freezetime. | | !tech || Pauses the match in freezetime. | ||
|- | |- | ||
| !unpause || | | !unpause || Requests match unpause. Both teams need to type <code>.unpause</code> to continue. (Alias: <span style="color:#096AB7">!up</span>) | ||
|- | |- | ||
| !stay || | | !stay || Stay on the same side after the knife round. | ||
|- | |- | ||
| <nowiki>!switch | !swap</nowiki> || Switches the side | | <nowiki>!switch | !swap</nowiki> || Switches the side after the knife round. | ||
|- | |- | ||
| !stop || | | !stop || Restores the backup of the current round. Both teams need to type <code>!stop</code>. | ||
|- | |- | ||
| !tac || Starts a tactical timeout | | !tac || Starts a tactical timeout. | ||
|- | |- | ||
| <nowiki>!coach <ct|t></nowiki> || Starts coaching the specified side < | | <nowiki>!coach <ct|t></nowiki> || Starts coaching the specified side. Example: <code>!coach t</code> | ||
|- | |- | ||
| !uncoach || Removes | | !uncoach || Removes coach status. | ||
|} | |} | ||
=== | <div class="ck-callout ck-callout--ok"> | ||
<b>Multiple coaches:</b> If you get the message <code>team is full</code>, join the other team first and then use <code>!coach t</code> or <code>!coach ct</code> so you are assigned correctly after the round. | |||
</div> | |||
=== Practice Mode Commands === | |||
<div class="ck-callout"> | |||
<b>These commands are only available in prac mode: <code>.prac</code> / <code>!prac</code>.</b> Ends practice mode with <code>.exit <b>/</b> !exit</code> | |||
</div> | |||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
! style="width: 175px;" | | ! style="width: 175px;" | Command | ||
! style="width: 600px;" | Description | ! style="width: 600px;" | Description | ||
|- | |- | ||
|!spawn | | !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: <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 | ||
|Teleports you to | |||
|- | |- | ||
|! | | !worstctspawn || Teleports you to CT team’s furthest spawn from your current position | ||
|Teleports you to | |||
|- | |- | ||
|! | | !besttspawn || Teleports you to T team’s closest spawn from your current position | ||
|Teleports you to | |||
|- | |- | ||
|! | | !worsttspawn || Teleports you to T team’s furthest spawn from your current position | ||
|Teleports you to | |||
|- | |- | ||
|! | | !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>) | ||
| | |||
|- | |- | ||
|! | | !hidespawns || Removes competitive spawns in prac mode | ||
| | |||
|- | |- | ||
|!solid | | !solid || Toggle solid teammates on/off | ||
| | |||
|- | |- | ||
|!impacts | | !impacts || Toggle bullet impacts on/off | ||
| | |||
|- | |- | ||
|!traj | | !traj || Toggle grenade trajectories on/off (Alias: <span style="color:#096AB7">!pip</span>) | ||
| | |||
|- | |- | ||
|!bot||Adds a bot on | | !bot || Adds a bot on the user’s current position | ||
|- | |- | ||
|!nobots | | !nobots || Removes all bots | ||
|Removes all | |||
|- | |- | ||
|!cbot | | !cbot || Adds a crouched bot on the user’s current position (Alias: <span style="color:#096AB7">!crouchbot</span>) | ||
|Adds a crouched bot on | |||
|- | |- | ||
|!boost | | !boost || Adds a bot on the current position and boosts the player on it | ||
|Adds a bot on current position and boosts player on it | |||
|- | |- | ||
|!crouchboost | | !crouchboost || Adds a crouched bot and boosts the player on it | ||
|Adds a crouched bot | |||
|- | |- | ||
|!ct / !t / !spec | | !ct / !t / !spec || Changes the player to the requested team | ||
|Changes player | |||
|- | |- | ||
|!watchme / !fas | | !watchme / !fas || Forces all players into spectator except the player who called this command | ||
|Forces all players into spectator except the player | |||
|- | |- | ||
|!fastforward | | !fastforward || Fast-forwards server time to 20 seconds (Alias: <span style="color:#096AB7">!ff</span>) | ||
| | |||
|- | |- | ||
|!dryrun | | !dryrun || Turns on dry-run mode (Alias: <span style="color:#096AB7">!dry</span>) | ||
|Turns on dry-run mode (Alias: <span style="color:#096AB7">!dry</span>) | |||
|- | |- | ||
|!god | | !god || Turns on god mode | ||
|Turns on god mode | |||
|- | |- | ||
|!break | | !break || Breaks all breakable entities (glass windows, wooden doors, vents, etc.) | ||
|Breaks all | |||
|- | |- | ||
|!nade | | !noclip || Activates / deactivates noclip mode | ||
| | |- | ||
| !nade || Displays the nade menu if [[CKRAS BOT]] is enabled (Alias: <span style="color:#096AB7">!nades</span>) | |||
|- | |- | ||
| colspan="2" | | | colspan="2" | | ||
|- | |- | ||
| colspan="2" |'''Nade Commands (!nade):''' | | colspan="2" | '''Nade Commands (!nade):''' | ||
|- | |- | ||
|!throw | | !throw || Rethrows the exact same last grenade you threw (Alias: <span style="color:#096AB7">!rethrow</span>) | ||
| | |||
(Alias: <span style="color:#096AB7">!rethrow</span>) | |||
|- | |- | ||
|!last | | !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 | |||
|- | |||
| !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 | | !clear || Clears active smokes, molotovs and incendiaries | ||
|- | |- | ||
|!noblind | | !noblind || Toggles flashbang immunity (Alias: <span style="color:#096AB7">!noflash</span>) | ||
|Toggles immunity | |||
|- | |- | ||
|!savenade | | !savenade <name> || Saves a lineup (Alias: <span style="color:#096AB7">!sn</span>) | ||
|Saves a lineup | |||
|- | |- | ||
|!loadnade | | !loadnade <name> || Loads a lineup (Alias: <span style="color:#096AB7">!ln</span>) | ||
|Loads a lineup | |||
|- | |- | ||
| | | !delnade <name> || Deletes a lineup (Alias: <span style="color:#096AB7">!deletenade, !dn</span>) | ||
|Deletes a lineup | |||
|- | |- | ||
| | | !importnade || Prints an import code to chat after saving | ||
| | |||
|- | |- | ||
| | | !listnades || Lists saved lineups (Alias: <span style="color:#096AB7">!lin</span>) | ||
|Lists | |||
|- | |- | ||
| | | !globalnades || Stores nades globally on the server (Alias: <span style="color:#096AB7">!save_nades_as_global</span>) | ||
| | |||
(Alias: <span style="color:#096AB7">!save_nades_as_global</span>) | |||
|} | |} | ||
= | <div class="ck-callout"> | ||
>> [[MatchZy# | <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> | |||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
! style="width: 175px;" | | ! style="width: 175px;" | Command | ||
! style="width: 600px;" | Description | ! style="width: 600px;" | Description | ||
|- | |- | ||
|!restart|| | | !restart || Force restarts / resets a match (Alias: <span style="color:#096AB7">!rr</span>) | ||
|- | |- | ||
|! | | !scrim or !start || Force starts a match (Alias: <span style="color:#096AB7">!forcestart</span>, <span style="color:#096AB7">!force</span>) | ||
|- | |- | ||
|!endmatch | | !endmatch || Force ends a match (Alias: <span style="color:#096AB7">!forceend</span>) | ||
|Force | |||
|- | |- | ||
|!prac | | !prac || Starts prac mode (Alias: <span style="color:#096AB7">!tactics</span>) | ||
|- | |- | ||
|! | | !exit || Exits practice mode and loads match mode (Alias: <span style="color:#096AB7">!exitprac</span>) | ||
| | |||
|- | |- | ||
|!map | | !map <name> || Switches to the desired map | ||
|- | |- | ||
|!forcepause | | !forcepause || Pauses the match as admin (Alias: <span style="color:#096AB7">!fp</span>) | ||
|Pauses the match as | |||
(Alias: <span style="color:#096AB7">!fp</span>) | |||
|- | |- | ||
|!forceunpause | | !forceunpause || Force unpauses the match (Alias: <span style="color:#096AB7">!fup</span>) | ||
|Force unpauses the match | |||
|- | |- | ||
|!restore | | !restore <round> || Restore / backup a round | ||
|Restore a | |||
|- | |- | ||
|!rcon | | !rcon <command> || Sends RCON commands | ||
| RCON | |||
|- | |- | ||
|!skipveto | | !skipveto || Skips the current veto phase (Alias: <span style="color:#096AB7">!sv</span>) | ||
|Skips the current veto phase | |||
|- | |- | ||
|!roundknife | | !roundknife || Toggles knife round (Alias: <span style="color:#096AB7">!rk</span>) | ||
|Toggles | |||
|- | |- | ||
|!playout | | !playout || Toggles playout (useful in scrim) | ||
|Toggles playout ( | |||
|- | |- | ||
|!tvrecord | | !tvrecord || Starts a demo manually (see [[CSTV]]) | ||
| | |||
|- | |- | ||
|!tvstop | | !tvstop || Stops a demo (Alias: <span style="color:#096AB7">!stoprecord, !stoptv</span>) | ||
|Stops a demo | |||
|- | |- | ||
|!whitelist | | !whitelist || Toggles whitelisting (<code>cfg/MatchZy/whitelist.cfg</code>) | ||
|Toggles whitelisting | |||
|- | |- | ||
|!readyrequired | | !readyrequired <number> || Sets required ready players | ||
|Sets | |||
|- | |- | ||
|!settings | | !settings || Displays current settings | ||
|Displays | |||
|- | |- | ||
|!asay | | !asay <message> || Say as admin in all chat | ||
|Say as | |||
|- | |- | ||
|!reload_admins | | !reload_admins || Reloads admins from <code>admins.json</code> | ||
|Reloads admins from admins.json | |||
|- | |- | ||
|!reloadmap | | !reloadmap || Reloads the current map (Alias: <span style="color:#096AB7">!rmap</span>) | ||
|Reloads the current | |||
|- | |- | ||
|!team1 | | !team1 <name> || Sets Team 1 name | ||
|Sets | |||
|- | |- | ||
|!team2 | | !team2 <name> || Sets Team 2 name | ||
|Sets name | |||
|} | |} | ||
If you have any suggestions for additional features, please let us know: support@ckras.com | If you have any suggestions for additional features, please let us know: support@ckras.com | ||
== Install MatchZy == | == Install MatchZy == | ||
MatchZy requires [[Metamod]]. Install Metamod first in the [[webinterface]], then activate [[CounterStrikeSharp]] and MatchZy. | |||
<div class="ck-callout ck-callout--amber"> | |||
'''Note:''' MatchZy is preinstalled on all our [[CS2]] gameservers. | |||
</div> | |||
<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> | |||
<div class="ck-step-card"> | |||
<div class="ck-step-top"> | |||
<div class="ck-step-num">2</div> | |||
<div class="ck-step-title">Activate CSS + MatchZy</div> | |||
</div> | |||
<div class="ck-media-frame"> | |||
[[File:Install-matchzy-panel.png|450px|alt=Activate CounterStrikeSharp and MatchZy|link=]] | |||
</div> | |||
<div class="ck-step-desc"> | |||
After Metamod is active, [[CounterStrikeSharp]] (CSS) and MatchZy can be installed. | |||
</div> | |||
</div> | |||
[[File: | <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 == | == 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=]] | |||
<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> | |||
[[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)">​</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] | |||
''<u>Note:</u> The CKRAS Bot does not need to be activated for adding admins.'' | |||
<div class="ck-step-grid"> | |||
<div class="ck-step-card"> | |||
<div class="ck-step-top"> | |||
<div class="ck-step-num">1</div> | |||
<div class="ck-step-title">Open Admin Management</div> | |||
</div> | |||
<div class="ck-media-frame"> | |||
[[File:Add-admins.png|450px|alt=Open admin management|link=]] | |||
</div> | |||
<div class="ck-step-desc"> | |||
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> | |||
<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> | |||
</div> | |||
<div class="ck-callout"> | |||
<b>Optional:</b> The <code>admin.json</code> can also be edited manually via FTP:<br> | |||
<code>/cs2/game/csgo/addons/counterstrikesharp/configs</code> | |||
</div> | |||
== Advanced Configuration == | |||
<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> | |||
<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. | |||
<div class="ck-pathbox"><code>76561198154367261</code></div> | |||
</div> | |||
<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/<map_name>.json</code></div> | |||
Use this file to define custom coach spawn positions per map. | |||
</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> | |||
Available languages: <b>DE, EN, FR, PT, RU, UZ, HU, JP</b> | |||
</div> | |||
</div> | |||
== Integrations and Recording == | |||
<div class="ck-lead"> | |||
Optional integrations, stats and recording related features. | |||
</div> | |||
<div class="ck-section-grid"> | |||
<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> | |||
<div class="ck-mini-card"> | |||
<div class="ck-mini-title">Demos / CSTV</div> | |||
MatchZy records demos automatically. Make sure [[CSTV]] is activated. | |||
</div> | |||
<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> | |||
== | <div class="ck-mini-card"> | ||
<div class="ck-mini-title">Workshop</div> | |||
[[Workshop|Workshop Guide]] | |||
</div> | |||
</div> | |||
== | == 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> | |||
== | <div class="ck-mini-card"> | ||
<div class="ck-mini-title">Useful Bindings</div> | |||
<div class="ck-pathbox"><code>bind <key> css_rcon "sv_rethrow_last_grenade"</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> | |||
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> | |||
[ | [[PreFire]] | [[Retakes]] | [[Deathmatch]] | ||
[[index.php?title=Category:CS2]] | |||
</div> | |||
Latest revision as of 11:41, 10 March 2026
MatchZy for CS2MatchZy is a CS2 plugin for managing Practice, PUGs, Scrims, and Matches on CKRAS servers.
|
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.
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.
Install and activate Metamod in the webinterface first.
After Metamod is active, CounterStrikeSharp (CSS) and MatchZy can be installed.
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:
MatchZy Options
You can customize settings in the webpanel (or manually by editing config.cfg).
Knife Round Every player is admin Smoke Color Playout Prac / Tactic mode Damage Output Auto Record
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.
Open the admin section in the panel to manage MatchZy admins.
Enter your SteamID64 in the webpanel and save the new admin entry.
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.
/csgo/cfg/MatchZyEdit the main MatchZy configuration files here:
warmup.cfgknife.cfglive.cfgprac.cfg
/csgo/cfg/MatchZy/whitelist.cfgAdd one SteamID64 per line.
76561198154367261addons/counterstrikesharp/plugins/MatchZy/spawns/coach/<map_name>.jsonUse this file to define custom coach spawn positions per map.
/csgo/addons/counterstrikesharp/configs/core.jsonAvailable languages: DE, EN, FR, PT, RU, UZ, HU, JP
Integrations and Recording
Optional integrations, stats and recording related features.
Setup Database in the CKRAS panel to use MatchZy Stats.
Official MatchZy stats guide
MatchZy records demos automatically. Make sure CSTV is activated.
Support and Recovery
Everything related to restore, in-game help, binds and support contact.
Users can restore the current round with .stop or !stop.
Admins can restore backups with .restore or !restore.
bind <key> css_rcon "sv_rethrow_last_grenade"bind <key> say .clearCKRAS BOT improves the help output, but MatchZy also works without it via !help and .help.
Support: support@ckras.com
Join Discord
