What's it all about?
-------------------
Ever wonder why bots do what they do? Especially when you think they should be doing something else? This mutator will allow you to explore the inner workings of a bot's mind. Such as it is.

The best way to use this mutator is as a spectator.. because otherwise you'll be too busy shooting to make use of it. You can use it in the regular flying-camera mode, or by switching to spy on individual bots. If you do the flying-camera thing, then you'll get data on whatever bot you're looking at, as an extension of the player name that always pops up when you look at someone.

The readout is as follows:

- State: Every object in UnrealScript has states; bots have states like "Fallback", "Retreat", "Falling", and "Dying".
- Move Target: This is usually the nearest pathnode that the bot is moving towards, and it can also be an item that the bot is about to pick up.
- Enemy: Whoever the bot's designated target is.
- Orders: Defending, Attacking, Following, etc.
- Real Orders: The actual orders that have been given to a bot. This can sometimes be different from it's working orders, above. For example, if it's told to defend, but there's nothing to defend, it may decide to do something else for the time being.
- Order Object: The thing or player the bot was told to defend, or follow, or whatever.
- Goal: This text string is updated sporadically as a general indicator of what the bot is doing. It often becomes obsolete long before it gets updated, but it still can be useful.

Also, you will see frames appearing around certain objects:

Red crosshairs: Enemy.
Green box: Order Object - remember, could be a player, could be a thing.
Blue box: Move Target - this is usually a pathnode, which you otherwise can't see. It may also be an item that the bot wants to pick up, or the player that the bot is following.
Blue cross: Destination - the location that the bot is trying to reach. Usually the location of the Move Target, unless the bot is doing evasive/tactical maneuvers.
Yellow boxes: Route Cache - the pathnodes that make up the route that the bot is following.


Why is it cool?
--------------
This thing can be very useful when you're trying to tweak bot behavior in mods and maps. It lets you discover things like, are they picking the right spots to defend? Why do they go there? How are my paths working? Junk like that.


Setup
-----
Just drag the MindReader.u and MindReader.int files to Unreal Tournament's System directory, and then pick the Mind Reader mutator when you start a game.


More to come
------------
I plan to add a few more fancy things, like locking on to a bot in free camera mode (so the data doesn't fade out when you're not looking at the bot), or instantly jumping to points of interest like whoever just grabbed the flag.


Thanks
------
The frames were accomplished by copying code from ITSHUD from Unrealistic (http://www.planetunreal.com/unrealistic).


About the man
-------------
This mutator was created by David Catmull. You can e-mail me at uncommon@uncommonplace.com. Or you can explore my website at http://www.uncommonplace.com/
