Authour - FlakMagnet
Build time - ~65 hours (first time with Unreal Scripting)
Release Date - 18/04/2006
Size - ~110K
Version - 7.1
*****************
*** IMPORTANT *** Upgrading from a previous version
*****************
If you are not upgrading from version 4 or earlier, please ignore this section.
Very sorry for the inconvenience, but I have renamed the package that this mutator belongs
to. Because of this, you need to perform some tidy-up to get rid of the previous versions.
o Delete CybaSys.* from your UT2004\System folder.
o Edit User.ini and remove any sections that refer to 'CybaSys.BotManager'
o Edit UT2004.ini and remove any line containing the text 'CybaSys'.
Again, very sorry for the inconvenience, but the change of name was to stop confusion.
The new package name is now BotManager.
Description
===
This Mutator allows you to manage the addition and removal of Bots from within a running game.
Unlike the 'AddBots' and 'KillBots' commands build into UT2004, this mutator allows the team
to which bots are to be added or killed to be specified, and also allows you to specify the
skill of the bots being added. Now games can contain bots with differing skill levels!
Bugs fixed in Version 7.1
=
1. Could not kill Bots in non-team games! Thanks to nedd3h for finding that one
2. Problems with the Invasion gametype. BotManager was treating this gametype as if there
were two teams of Bots (because that is how it is implemented). Now correctly supports
a single team. Thanks to nedd3h for that one too!
New features for Version 7
==
1. Admin Only mode. When enabled, BotManager will only work for the player logged on as the
ADMIN user. Use command 'adminlogin <admin name> <admin password>' to log on as the ADMIN
user.
If you are not an ADMIN user, attempting to use BotManager will result in the message :
"ADMIN rights required!"
You can enable/disable the Admin Only mode in the Mutator game menu by pressing the
'Configure Mutators' button.
2. Auto Spawn. When enabled, this feature will respawn the Bots from the previous round in the
next round. All the bots are retained, including their skill setting.
With this option disabled, each new round starts will no Bots in the game.
You can enable/disable the Auto Spawn mode in the Mutator game menu by pressing the
'Configure Mutators' button.
3. Creating multiple Bots with the same name now results in creating the same Bot, but with a
modified name. For example, attempting to add 2 Xans to the game will result in one Xan, and
another Xan with a modified name ('Xan_OwnsYou' for example).
In previous versions, adding a second Xan would actually add a random Bot.
So you can now have a complate team of Xans if you want!
Bugs fixed in Version 7
===
1. Setting initial number of Bots in Game Rules incorrectly added the specified number of Bots
to the game when using BotManager. Now, the only Bots added when BotManager is selected are the
ones added by the Auto Spawn feature. When Auto Spawn is deativated, no Bots are added to the
game - even if specified in Game Rules.
Changes in Version 7
1. BotManager menus and commands are now only accessible when a game is in progress. Before the
round starts, and after the round ends, BotManager commands may not be used.
This change stops all sorts of nasty situartions occuring, like adding bots during the count
down before a round starts and after the round ends.
2. The red and blue skill settings are now stored in the configuration file. The Bot Skill
specified in the Game Rules is now ignored.
New features for Version 6.x
1. Separate 'Add' and 'Kill' buttons are supplied for the Red and Blue teams instead of having
a single set of buttons (by popular demand).
2. Works better with custom game types. e.g. Now works correctly with JailBreak game type.
I have only tested this with JailBreak, but should also work with other game types too
Bugs fixed in Version 6.1
=
1. Some Bots are spawned without orders causing them to stand idely.
Bugs fixed in Version 6
===
1. Bots with spaces in their names are not added correctly.
New features for Version 5
==
1. Non-team game types are now supported. So you can now manage bots in Death Match, Mutant
and other non-team game types!
2. The in-game menus now allow the addition and removal of bots by name. Bots are selected
by typing their name, or by selecting their picture from a list of available bots.
3. The 'mutate' commands described below can now all be entered using a 'short form'. This is
for users who prefer to use the console rather than the in-game menus.
See the section on 'Command Short Forms' for further information.
How to use it
=
The mutator is controlled from the console and in-game menus. Everything can be controlled
equally from the console and menus - just use whichever method you prefer.
To access the in-game menus, use the 'mutate BotManager' console command from within a running
game.
The Mutator also has some configuration settings, which are accessed by pressing the
'Configure Mutators' button on the Mutator screen.
The available console commands are:
For Team Games
--------------
mutate AddRedBots
- Adds a single red bot to the game at the skill level set in Game Rules.
mutate AddRedBots num
- Adds 'num' bots to the red team at the skill level set in Game Rules.
mutate AddRedBots num skill
- Adds 'num' bots to the red team with a skill of 'skill'. 'skill' has
a value 0 - 7 where 0 = Novice and 7 = GodLike.
mutate AddRedBots name
- Adds the named bot to the red team at the skill level set in Game Rules.
mutate AddRedBots name skill
- Adds the named bot to the red team with a skill of 'skill'.
mutate AddBlueBots
- Same as AddRedBots above, but for the blue team.
mutate KillRedBots
- Same as KillRedBots above, but for the blue team.
For non-Team Games
------------------
mutate AddBots
- Adds a single bot to the game at the skill level set in Game Rules.
mutate AddBots num
- Adds 'num' bots at the skill level set in Game Rules.
mutate AddBots num skill
- Adds 'num' bots with a skill of 'skill'. 'skill' has a value 0 - 7
where 0 = Novice and 7 = GodLike.
mutate AddBots name
- Adds the named bot at the skill level set in Game Rules.
mutate AddBots name skill
- Adds the named bot with a skill of 'skill'.
Note that the team-specific commands may also be used in non-team games.
For example, 'AddRedBots' and 'AddBlueBots' can be used to add bots to the game, and
'KillRedBots' and 'KillBlueBots' can be used to remove bots from the game. These will
act the same as the 'AddBots' and 'KillBots' command respectively.
This is very useful if you are binding keys to BotManager commands and using them in both
team and non-team game types. A key bound to the 'mutate AddRedBots' command can be used
in CTF to add a red bot, but also to add another bot into a game of Mutant. This cuts down
on the number of keys required to bind all useful command for all game types.
For All Game Types
------------------
mutate BotManager
- Bring up the BotManager in-game menu. See the section 'In Game Menus' for
for further details.
The menu stays active until you close it by pressing 'Esc' or clicking on
the close icon on the top right of the menu.
Examples
mutate AddRedBots 3
- Adds 3 Bots to the red team at the current skill level set in Game Rules.
mutate AddBlueBots 1 7
- Add a single GodLike Bot to the blue team.
mutate KillBlueBots 4
- Kill the four lowest scoring bots from the blue team.
mutate AddBlueBots Xan 7
- Add a Godlike Xan to the blue team.
Note on Bot Names
=
When adding bots by name, a different bot name will be used if the name specified is
already in use. e.g. you can only have one bot named 'Xan' in a game.
For example, running the following console commands will create 2 bots, one named 'Xan' and
the second NOT named 'Xan'. The second bot will be created with a name from an internal list
of alternate names.
mutate AddRedBots Xan
mutate AddBlueBots Xan
However, the second bot is created with the 'Xan' model, and all other attributes associated
with Xan - just a different name.
This is a 'feature' of UT2004, and not of my mutator. However, it does make it easier to kill
bots by name as they will all be unique
In Game Menus
=
The menus are used to control the addition and removal of bots from the game.
Adding Bots
-----------
To add a specific number of 'randomly selected' bots, ensure the 'Add/Kill a named Bot'
checkbox is unchecked, and set 'Number of Bots' to the number of bots to be added. Select the
skill you wish the bots to have and press the 'Add Bots' button.
For team games, set the Red and Blue options separately before pressing the 'Add Bots' button.
To add bots to only one team, set the other teams 'Number of Bots' to 0 (zero).
Adding Named Bots
-----------------
To add a specific bot to the game, ensure the 'Add/Kill a named Bot' checkbox is checked.
You may enter the name of the bot into the 'Bot name' edit box, or select the required bot
from the picture gallery of available bots.
When typing the bot name, the gallery automatically selects the bot whos name you are typing.
When the gallery has no bot selected, the name you have entered into the edit box contains
an invalid bot name. In this case, adding a bot will add a randomly selected bot with the name
you entered.
The 'Race' dropdown list contains a list of all the available bot races. Select a specific
race to display only bots from that selected race. Select 'All' to display all bots.
Killing Bots
To kill a specific number of bots from the game, ensure the 'Add/Kill a named Bot' checkbox
is unchecked, and set the 'Number of Bots' to the number to be killed. Press the 'Kill Bots'
button to kill the selected number of bots.
Bots with the lowest score are killed first.
Killing Named Bots
==
To Kill a specific bot from the game, ensure the 'Add/Kill a named Bot' checkbox is checked.
You may enter the name of the bot into the 'Bot name' edit box, or select the required bot
from the picture gallery of available bots.
When typing the name, the gallery automatically selects the bot whos name you are typing.
If killing a bot that had it's name modified upon creation, you can only select that bot by
entering it's name in full - you cannot select the bot from the gallery as it will not be there.
Command Short Forms
===
All the 'mutate' commands described above can be shortened to give you less to type at the
console.
For example, 'AddRedBots' can be shortened to 'AddRed' or 'AddR'.
It works by matching what you type at the console with the list of supported commands. It
finds a match if all the characters you typed appear at the start of the command. In the
example above, 'AddR' appears at the start of 'AddRedBots' and so is accepted as such.
The order in which the commands are processed is below:
So adding a red bot could even be shortened to 'mutate A' as 'A' is matched against the first
entry in the list above.
The shortest form you can use for adding a blue bot is therefore 'mutate AddB', and the
shortest command to display the in-game menu is 'mutate B'.
WARNING: All of this 'shortening' works great if BotManager is the only mutator you are
using. But if other mutators also use the 'mutate' console command, they may interfere
with BotManagers command and short forms.
Known Bugs
==
1. Does not work with 4CTF. I'm sure the guys had to replace a lot of the TeamGame code
to get 4 teams working! And I'm sure that's why this Mut doesn't work
Will probably not work correctly with other game types that have more than 2 teams.
2. There is no 'player quit' message when a Bot is killed in the Invasion gametype.
Instead, the game announces that the Bot 'is out'. Unfortunately, this is how the
gametype treats players or Bots that are killed in Invasion.
Other Stuff
===
Binding some keys to use this mutator makes a lot more useful. I have bound 5 keys to
allow me to add a Bot to the red team, add a Bot to the blue team, kill a Bot from the
red team and kill a Bot from the blue team. The fifth key I use to display the in-game menu.
Christian has also helped with a few issues during the devlopment of BotManager, and put me in
contact with others who have helped with certain features. In particular, Christian was
instrumental in getting BotManager working with 3rd party game types - JailBreak in particular.
-*-
Special thanks too to TOG|neddie>oB< ( nedd3h ) for some great play testing nedd3h continues
to test BotManager in many game types and his efforts are greatly appreciated!
-*-
Special thanks also go out to Ben (AKA ProAsm) for his valuable help in getting the Admin Only
feature implemented. Ben is the creator and author of UT2Vote, and his help with BotManager is
very much appreciated.
Other Thanks
Thanks go out to a number of people who have helped me along the way by answering my silly
UnrealScript-related questions (mainly on the UT forums over at www.ataricommunity.com).
Bonehed316 has helped with many of my queries, and has been a most useful member of the community,
so many thanks to him.
Without some of these people, BotManager wouldn't be where it is now.
Thanks also to the guys over at www.ut2003hq.com for hosting BotManager!
Zielbetrag
