-------------------
GENERAL INFORMATION
-------------------

Authors:  Joseph 'Jackrabbit' James Jacklin Jr.
Email:  quadj130@gmail.com
Website:  http://www.UDHQ.org
Finish Date:  Alpha Release (not finished)
Release Date:  2/19/14
Last Update:  2/23/14
Archive Filename:  UBS.zip
Modification Filename:  UBS.u
Modification Size:  172KB
Version:  Alpha
Build Number:  1.2


------------------------
MODIFICATION INFORMATION
------------------------

Botmatch:  No
Teamplay:  Yes
Single Player:  Yes
Multiplayer:  Yes.  Currently untested, but will be adjusted to work for MP in beta version.
Difficulty:  None
Dependencies:  None
New Textures:  No
New Sounds:  No
New Music:  No
New Weapons:  No
New UnrealScript:  Yes
New Meshes:  No
External DLLs:  None


-------------------------
COMPATIBILITY INFORMATION
-------------------------

Direct3D:  Yes
OpenGL:  Yes
Glide:  Yes
3DFX:  Yes
Software Rendering:  Yes

------------
CONSTRUCTION
------------

Build Time:  ~1 week coding/testing
Editors Used:  Unreal Gold Editor
Known Issues:  None.  Unreal Gold Rox.


------------
INSTALLATION
------------

ZIP/GZIP/TGZ/TAR/GZ (Universal):

Unzip UBS.zip by following the guide below. Make sure you choose the correct guide corresponding to your game(s).

Guide (Unreal, Unreal II, XMP, UT, UT2003, UT2004, UER & UE2R):
*.unr, *.un2, *.ut2, *.uer and *.ur2 files go in Maps\
*.utx files go in Textures\
*.umx, *.con and *.ogg files go in Music\
*.uax files go in Sounds\
*.u, *.ucl, *.int and *.ini files go in System\

-----------
DESCRIPTION
-----------

Unreal Buddy System is a mod which currently allows for one Male companion to fight along side you in any
stock/custom map(s).  This mod was inspired by the companion system in Fallout 3 and Fallout: New Vegas.
Without those games this mod would not exist.  

					Thanks Bethesda!
-----
USAGE
-----

Hit the tab or ~ key to open console and type "summon ubs.maletwobuddy" (without quotes) to recieve your buddy.  Only a 1 buddy maximum
at this point.  If your buddy dies in combat you can now summon another one to replace him w/o any trouble :)


-----
NOTES
-----

-Unreal's stock bot/scriptedpawn AI isn't really all that badly scripted afterall...
 Thanks Steve Polge!

-If your buddy gets you stuck in a corner for whatever reason and you can't escape,
 switch to your DispersionPistol and shoot him once to turn him around and get out of the
 way to set you free :)

-Buddies will automatically collect nearby reachable inventory while in their Waiting state.

-Buddies are currently NOT seen by ScriptedPawns and ScriptedPawns will NOT fight back.  Watch out for Titan rocks though :D

-Buddies are given 200 health by default and can reach up to 200 with a standard health pack or any other healing item.

-------
TESTERS
-------

Just me so far.


-------
CREDITS
-------

Just me so far.


---------
CHANGELOG
---------
2/27/14:
^ Changed overall Buddy AI functionality in the Tactical, Charging and Hunting states to better suite fighting Unreal's Scripted Pawns.
+ Buddies now dodge enemy projectiles and can actually fight Titans now :)
+ A New Inventory item "Buddy Armor" is automatically spawned which will teleport him out of harms way when he falls into any damage zone.   


2/25/14:
! Buddies can keep picking up health packs in levels without reaching a MaxHealth.  A buddies health also travels between levels. 
  Default HP value is still 200.  Adjusted for harder difficulties and/or harder campaigns with extra health packs.
+ Buddies now do a trace to their Target/Enemy before they fire their weapon to see if their Master is in the way before they shoot.
  It doesn't work 100%, but it's pretty damn close.


2/22/14:

+ Added Wandering state for Buddies that have no Master set yet.  This means mappers can now place buddies in their map without any issues.
! You can now directly summon "UBS.MaleTwoBuddy" to get your buddy instead of summoning the inventory item first.  Either way works though.
! JumpFromWallAdjust has been tested more thoroughly and now is a Byte datatype instead of a Bool.
* Some random access-nones.  Still more to deal with though.
! Buddies don't shoot Nali anymore.
* If your Buddy dies, you can now replace him without issues.
+ Added mutator UBS.UBSMut as per requested by Dr.Flay.  Hasn't been tested in mutator menu of UT99 yet as I don't have a working copy.

2/20/14:

! Buddies will now teleport to the player when they missed a lift ride.
* Fixed obscure telefrags when Buddies setLocation to their master in special cases.
+ Added "StuckAtWallLoc" vector to speed up teleporting to a player when a buddy gets stuck at a wall.
+ Added "bJumpFromWallAdjust" (experimental) to prevent infinite wall adjust loops with also
  the added benefit of a Buddy "unstucking" himself in many cases.  *Further testing required*

----------------
CHANGELOG LEGEND
----------------

* Fixed
+ New
- Deleted
! Changed
@ Renamed
# Restored
^ Remastered


-----------
PERMISSIONS
-----------

YOU MAY use this modification as a base with my explicit permission.

YOU MAY NOT put this modification on a commercial CD/DVD/Blu-Ray/HVD/Floppy/ZIP Disk/Storage Cassette/USB Thumb Drive/Memory Card without Epic Games, Inc. permission!

YOU MAY convert this modification to another game other than Unreal/Unreal Tournament/Gears of War/Unreal Development Kit without my explicit permission.

YOU MAY NOT bundle this modification in your mod without my explicit permission.


---------
COPYRIGHT
---------

UnrealBuddySystem is Copyright  2014 by Jackrabbit.


------------
LEGAL NOTICE
------------

Unreal, Unreal: Return To NaPali Mission Pack and Unreal: Gold Edition  1998-2003, 2006, 2008 Epic MegaGames, Inc. and Digital Extremes.  All Rights Reserved.  Published by GT Interactive Software, Inc., Infogrames, Inc. and Atari, Inc. under license.  Distributed by Valve, Stardock and GOG.com.  Unreal, UnrealEd and the Unreal logo are registered trademarks of Epic MegaGames, Inc.  All other trademarks and trade names are properties of their respective owners.

