A configurable automated team manager.
https://forums.alliedmods.net/showthread.php?p=2653016
Description
Credits/Inspiration
Changelog
Installation
Modules
ConVars
Dependencies
Compatible Plugins
Bugs
Skill Auto Balance is a simple concept. Place players on teams so the skill level of each team is approximately the same. In practice, doing this is very difficult. How should we define "skill" for each team, when they are made up of random players? We cannot do it without context.
For that reason, this plugin relies on any external plugin to provide that context: a "rating" for each player. See the modules section for more detail on how this plugin works.
Admin Player Team Switch and Scramble Menu by r5053
[CS:S/GO+DoD:S] Auto Team Scrambler 2 (Updated 27-12-2012 @ DODS/CSGO) by RedSword
[ANY MOD] SwapTeam v1.2.6 (Updated 30/09/12) by bobbobagan
CS:S Team Balance by dalto
RankMe RankScramble by eyal282
Team Join Manager by GetRektByNoob
Block Team Changes by sdz
TeamChange Unlimited by Sheepdude
CSGO Auto Assign Team by SM9
Expand for changelog
4.1.2 (too many minor changes that were only released in 'beta' between 3.2.5 and 4.1.2) -Force mp_autoteambalance and mp_limitteams to both be 0 (Thanks Penalte from alliedmods for the suggestion.
Add convar sab_nobalancelastnminutes and sab_nobalancelastnrounds (Thanks to Razvann. from alliedmods for the suggestion)
Fix logic/bugs where the plugin would balance at incorrect times (Thanks to Razvann. from alliedmods for helping me test this issue).
Massive plugin restructure. Added a bunch of natives and forwards. Made the plugin modular.
Since the plugin is restructured, you need to reinstall it fully.
3.2.5 -
Added afk_manager4 support. The purpose of this is to fix a bug when using sab_forcejointeam "2" where clients would be moved to spectator by afk-manager4 and then be unable to rejoin a team.
3.2.4 -
Properly check if a server has SourceTV before doing balance. Fixes bug where balance never occurs.
Do not move players to spectate if forcejointeam is disabled. Fixes bug where teammenu disappears after a few seconds and players must wait.
Only increment rounds passed after warmup ends. Balance after "n" rounds had been occurring 1 round too early.
Thanks to Răzvan from alliedmodders for helping me debug and fix these issues.
3.2.3 -
Added cvar_MaxTeamSize. It allows you to set a maximum team size. If the team sizes reach the max, players who join and are not admin are kicked. The admins who join can only spectate.
Fixed bug caused by last update, where players who teams were switched are immune for ~1 second at round start.
Added translations/phrases related to the new convar.
Fixed bug in issue #27 and #29
Fixed bug where players can still join spectate when disabled, by adding commandlistener for spectate.
3.2.2 -
Fixed a bug where client scores were not being fetched properly.
Fixed a bug where GetAverageScore would not iterate through all players, resulting in an abnormally low average score.
Few small logic fixes.
Fixed name of levelsranks plugin to be levelsranks and not levelranks (thanks penalte on alliedmods).
3.2.1 -
Fixed "sab_forcejointeam 1", which did not function properly.
3.2.0 -
Split the plugin into different versions and removed sab_scoretype. See Installation section.
3.1.5 -
Add HLStatsX support. Not sure if it works. Other changes in other versions, bugfixes, I'll go through commit history later and update this.
3.1.1 -
Bugfixes:
This time, for sure, the correct amount of players will be swapped now. The bug is, there were duplicate clients being created in my list of clients. They were created after sorting. In my list of clients, there were some extra empty indices with 0's, and those 0's were being replaced with other client indices.
Also fixed other broken logic related to determining which players count as outliers.
3.1.0 -
Bugfixes:
The correct amount of players will be swapped now. (closed issues #8 and #11)
Changes:
ForceJoinTeam convar changed to be an int and has 3 options now (disabled: 0, optional: 1, forced: 2)
Added new cvars to balance teams after map change and after a certain amount of players join/leave, or even to balance every single round.
Added a scale. Basically, lower scale = more outliers.
Translations updated.
3.0.2 -
Bugfixes:
Scores are updated correctly.
BalanceSkill now only occurs after all scores are updated.
Disabling "teammenu" now only occurs after mapstart to prevent errors.
Balance should no longer cause teams to be horribly misbalanced. (imagine making an autobalance that just makes teams worse)
Spawn bug (may) be fixed after implementing "[CSGO] Auto Assign Team by SM9". Forcing players to join teams now uses ClientCommand for "jointeam". Thanks to MAMAC for showing me and both SM9+MAMAC for creating this. *I say "may" be fixed because the problem was already rare and so it is possible that I have just not seen or been notified of it happening when it does.*
Changes:
Sorting method combines two ideas now. I call them "closest sums" and "alternating".
"Closest sums" makes the sum of points on both teams as close as possible.
"Alternating" alternates players between teams as it goes down the sorted list.
Read about it here: #2 (comment)
Added support for Level Ranks
A fork of the plugin on github has support for NC RPG. I added but shortly after removed support because their include file has a lot of extra includes that I don't want to add as a requirement for this plugin to be installed.
BlockTeamSwitch convar changed to be an int and has 3 options now (disabled: 0, enabled but can spectate: 1, enabled with no switching at all: 2)
3.0.1 - Changed sorting method when sorting by gameME or RankMe.
Using gameME, RankMe, LVL Ranks or NC RPG, get client's skill rather than their rank. This way, I can sort all of the score types in the same way.
3.0.0 - I've been making lots of minor changes to this plugin over the last month. In general, it consists of function optimization, improving code readability, adding some features and trying out various solutions to the bug I've been trying to fix for awhile now (see Bugs section). You can see old changelog(s) at the alliedmodders thread.
Put the three required plugins in your plugins folder (sab-core, sab-checkbalance, and sab-ctps).
Put any additional modules you want to add in your plugins folder (sab-admin, sab-blockteams, sab-messages).
Put sab.phrases.txt into your translations directory.
You need to be using at least one of the point systems, because players need some sort of "rating" for us to balance teams. If you do not use any at the moment, I made a basic one called kpr_rating.
Corresponding include in addons/sourcemod/includes/skillautobalance/core.inc
Generates config in cfg/sourcemod/sab-core.cfg
Generates config in cfg/sourcemod/sab-checkbalance.inc
Generates config in cfg/sourcemod/sab-ctps.inc
Corresponding include in includes/skillautobalance/admin.inc
Adds options to disable the team menu and automatically place players on teams. Optionally adds commands sm_j and sm_s to switch between spectating and playing.
Corresponding include in includes/skillautobalance/blockteams.inc
Generates config in cfg/sourcemod/sab-blockteams.inc
Generates config in cfg/sourcemod/sab-messages.inc
sab_botsareplayers (boolean | default 0)
"When teams are being balanced, 1 = Bots are players (bots have points/KDR), 0 = Bots are outliers (bots do not have points/KDR)"
sab_keepplayersalive (boolean | default 1)
"Living players are kept alive when their teams are changed"
sab_minplayers (int | min 2 default 7)
"The amount of players not in spectate must be at least this number for a balance to occur"
sab_scoretype (int | min 0 max 7 default 0)
"0 = Auto detect scoretype. Only change this if you have multiple types loaded. 1 = gameME, 2 = HLstatsX, 3 = Kento-RankMe, 4 = LevelsRanks, 5 = NCRPG, 6 = SABRating, 7 = SMRPG"
sab_blockteamswitch (int | min 0 max 2 default 0)
"0 = Don't block. 1 = Block, can join spectate, must rejoin same team. 2 = Block completely (also disables teammenu and chatchangeteam commands like !join !spec)"
sab_chatchangeteam (boolean | default 0)
"Enable joining teams by chat commands '!join, !play, !j, !p, !spectate, !spec, !s (no picking teams)"
sab_enableplayerteammessage (boolean | default 0)
"Show the messages in chat when a player switches team"
sab_forcejointeam (int | min 0 max 2 default 0)
"0 = Disabled, 1 = Optional (!settings), 2 = Forced. Force clients to join a team upon connecting to the server. Always enabled if both sab_chatchangeteam and sab_teammenu are disabled"
sab_maxteamsize (int | min 0 default 0)
"0 = Unlimited. Max players allowed on each team. If both teams reach this amount, new non-admin players are kicked. Only works if sab_blockteamswitch is 2"
sab_teammenu (boolean | default 1)
"Whether to enable or disable the join team menu"
sab_balanceafternplayerschange (int | min 0 default 0)
"0 = Disabled. Otherwise, balance teams when 'N' players join/leave the server. Requires sab_balanceafternrounds to be enabled"
sab_balanceafternrounds (int | min 0 default 0)
"0 = Disabled. Otherwise, after map change balance teams when 'N' rounds pass. Then balance based on team win streaks"
sab_balanceeveryround (boolean | default 0)
"If enabled, teams will be rebalanced at the end of every round"
sab_decayamount (float | min 1 default 1.5)
"The amount to subtract from a streak if UseDecay is true. In other words, the ratio of a team's round wins to the opposing team's must be greater than this number in order for a team balance to eventually occur"
sab_minstreak (int | min 0 default 6)
"Amount of wins in a row a team needs before autobalance occurs"
sab_nobalancelastnminutes (int | min 0 default 0)
"0 = Disabled. Otherwise, this is the amount of time remaining before the map ends where balancing is turned off."
sab_nobalancelastnrounds (int | min 0 default 0)
"0 = Disabled. Otherwise, this is the amount of rounds remaining before the map ends where balancing is turned off."
sab_usedecay (boolean | default 1)
"If 1, subtract sab_decayamount from a team's streak when they lose instead of setting their streak to 0"
sab_scale (float | min 0.1 default 1.5)
"Value to multiply IQR by. If your points have low spread keep this number. If your points have high spread change this to a lower number, like 0.5"
sab_messagecolor (string | default white)
"See sab_messagetype for info"
sab_messagetype (int | min 0 max 3 default 0)
"How this plugin's messages will be colored in chat. 0 = no color, 1 = color only prefix with sab_prefixcolor, 2 = color entire message with sab_messagecolor, 3 = color prefix and message with both sab_prefixcolor and sab_messagecolor"
sab_prefix (string | default [SAB])
"The prefix for messages this plugin writes in the server"
sab_prefixcolor (string | default white)
"See sab_messagetype for info"
Third party include files you need in order to compile depend on what version you are using. See Installation section.
gameME
RankMe Kento Edition untested
LVL Ranks untested
NCRPG
SMRPG untested
HLStatsX untested
KPR Rating
No bugs, as far as I know.