B O T  -  H A N D L E R

Description

Fourth public beta of my Bot Handler program, the purpose of this Java application is to easily manage and randomize the properties of the Bots of an Unreal Tournament game.
UT has lots of different skins and variations, but the in-game menus to change the Bot configuration are clunky and slow to use. Since I got tired of always playing against the same bots, I decided to write a Java program to handle quickly the properties of the bots.


First of all a reminder, MAKE A BACK UP of any file you intend to load or overwrite (mostly the User.ini file) with this program. I tested this program myself on both Linux and Windows and I think that it is fairly stable and functional, but it is still incomplete so I am not responsible for any kind of data loss.


There are many changes in this version, most important being a different behaviour for custom content entries. You can now enable a lot of custom content simply using the Folder Scanner, you can change the name lists directly from the program, and you can even import new custom content entries from your User.ini File.

The program now uses the default Look & Feel of the system, which looks much much better on Linux. I also fixed and changed many minor things to make the application more stable.

Check the Change Log for a more or less complete list of the changes from the previous version.


Enjoy

Installation

Unzip BotHandlerV080, then copy the files in a folder of your choice.

Then either double click the BotHandler.jar file, or right-click on it and select "Open with Java Runtime Environment".

You will need the Java Runtime Environment (JRE) to open this program, you probably have it already installed but if that's not the case you can download it at www.java.com.

If you have Java installed but the program is not starting up make sure that the BotHandlerSettings.utbh file is located in the same folder as the BotHandler.jar file.


If you are running it from an Ubuntu installation be aware that starting the JRE from the normal explorer interface (Nautilus) will cause the Java root directory to be set to your Home folder, so you would need to place the BotHandlerSettings.utbh file into your Home folder for this program to run.
To overcome this you can open a Terminal, browse to the directory where you unzipped Bot Handler and then run the program using the command:
   java -jar "BotHandler.jar"

How To Use

There is a BotHandler-Manual.txt text file in this zip that has detailed instructions on how to use this program.
I will however paste here the Quick Start section, which should be enough to get started using the program.


Once the program is started there will not be any bot list loaded, so the two most common operations are either generating a new list from scratch or importing your Unreal Tournament bot list to modify.

Creating a new bot list from scratch is simple:
 1) Enter in the Generator tab
 2) Scroll down to the bottom of the window
 3) Click on the GENERATE button.

A new list of bots will be created and shown in the left column of the window.
You can then click on the Properties tab to access a window where all the parameters of the selected bot(s) will be shown.



To import the bot list from your Unreal Tournament game you have to:
 1) Click on the File menu
 2) Click on "Import from User.ini File"
 3) Browse to your Unreal Tournament System folder
 4) Select your User.ini File

After clicking the OK button the bots will be imported and shown in the left column.



Once you are done modifying the bots and you want to export the local bot list into your UT game, you can do so by:
 1) Click on the File menu
 2) Click on "Export to User.ini File"
 3) Browse to your Unreal Tournament System folder
 4) Select your User.ini File (I recommend making a backup!)
 5) After clicking the OK button a confirm dialog will appear, select Yes to complete the operation

The bots will now be available in Unreal Tournament.

Details

Change Log

- The GUI now uses the default system Look&Feel instead of the Java Metal theme
- Classes/Skins not included in the BotHandlerSettings file can now be imported when loading an user.ini file.
- Added a Folder Scanner (to enable automatically the custom skins)
- Added a Name Editor
- Added lots of custom models and skins in the settings
- Some information now gets guessed if it is missing from BotHandlerSettings.
- The BotHandlerExtra setting has been merged into the main settings, as now you can use bEnabled to choose what to load.
- Added an XBots tab. Now you can import the Bot Handler bot list from the XBots file.
- Generating a full XBots list will fill out the Bot Handler list if it was empty.
- Added an Update BotHandlerSettings.utbh button
- Added an Overwrite Global Settings section
- Added error dialog when the Settings file has not been found on startup
- Added error dialog preventing generation when there are no classes or skins loaded
- %yN(T1,T2) Conditional switch, %mN(T) Conditional Duplicate, %M(T) Text Duplicate

- Fixed String Out Of Bounds when part of a wildcard's text is missing (now gets replaced by "ERROR")
- Fixed Index Lists in the Log being one lower than the actual indices.
- Fixed program failing to launch when there are too many classes/skins/Faces/NickNames/Weapons (higher than its limits).
- Fixed program limits specified in the Settings File not being taken into consideration as they should have.
- Fixed program errors when loading/importing bot lists with classes/skins not included in the BotHandlerSettings file.
- Fixed Null Pointer Exception when trying to load an improper file with the Load and Import User.ini File functions.
- Fixed rare ArrayOutOfBounds when MAX_TYPES was bigger than MAX_SKINS.
- Fixed a very rare Settings Importer internal error being printed on standard output.
- Fixed an "Integer cannot be cast to Float" exception when setting a Min or Max Spinner value of 0 with the Set Spinner Values window

Credits

Thanks to all the developers behind Java for this wonderful language, and behind NetBeans IDE for this great powerful free program.

Copyright

This software is copyright 2012, by DeathoX 8.
I am not responsible for any loss of data or any kind of damage resulting from the use of this software. This is an experimental build, and you are using it at you own risk. This software is freeware and does not have any kind of warranty.
You may NOT decompile this software or use it as a base for any other additional software.
You are NOT allowed to commercially exploit this software, i.e. put it on a CD or any other electronic medium that is sold for money without my explicit permission!
You MAY distribute this software through any electronic network (internet (web/ftp), FIDO, local BBS etc.), provided you include this file and leave the archive intact.
Unreal® Tournament (c)1999 Epic Megagames, Inc. All Rights Reserved. Distributed by GT Interactive Software, Inc. under license. Unreal Tournament and the Unreal Tournament logo are registered trademarks of Epic Megagames, Inc. All other trademarks and trade names are properties of their respective owners.