Page 1 of 1

PLUGIN - CS2-AutoBalancePlugin

Posted: Tue Feb 24, 2026 10:29 pm
by greenie
CS2-AutoBalancePlugin
Auto Balance Plugin for CS2 using CounterStrikeSharp

How to change the config file
1 - Run the server with the plugin, it will auto-generate a config.
2 - Open addons/counterstrikesharp/configs/plugins/AutoBalancePlugin/AutoBalancePlugin.json
3 - Change it however you want.

Available modes
Currently there is two balancing modes, they are:

Default mode: grabs the team with the most players and change them to the other team .
Scramble mode: every player is randomly put in some team, while still auto-balancing, good for retake servers and so on.
Changing modes
1 - Open the config file.
2 - Change the variable "ScrambleMode" to 0 for default mode or 1 for scramble mode.

Changing default message (colors and formatting)
1 - Open the config file.
2 - To change colors, change the variable "AutoBalanceMessage" as you like, here's the available color codes:

{DEFAULT}
{WHITE}
{DARKRED}
{GREEN}
{LIGHTYELLOW}
{LIGHTBLUE}
{OLIVE}
{LIME}
{RED}
{PURPLE}
{GREY}
{YELLOW}
{GOLD}
{SILVER}
{BLUE}
{DARKBLUE}
{BLUEGREY}
{MAGENTA}
{LIGHTRED}
OBS: {_playerName} and {_switchedTeam} are the variables for detecting the player name and team it was switched to, you can remove if you wan't.
Available Configurations
{
"ScrambleMode": false, // Setting that to true will make teams scramble upon auto-balance, good for retake servers
"KillPlayerOnSwitch": false, // Setting that to true will make player get killed when being switched
"BalanceOnRoundStart": false, // Setting that to true will make the auto-balance happen upon round start (default: on round end)
"BalanceBots": true, // Setting that to false will prevent bots from being accounted into the auto-balance
"MaximumAllowedDifference": 1 // Maximum players difference for the auto-balance to start working
"AutoBalanceMessage": " {GOLD}● [Auto Balance] {DEFAULT} -> {DEFAULT}Switched {GOLD}{_playerName} {DEFAULT}to {RED}{_switchedTeam}", // The message that will be displayed when a player is auto-balanced
"ConfigVersion": 1 // Config version, don't change
}
https://github.com/GabrielBigardi/CS2-A ... s/main.zip