MatchZy: Difference between revisions

From CKRAS Wiki

← Older editNewer edit →
VisualWikitext
No edit summary
Tag: Reverted
Line 1: Line 1:
__NOTOC__


{{#seo:
|title=Scrim & Practice Plugin for CS2 Gameservers - CKRAS WIKI
|title_mode=append
|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 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_alt=MatchZy PRO – CS2 scrim and practice plugin for CKRAS servers
}}
<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 ==
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>
---
=== Custom Commands ===
<div class="ck-callout">
<b>Use these during normal scrims / matches.</b>
</div>
{| class="wikitable"
|-
! style="width: 200px;" | !<cmd> / .<cmd>
! style="width: 600px;" | 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.
| !clearrec  
|-
| !stop / !restore || Restores the backup of the current round (both teams needed).
|-
| !tac || Starts a tactical timeout.
|-
| !coach <ct|!coach <side> || Starts coaching the specified side. Example: <code>!coach t</code>
|-
| !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 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"
|-
! style="width: 200px;" | !<cmd> / .<cmd>
! style="width: 600px;" | 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 ====
{| class="wikitable"
|-
! style="width: 200px;" | !<cmd> / .<cmd>
! style="width: 600px;" | 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) ====
 
<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>
 
{| class="wikitable"
|-
! 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.
|-
| !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!
|-
| !saveplay [all] &lt;name&gt; <code>new</code>
| Permanently stores the current recording buffer for the active map. Supports single-path recordings as well as multi-path execute recordings. Add <code>all</code> to save the complete scenario.
|-
| !loop / !playloop <code>new</code>
| Enables or disables infinite replay looping.
|-
| !stop <code>new</code>
| Stops active recording or replay (Practice Mode only).
|-
| !clearrec <code>new</code>
| Deletes the current recorded path.
| Deletes the current recorded path.
|-
|-
|!settrigger <code>new</code>
|!settrigger  
|Set a zone at your feet and walk into it later to start the playback!
|Set a zone at your feet and walk into it later to start the playback!
|-
|-
|!showpatch <code>new</code>
|!showpatch  
|Toggles colored visual lines for recorded bot movements and start-markers.
|Toggles colored visual lines for recorded bot movements and start-markers.
|-
|-
|!loadplay <name> <code>new</code>
|!loadplay <name>  
|Loads a previously saved path by name (includes smart-matching).
|Loads a previously saved path by name (includes smart-matching).
|-
|-
| !listplays <code>new</code>
| !listplays  
| Shows all recordings (both the 5-slot temporary buffer and permanent saved plays).
| Shows all recordings (both the 5-slot temporary buffer and permanent saved plays).
|-
|-
| !delplay &lt;name&gt; <code>new</code>
| !delplay &lt;name&gt;  
| Deletes a saved path recording.
| Deletes a saved path recording.
|-
|-
|!hud <code>new</code>
|!hud  
|Toggle center-screen HUD and visual menus (Practice status/Help Dashboard) for a cleaner UI.
|Toggle center-screen HUD and visual menus (Practice status/Help Dashboard) for a cleaner UI.
|}
|}
Line 244: Line 43:
| !last || Teleports you to the last thrown grenade position.
| !last || Teleports you to the last thrown grenade position.
|-
|-
| !back <nr> || Teleports you back in your grenade history. <code>!back</code> without number teleports you to last position  <code>new</code>
| !back <nr> || Teleports you back in your grenade history. <code>!back</code> without number teleports you to last position   
|-
|-
| !delay <sek> || Sets a delay for Rethrow/Index commands.
| !delay <sek> || Sets a delay for Rethrow/Index commands.
Line 252: Line 51:
| !lastindex || Prints the index number of your last thrown grenade.
| !lastindex || Prints the index number of your last thrown grenade.
|-
|-
|!resetnade / !resetnades <code>new</code>
|!resetnade / !resetnades  
|Command to reset grenade history in Practice Mode
|Command to reset grenade history in Practice Mode
|-
|-
|!autogo <code>new</code>
|!autogo  
|Teleports you to the landing position of your thrown smoke or molotov
|Teleports you to the landing position of your thrown smoke or molotov
|-
|-
|!goto <code>new</code>
|!goto  
|Teleport to a specific position index in grenade history.
|Teleport to a specific position index in grenade history.
|-
|-
|!drop <code>new</code>
|!drop  
|Drops the player to the ground, fixing potential stuck-in-air issues after noclip.
|Drops the player to the ground, fixing potential stuck-in-air issues after noclip.
|-
|-
Line 308: Line 107:
| !prac / !tactics || Starts practice mode.
| !prac / !tactics || Starts practice mode.
|-
|-
| !exit / !exitprac || Exits practice mode + <code>new</code> reset the current match state (warmup) even during a live game
| !exit / !exitprac || Exits practice mode + reset the current match state (warmup) even during a live game
|-
|-
| !map <name> || Switches the map (e.g., <code>!map de_inferno</code>).
| !map <name> || Switches the map (e.g., <code>!map de_inferno</code>).
|-
|-
|!dm / !deathmatch <code>new</code>
|!dm / !deathmatch  
|toggles deathmatch mode during warmup on and off, see [[MatchZy#MatchZy Options|options]]
|toggles deathmatch mode during warmup on and off, see [[MatchZy#MatchZy Options|options]]
|-
|-
Line 323: Line 122:
| !rcon <command> || Sends RCON commands to the server. (alternative via console css_rcon <cmd>
| !rcon <command> || Sends RCON commands to the server. (alternative via console css_rcon <cmd>
|-
|-
| !roundknife / !rk / !knife <code>new</code>|| Toggles knife round.
| !roundknife / !rk / !knife || Toggles knife round.
|-
|-
| !playout / !clinch <code>new</code>|| Toggles playout (match continues after winner is decided).
| !playout / !clinch || Toggles playout (match continues after winner is decided).
|-
|-
|!overtime / !ot <code>new</code>
|!overtime / !ot  
|Toggles overtime for the match. Overtime is enabled by default in live.cfg.
|Toggles overtime for the match. Overtime is enabled by default in live.cfg.
|-
|-
Line 341: Line 140:
|-
|-
| !readyrequired <num> || Sets the number of ready players required to start.
| !readyrequired <num> || Sets the number of ready players required to start.
|-
| !addreadytime <seconds> <code>new</code> || Adds time to the active ready-up or veto countdown. Requires the <code>@css/map</code> admin permission.
|-
|-
| !settings || Displays the current server settings.
| !settings || Displays the current server settings.

Revision as of 22:06, 3 October 2026

|- | !clearrec | Deletes the current recorded path. |- |!settrigger |Set a zone at your feet and walk into it later to start the playback! |- |!showpatch |Toggles colored visual lines for recorded bot movements and start-markers. |- |!loadplay <name> |Loads a previously saved path by name (includes smart-matching). |- | !listplays | Shows all recordings (both the 5-slot temporary buffer and permanent saved plays). |- | !delplay <name> | Deletes a saved path recording. |- |!hud |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
!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 Command to reset grenade history in Practice Mode
!autogo Teleports you to the landing position of your thrown smoke or molotov
!goto Teleport to a specific position index in grenade history.
!drop 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 + reset the current match state (warmup) even during a live game
!map <name> Switches the map (e.g., !map de_inferno).
!dm / !deathmatch 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 Toggles knife round.
!playout / !clinch Toggles playout (match continues after winner is decided).
!overtime / !ot 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.
!addreadytime <seconds> new Adds time to the active ready-up or veto countdown. Requires the @css/map admin permission.
!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 or Steam URL 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

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