Advanced Bot Team Balance v1.4
==============================
Copyright 2012-2013, Rich Weeds Nagel - Some Rights Reserved

Description
-----------
This Lua script for Counter-Strike 2D will automatically add or remove bots to
a server in order to maintain a specified number of total players (bots plus
humans) within the game.

Settings can be changed (and the script can be enabled or disabled) by issuing
simple console commands on a "listen" server (when starting a new game), as
well as on a dedicated server via RCon.

Note that spectators on the server are ignored in the total players count. This
allows for human spectators to be connected to the server, without affecting
the team-balancing of the current actively playing bot and human players.

Lastly, note that when running this script it is recommended to enable Auto
TeamBalance within the game ("mp_autoteambalance 1"), as well as setting Bots
to 0 before starting the server ("bot_count 0").

Installation
------------
Unzip the files contained in the "Advanced_Bot_Team_Balance_v1.4.zip" archive
to the "Counter-Strike 2D\Sys\Lua" folder on your hard drive, and then add the
following line to the "Server.lua" (located in the same folder) file using
Windows Notepad:

dofile("Sys/Lua/AdvancedBotTeamBalance.lua")

Alternatively, simply unzip the files to the
"Counter-Strike 2D\Sys\Lua\Autorun" folder on your hard drive. Note that this
method does NOT require editing of the "Server.lua" file (as the game will
automatically run any Lua script files that are located in the "Autorun"
folder).

Initial Setup Defaults
----------------------
The first time that you run Counter-Strike 2D (or a Counter-Strike 2D dedicated
server) after installing Advanced Bot Team Balance, the script will create the
configuration file "AdvancedBotTeamBalance.cfg" (located in the "Counter-Strike
2D\Sys" folder on your hard drive).

This configuration file will contain the following two initial setup defaults
used by Advanced Bot Team Balance when it is run for the first time:

"bot_balance = 5" - Set total players (bots plus humans) to 5 players per team.
"bot_balance_enabled = 1" - Enable Advanced Bot Team Balance.

Runtime Defaults
----------------
The next time that you run Counter-Strike 2D (or a Counter-Strike 2D dedicated
server) with Advanced Bot Team Balance installed, the script will load and
apply the settings from the previously created "AdvancedBotTeamBalance.cfg"
configuration file (mentioned above).

The script will also save any settings that you have changed (using the in-game
and RCon console commands mentioned below) to this configuration file, so that
the script will load and apply the settings the next time that you run the game
(or a Counter-Strike 2D dedicated server), or when the server cycles to the
next map.

Console Commands
----------------
Note that these console commands will function on a "listen" server (when
starting a new game), as well as on a dedicated server via RCon.

bot_balance <players> = Enable Advanced Bot Team Balance, and change Bot Team
                        Balance to 0-15 player(s) per team.

bot_balance on  = Enable Advanced Bot Team Balance.
bot_balance off = Disable Advanced Bot Team Balance.

bot_balance welcome/message = Display join server welcome message, and current
                              Bot Team Balance settings to all players.

bot_balance help/?        = Display help screen.
bot_balance version/about = Display version information.

Version History
---------------
v1.0                  - First Release.
(December 21, 2012)

v1.1                  - Changed the "join server welcome message" function so
(December 21, 2012)     that it is now displayed only to the players who are
                        joining the server, instead of all of the players who
                        are currently on the server when a new player joins.
                      - Changed the "bot_balance version/about" console
                        commands so that they print to the console, instead of
                        all of the connected players' HUDs.
                      - Added a routine to count the spectators who are
                        currently connected to the server (although this number
                        is currently unused by the script).

v1.2                  - Changed the "join server welcome message".
(December 22, 2012)   - Added the "bot_balance welcome/message" console
                        commands to display the "join server welcome message"
                        to all of the players who are currently connected to
                        the server.
                      - Changed a few other things here and there.


v1.3                  - Added configuration file support which will save, load,
(December 24, 2012)     and apply any settings that have previously been
                        changed using the console commands.
                      - Changed the "join server welcome message" so that is
                        also displays the current settings of the script.
                      - Changed a few of the displayed in-game messages.
                      - Changed a few other things here and there.

v1.4                  - Changed the "join server welcome message" so that it is
(January 2, 2013)       not quite as annoying (when used with other Lua scripts
                        that also display a server welcome message).
                      - Changed the "help" and "version information" text that
                        is printed to the console.
                      - Changed a few other things here and there.


ENJOY!
------
Rich Weeds Nagel
January 2, 2013

richnagel@centurylink.net
http://www.richnagel.net
http://www.unrealsoftware.de/profile.php?userid=110755
http://steamcommunity.com/id/RichNagel
