Authour - FlakMagnet
Build time - ~46 hours (first time with Unreal Scripting)
Release Date - 07/06/2005
Size - ~15K
Version - 6
*****************
*** 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!
New features for Version 6
==
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. 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 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.
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 replaced upon creation, you can only select that bot by
entering it's name - 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 is 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.
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.
Zielbetrag
