MatchZy: Difference between revisions

From CKRAS Wiki

No edit summary
 
(26 intermediate revisions by the same user not shown)
Line 38: Line 38:


<div class="ck-jump">
<div class="ck-jump">
<b>Jump to:</b> [[MatchZy#Help_&_Command_Guide_System|Help System]] • [[MatchZy#Commands|Commands]] •  
<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>
</div>


Line 156: Line 156:
|-
|-
| !crouchboost || Adds a crouched bot and boosts the player.
| !crouchboost || Adds a crouched bot and boosts the player.
|-
| !botgun &lt;weapon&gt; <code>new</code> || Gives the practice bot you are aiming at the specified weapon. Example: <code>!botgun ak47</code>.
|-
| !botarmor <code>new</code> || Toggles full armor, including a helmet, for the practice bot you are aiming at.
|-
| !botkevlar <code>new</code> || Toggles body armor without a helmet for the practice bot you are aiming at.
|-
| !botshoot [true/false] <code>new</code> || Enables or disables practice bots aiming at visible enemies and shooting back while staying at their placed positions.
|-
| !botreactiontime &lt;0–1000&gt; <code>new</code> || Sets the reaction delay in milliseconds before practice bots start shooting at a visible enemy.
|-
| !botrespawn [true/false] <code>new</code> || Enables or disables automatic respawning for practice bots.
|-
| !botregen [true/false] <code>new</code> || Enables or disables health regeneration for practice bots.
|-
| !savebotpos &lt;name&gt; <code>new</code> || Saves your current position, viewing direction, team and crouch state as a named bot placement for the active map.
|-
| !loadbotpos [name] <code>new</code> || Spawns a bot at a saved placement. Without a name, loads all saved bot placements for the active map, subject to the bot limit.
|-
| !listbotpos <code>new</code> || Lists saved bot placements for the active map.
|-
| !delbotpos &lt;name&gt; <code>new</code> || Deletes a saved bot placement for the active map.
|-
| !botjiggle <code>new</code> || Toggles side-to-side strafing for placed practice bots.
|-
| !runboost <code>new</code> || Places you on the practice bot you are aiming at and lets you control its movement for run-boost training. Use the command again to stop.
|-
|-
| !ct / !t / !spec || Changes the player to the requested team.
| !ct / !t / !spec || Changes the player to the requested team.
Line 175: Line 201:
| !break || Breaks all breakable entities (glass, vents, etc.)
| !break || Breaks all breakable entities (glass, vents, etc.)
|}
|}
---


==== Replay & Path Recording (MatchZy PRO) ====
==== Replay & Path Recording (MatchZy PRO) ====


<div class="ck-callout ck-callout--amber">
<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.
<b>MatchZy PRO Feature:</b> Record movement paths and coordinated team executes, then replay them using bots. All commands support both <code>!</code> and <code>.</code> prefixes and are available in Practice Mode on CKRAS servers.
</div>
</div>


Line 187: Line 215:
! style="width: 600px;" | Description
! style="width: 600px;" | Description
|-
|-
| .record / .rec <code>new</code>
| !record
| Starts or stops recording a movement path.
| Record your movement and grenade throws. Use the command again or <code>!stop</code> to finish. The last 5 paths are kept in your temporary history buffer. (Alias: !rec)
|-
| !record team <code>new</code>
| Record available players on your team together with synchronized movement and grenade timing. Use <code>!stop</code> to finish, <code>!play all</code> to replay, and <code>!saveplay all &lt;name&gt;</code> to save the complete execute. (Alias: !stratrec)
|-
| !play [all/num/name]
| Replay your current path, a buffer slot (1–5), or a saved recording by name. Use <code>all</code> to replay all buffered paths simultaneously for execute training. (Alias: !replay)
|-
| !saveplay [all/num] &lt;name&gt;
| Permanently save recordings for the active map. Use <code>all</code> to save the complete scenario or a slot number (1–5) to save one path. Without a selector, multiple buffered paths are saved together. (Alias: !saverec)
|-
| !loop
| Enable or disable continuous replay looping. (Alias: !playloop)
|-
| !stop
| Stop your active recording or playback. During a team recording, this finishes the shared recording for all participants. Practice Mode only.
|-
| !clearrec
| Clear your current recording and temporary history buffer. Permanently saved recordings are kept.
|-
| !settrigger [all/num] [radius]
| Set a replay trigger zone at your feet. After 2 seconds, entering the zone starts playback of your current path, the selected buffer slot, or all buffered paths. (Alias: !playtrigger)
|-
| !showpath
| Show or hide your selected path, including movement lines, start/end markers and grenade throw positions. The visualization is visible only to you. (Aliases: !showpatch, !showrec)
|-
|-
| .play <code>new</code>
| !loadplay &lt;name&gt;
| Plays the recorded path using an available bot.
| Load a saved path or multi-path scenario for the active map. Supports smart name matching and older Pro recordings. (Alias: !loadrec)
|-
|-
| .loop / .playloop <code>new</code>
| !listplays
| Enables or disables infinite replay looping.
| List your temporary history buffer and permanently saved paths and scenarios for the active map. (Aliases: !listrec, !listrecs)
|-
|-
| .stop <code>new</code>
| !delplay &lt;name&gt;
| Stops active recording or replay (Practice Mode only).
| Delete a permanently saved path or scenario for the active map. (Alias: !delrec)
|-
|-
| .clearrec <code>new</code>
| !hud
| Deletes the current recorded path.
| Toggle the practice center-screen recording and playback HUD.
|}
|}


Line 223: Line 275:
| !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 231: Line 283:
| !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 287: Line 339:
| !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 302: Line 354:
| !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).
| !addreadytime <seconds> <code>new</code> || Adds time to the active ready-up or veto countdown.  
|-
|-
|!overtime / !ot <code>new</code>
| !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.
|Toggles overtime for the match. Overtime is enabled by default in live.cfg.
|-
|-
Line 383: Line 437:
== Become Admin ==
== Become Admin ==


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


<div class="ck-step-grid">
<div class="ck-step-grid">
Line 401: Line 455:
</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-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 class="ck-step-desc">Enter your SteamID64 or Steam URL and save. The plugin will recognize you instantly.</div>
</div>
</div>
</div>
</div>
Line 465: Line 519:
</div>
</div>
[[index.php?title=Category:CS2]]
[[index.php?title=Category:CS2]]
[[index.php?title=Category:CS2]]
[[Category:CS2]]

Latest revision as of 09:22, 7 November 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.

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

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.
!botgun <weapon> new Gives the practice bot you are aiming at the specified weapon. Example: !botgun ak47.
!botarmor new Toggles full armor, including a helmet, for the practice bot you are aiming at.
!botkevlar new Toggles body armor without a helmet for the practice bot you are aiming at.
!botshoot [true/false] new Enables or disables practice bots aiming at visible enemies and shooting back while staying at their placed positions.
!botreactiontime <0–1000> new Sets the reaction delay in milliseconds before practice bots start shooting at a visible enemy.
!botrespawn [true/false] new Enables or disables automatic respawning for practice bots.
!botregen [true/false] new Enables or disables health regeneration for practice bots.
!savebotpos <name> new Saves your current position, viewing direction, team and crouch state as a named bot placement for the active map.
!loadbotpos [name] new Spawns a bot at a saved placement. Without a name, loads all saved bot placements for the active map, subject to the bot limit.
!listbotpos new Lists saved bot placements for the active map.
!delbotpos <name> new Deletes a saved bot placement for the active map.
!botjiggle new Toggles side-to-side strafing for placed practice bots.
!runboost new Places you on the practice bot you are aiming at and lets you control its movement for run-boost training. Use the command again to stop.
!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 coordinated team executes, then replay them using bots. All commands support both ! and . prefixes and are available in Practice Mode on CKRAS servers.

Command Description
!record Record your movement and grenade throws. Use the command again or !stop to finish. The last 5 paths are kept in your temporary history buffer. (Alias: !rec)
!record team new Record available players on your team together with synchronized movement and grenade timing. Use !stop to finish, !play all to replay, and !saveplay all <name> to save the complete execute. (Alias: !stratrec)
!play [all/num/name] Replay your current path, a buffer slot (1–5), or a saved recording by name. Use all to replay all buffered paths simultaneously for execute training. (Alias: !replay)
!saveplay [all/num] <name> Permanently save recordings for the active map. Use all to save the complete scenario or a slot number (1–5) to save one path. Without a selector, multiple buffered paths are saved together. (Alias: !saverec)
!loop Enable or disable continuous replay looping. (Alias: !playloop)
!stop Stop your active recording or playback. During a team recording, this finishes the shared recording for all participants. Practice Mode only.
!clearrec Clear your current recording and temporary history buffer. Permanently saved recordings are kept.
!settrigger [all/num] [radius] Set a replay trigger zone at your feet. After 2 seconds, entering the zone starts playback of your current path, the selected buffer slot, or all buffered paths. (Alias: !playtrigger)
!showpath Show or hide your selected path, including movement lines, start/end markers and grenade throw positions. The visualization is visible only to you. (Aliases: !showpatch, !showrec)
!loadplay <name> Load a saved path or multi-path scenario for the active map. Supports smart name matching and older Pro recordings. (Alias: !loadrec)
!listplays List your temporary history buffer and permanently saved paths and scenarios for the active map. (Aliases: !listrec, !listrecs)
!delplay <name> Delete a permanently saved path or scenario for the active map. (Alias: !delrec)
!hud Toggle the practice center-screen recording and playback HUD.

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.
!addreadytime <seconds> new Adds time to the active ready-up or veto countdown.
!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.
!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

PreFire | Retakes | Deathmatch

index.php?title=Category:CS2