//=============================================================================
// Unreal Upgrade (Mutator for Unreal One)
// Gerald Lance Tindall aka. <NDP>BOZO aka. {KDS}BOZO
// CODE NOT FOR REUSE WITHOUT PRIOR PERMISSION OF THE AUTHOR
// January 6, 2006
//=============================================================================

==========================
Version Info
==========================
Code included for Unreal Upgrade Ver 0.1 BETA 

This is the first public BETA Release. NOTE: Please limit the release to simple testing since this should be seeing updates quite consistently in the future until all weapons get updated.

==========================
Overview 
==========================
This project was implemented to update the standard Unreal One weapons and to support some new capabilities.
Generally, the updated weapons should operate nearly identically to the existing weapons, just better.
Currently, a single Weapon (AutoMag) has been implemented so far. Most of the base code has been fully developed at this time.

The new functionality available to the weapons will consist of the following items:
1) Zone Entry/Exit Events will be triggered by all weapon fire.
2) Instant Hit Weapons (AutoMag, Minigun, Rifle, and ASMD Alternate) will now operate correctly through Warp Zones.
3) Water, Lava, Slime, and Tar Zones will now slow down the passage of projectiles and reduce their damage FX accordingly.
4) ZoneFluidFriction and ZoneGravity will now affect projectiles inside fluid filled zones (bWaterZone=True).
5) Effects in water and out of water are now different.
6) Sound in water and out of water are now different.
7) FX projectiles such as ShellCases also now follow the new rules.
8) Reflection off of walls is now an option.
9) Most FX now implemented Client Side only. Improved Network support.

Thanks KDS for hosting the Unreal One development website!

==========================
General Notes 
==========================
I was playing around with a new Electricity Zone (for Crystal Castles) and delved pretty deep into why some of my weapons were not setting off some FX that I was trying to implement when I realized that none of the Unreal One weapons were set up quite the way I wanted them to be. I also then discovered that warp zones and instant fire weapons don't work together at all. This of course got me fired up to fix all of the little details and make the weapons actually operate in a more "real world" manner. This is the result.

==========================
Files Included
==========================
UnrealUpgradeVer0_1.txt - Help File.

UU_BugList.txt - Help File - lists known bugs.

UU_VersionHistory.txt - Help File - lists version changes.

UnrealUpgrade.int - System File - Mutator configuration file.

UnrealUpgrade.u - System File - The new implementation code.

==========================
Installation
==========================
Extract the UnrealUpgrade.u and UnrealUpgrade.int files to your Unreal\System directory.

------------------------------------------------------------------------

Open up your Unreal.ini file located in the Unreal\System directory.

Find the ServerPackages lines.

After them add:
ServerPackages=UnrealUpgrade

Save the file.

------------------------------------------------------------------------

Add the mutator line:

mutator=UnrealUpgrade.UpgradeWeaponMutator

to your server start command line.


------------------------------------------------------------------------

UnrealUpgrade is now installed and can be run automatically when your Unreal server is restarted.


Currently, the mutator replaces the AutoMag with the UU_AutoMag, the Minigun with the UU_Minigun, and the Rifle with the UU_Rifle.
In the future I plan on making this a nice configurable mutator but since this is a beta release I didn't bother.

===========================
Operation
===========================
You can summon the new Weapons directly by going to the console and typing

Summon UnrealUpgrade.UU_AutoMag

Summon UnrealUpgrade.UU_Minigun

Summon UnrealUpgrade.UU_Rifle

or running the mutator on a server.

===========================
Recommendations
===========================
Do not embed these weapons in your new levels. Run the mutator to autoreplace them at runtime.

==========================
Current Changes 
==========================
Review the UU_VersionHistory.txt document for details.

===========================
Known Bugs
===========================
Review the UU_BugList.txt document for details.

===========================
Future Plans
===========================
Got all kinds of plans in the works...

A full replacement of all Unreal One and Unreal Gold weapons to support the listed capabilities above.
The creation of a working Quadshot supporting the listed capabilities above.
A nice new flamethrower as a bonus weapon.

Maybe tackle the RealCTF weapons? Infiltration weapons? Serpentine weapons?



===========================
Thanks!
===========================
Greetings from the BOZO:

Gerald Lance Tindall aka. {KDS}BOZO aka. <NDP>BOZO aka. LordBozo

Thanks to Rick Watts aka {KDS}Rewind for hosting our development website, ftp, and forums.

===========================
Contact Me!!
===========================
Please help make this a better mod!
Email any problems you find or suggested features to bozo@kds-clan.com
If you want to help out just let me know!
Thanks!!  

===========================
Disclaimer
===========================
If this causes problems on your machine - sorry but thats the way it goes. Send me info on your system and a description of what occured. Also your Unreal.log, Server.log,
and Unreal.ini files and I will try to figure out what occured.

===========================
Copyright / Permissions
===========================
This game modification and all code is copyrighted by the author.

Authors may use the included weapons as a base to build map levels provided no modification or extraction of the objects are made to the code.

You are NOT allowed to commercially exploit this gametype, i.e. put it on a CD
or any other electronic medium that is sold for money without our explicit
permission!

You MAY distribute this zipfile through any electronic network (internet,
FIDO, local BBS etc.), provided you include this file and leave the archive
intact.

If this weapon is included in a pack (i.e. bundled with several other maps/gametypes in
one zip file, this text file must be included.

----------------------
UNREAL (c)1998 Epic Megagames, Inc.  All Rights Reserved.  Distributed by
GT Software, Inc. under license.  UNREAL and the UNREAL logo are registered
trademarks of Epic Megagames, Inc. All other trademarks and trade names are
properties of their respective owners.
  