Jailbreak

Often used with CTBans

Core Features

• Warden System: Complete warden management with commands, laser pointer, and team control
• Last Request (LR): Multiple LR types with stats tracking via SQL
• Special Days: Various special day events to keep gameplay fresh
• Team Management: CT queue system, team ratio enforcement, and swap functionality
• Admin Controls: Comprehensive admin commands for server management
• CT Queue: Queue system for CTs to join the game
• CT Ban Integration: Integration with CT Bans for banning CTs from the queue

Installation

1. Download the latest release from GitHub Releases
2. Extract the zip into game/csgo/addons/counterstrikesharp/plugins/CS2-Jailbreak
3. Configure the plugin in game/csgo/addons/counterstrikesharp/configs/plugins/Jailbreak/Jailbreak.json

On first run, CounterStrikeSharp generates Jailbreak.json from plugin defaults if it does not exist yet.

Releases

Tagged releases are built automatically when a v* tag is pushed (for example v0.5.1). The workflow uploads Jailbreak.zip to GitHub Releases.

Database Setup (Optional)

For LR stats tracking:

1. Create a MySQL database
2. Configure database credentials under the Database section in Jailbreak.json

Important

This plugin is optimized for Linux servers (linux-x64 build). On Windows, the pre-damage hook is disabled because it has historically crashed CS2 servers; LR/SD damage rules fall back to EventPlayerHurt handling instead.

Commands

Chat commands use the ! prefix in-game. Console commands use css_<name> (for example css_lr). Most command names and aliases below are defaults from Jailbreak.json and can be changed in config.

Player Commands

• !w / !c / !warden / !commander - Become warden (CT, alive)
• !uw / !uc / !unwarden / !uncommander - Leave warden
• !wtime / !ctime - Show how long the current warden has been active
• !guns - Open the CT gun menu
• !wb / !wub / !noblock - Toggle block status (warden only)
• !color / !colour - Set prisoner color (warden only)
• !laser_color / !laser_colour - Set laser color (warden only)
• !marker_color / !marker_colour - Set marker color (warden only)
• !lr - Open the last request menu
• !cancel_lr - Cancel the current LR (warden or admin)
• !lr_stats - View LR win/loss stats
• !kill / !suicide - Slay yourself
• !ctqueue / !joinqueue / !ct - Join CT queue
• !leavequeue - Leave CT queue
• !listqueue / !queuelist / !queue - View current CT queue

Warden Commands

Requires being the warden unless noted otherwise. Type !wcommands or !ccommands to print the in-plugin warden command list.

• !wd / !war / !warday <location> [delay] - Start a warday
• !wsd - Call a warden special day
• !wsd_ff - Call a warden friendly-fire special day
• !give_pardon - Pardon a rebel
• !give_freeday - Give a T a freeday
• !countdown <time> <msg> - Start a countdown
• !countdown_abort - Abort the current countdown
• !force_open / !force_close - Toggle all doors open/closed
• !remove_marker - Remove the warden marker
• !heal_t - Heal all alive T's
• !wm - Warden mute (mutes everyone except warden for 10 seconds)

Admin Commands

Requires @css/generic permission.

• !rw / !rc / !removewarden / !removecommander - Remove current warden
• !swapguard / !swap_guard <player> - Move a player to CT
• !fire_guard - Slay and move all guards except the warden to T
• !sd - Start a special day
• !sd_ff - Start a friendly-fire special day
• !sd_cancel - Cancel the current special day
• !logs - View round logs

Debug Commands

Requires @jail/debug permission. Registered when debug mode is enabled in code.

• !nuke - Slay all players
• !is_rebel - Print rebel state to console
• !lr_debug - Start LR without normal restrictions
• !is_blocked - Print block state
• !test_laser - Test laser marker draw
• !test_player - Print player/pawn designer names
• !test_strip - Strip weapons
• !join_ct_debug - Force join CT
• !hide_weapon_debug - Hide weapon on back
• !rig - Force player to SD boss
• !is_muted - Print voice mute flags
• !spam_db - Test LR stats DB increment
• !wsd_enable - Enable warden SD for current round
• !test_noblock - Test noblock collision

Available Special Days

Each type can be enabled or disabled in the SpecialDay section of Jailbreak.json.

• Friendly fire
• Juggernaut
• Tank
• Spectre
• Dodgeball
• Grenade
• Scout knife
• Hide and seek
• Headshot only
• Knife warday
• Gun game
• Zombie

Last Request Types

Each type can be enabled or disabled in the Prisoner.LR section of Jailbreak.json.

• Knife Fight
• Gun toss
• Dodgeball
• No Scope
• Grenade
• War
• Russian roulette
• Scout knife
• Headshot only
• Shot for shot
• Mag for mag

When you are the last alive T, the LR menu can also offer rebel options: Knife rebel, Rebel, and Riot (if Settings.RiotEnable is enabled). These are menu actions, not separate tracked LR stat types.

API Usage

For developers integrating with the WardenService API, see the upstream JailServiceTest example project.

Recommended Plugins

• CT Bans

Fork / Attribution

This fork is maintained by tinsware/cs2_jailbreak.

Project lineage:

• destoer/Cs2Jailbreak (original)
• playpark/cs2-jailbreak (community fork)
• tinsware/cs2_jailbreak (this fork)

Original authors: destoer, continued by exkludera.

License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0).

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.