Vehicle Invasion Mod/mutator for UT2004 version 1.16
Author: -=Musc@t=-
website: http://membres.lycos.fr/unrealmuscat/
First alpha: UT2004 demo release date
Last update: December 10, 2004

Instruction:

You don't need a specific version of the satoreMonsterPack or other packages to be able to lock on new monsters now because you have some new options: flying/non-flying monsters with specific minimum health in the menu.
Here is the satoreMonsterPack author web site: http://hp.vector.co.jp/authors/VA026071/Downloads.html

The mutator is compatible with the old UT2004 versions but the last UT2004 patch fix important Invasion and OnSlaught stuff used by this mutator.

Please don't rename maps to Ons- maps.
The mutator has a maplist editor supporting all maps now. 
Under "Web Admin" you can use this method also: http://membres.lycos.fr/unrealmuscat/mapvote113.htm 

Don't forget you need to add the Raptor Invasion and Avril Invasion mutators to be able to lock on monsters,
It's include in the package but not in the gametype.

The gametype configuration is in the mutator configuration so "gametype" users need to edit the mutator config to change the health, etc.

Installation
-------------
Remove the old .u version.

Copy all files in your ut2004\system directory

fr: Enlever le .u de la version antrieure. Copiez tous les fichiers dans le repertoire ut2004\system

Configure the Raptor and the AVRiL Invasion mutators by pressing the configure mutators button and choose the monsters you want to be targeted.
By default it's non-flying monsters with 200 health + and flying monsters with 150 health +.

Configure the Vehicle Invasion mutator or Vehicle Invasion gametype by pressing the configure mutators button also.
Gametype user note: You don't need to add the Vehicle Invasion mutator in the mutator list to play the Vehicle Invasion gametype
                    but you need to add the mutator to configure it. Remove it from the list after.

Colored stuff and double Vehicle Invasion in the browser.
---------------------------------------------------------
If you don't like the colors added in the menu you can edit the VehicleInvasion-115.ucl to remove it.
Delete the VehicleInvasion-116.ucl if you don't want the gametype version and at the same time the color. (This solve the double Vehicle Invasion in the browser or in the WebAdmin Gametype selection)  
if you want the original colors or the gametype selection again you need to install the VehicleInvasion-116.ucl include in the zip or umod package.
The double Vehicle Invasion in the browser is the price to pay to be able to Hack the main menu to see all maps in the gametype maplist.
You don't have 2 times the same gametype, it's just a fake to hack the menu until perhaps Epic fix this maplist bug.
If one day the problem is solved, you will be easily able to fix that by deleting the VehicleInvasion-116.ucl or the game fake line in the VehicleInvasion-116.ucl.


server admin:
-------------
If you run a dedicated server and use web admin you need to use the specific VehicleInvasion-116.ucl for webAdmin or remove the game hack line in the VehicleInvasion-116.ucl.
You need to add this line in your UT2004.ini [Engine.GameEngine] section

ServerPackages=VehicleInvasion-116

and if you want to create a server using the new ECE Bonus Pack
ServerPackages=CicadaInvasion
or/and
ServerPackages=CicadaStuckFix


if you don't want to use the Cicada Invasion version for any reason. 
(factories Stuck problem in VCTF-BloodGluch and VCTF-UP-LonesomeGlen-SE for example)
You can replace the CicadaReplacementClassName in the VehicleInvasion.ini by "CicadaStuckFix.DualAttackCraftFix"


Because some map use different gametype content other than the standard gametypes,
you need to add the name of the .u package of each custom gametype the map is dependant also.
For example JB maps need the Jailbreak .u packages, FHI maps need all FHI .u packages, etc.
example:   ServerPackages=Jailbreak  for the Jailbreak.u


For server using the mutator only (not the Vehicle Invasion gametype)
--------------------------------------------------------------
if you just want to test the mutator and don't want to lose your time with the config
try to start with this config (for 3 players with vehicles).
if you don't want to search the monsters in the map, Adding skills to the monsters is important also.

you can change these values in the Invasion gamerules tab also.

fr: ajouter/remplacer les lignes suivantes dans votre UT2004.ini si vous utilisez le mutator et ne voulez pas perdre votre temps a configurer des waves.

Add / replace these lines in you UT2004.ini

[Skaarjpack.Invasion]
WaveConfigMenu=GUI2K4.UT2K4InvasionWaveConfig
FallbackMonsterClass=SkaarjPack.EliteKrall
InitialWave=0
FinalWave=16
Waves[0]=(WaveMask=20575,WaveMaxMonsters=15,WaveDuration=90,WaveDifficulty=1.750000)
Waves[1]=(WaveMask=24828,WaveMaxMonsters=16,WaveDuration=90,WaveDifficulty=1.800000)
Waves[2]=(WaveMask=25592,WaveMaxMonsters=16,WaveDuration=90,WaveDifficulty=1.900000)
Waves[3]=(WaveMask=34558,WaveMaxMonsters=16,WaveDuration=90,WaveDifficulty=2.000000)
Waves[4]=(WaveMask=10232,WaveMaxMonsters=18,WaveDuration=90,WaveDifficulty=2.100000)
Waves[5]=(WaveMask=18428,WaveMaxMonsters=18,WaveDuration=90,WaveDifficulty=2.200000)
Waves[6]=(WaveMask=48884,WaveMaxMonsters=18,WaveDuration=120,WaveDifficulty=2.300000)
Waves[7]=(WaveMask=4082,WaveMaxMonsters=20,WaveDuration=120,WaveDifficulty=2.400000)
Waves[8]=(WaveMask=3835,WaveMaxMonsters=20,WaveDuration=120,WaveDifficulty=2.500000)
Waves[9]=(WaveMask=3924,WaveMaxMonsters=20,WaveDuration=120,WaveDifficulty=2.600000)
Waves[10]=(WaveMask=11872,WaveMaxMonsters=22,WaveDuration=180,WaveDifficulty=2.700000)
Waves[11]=(WaveMask=4032,WaveMaxMonsters=22,WaveDuration=180,WaveDifficulty=2.800000)
Waves[12]=(WaveMask=3612,WaveMaxMonsters=22,WaveDuration=180,WaveDifficulty=2.900000)
Waves[13]=(WaveMask=3584,WaveMaxMonsters=24,WaveDuration=180,WaveDifficulty=3.000000)
Waves[14]=(WaveMask=2304,WaveMaxMonsters=24,WaveDuration=180,WaveDifficulty=3.000000)
Waves[15]=(WaveMask=2048,WaveMaxMonsters=24,WaveDuration=255,WaveDifficulty=3.000000)
bAllowNonTeamChat=False
FriendlyFireScale=0.000000
NetWait=5
bForceRespawn=False
bAdjustSkill=False
bAllowTaunts=True
bAllowTrans=True
SpawnProtectionTime=2.000000
LateEntryLives=1
LoginMenuClass=GUI2K4.UT2K4InvasionLoginMenu
bAllowPrivateChat=True
bWeaponStay=True
bAllowWeaponThrowing=True
ResetTimeDelay=0
GoalScore=60
MaxLives=1
TimeLimit=20

If you want to be able to use multiple map types in WebAdmin for mapvote:
It's now really easy with the version 1.13+. Just choose the Vehicle Invasion gametype/maplist 
and check the 'Invasion Server' option in the Vehicle Invasion mutator config and  add all map prefixes in the prefix box or nothing.
If you use WebAdmin or simply use the mutator for a dedicated server: Don't forget to install the webAdmin VehicleInvasion-116.ucl and not the one include in the VehicleInvasion-noUmod.zip or Ut4mod.


Thank you
----------
Thanks to Wes for running and testing the mutator since the first beta version and to all the many admins and players using/playing VI now.
Thanks to all the Vehicle Invasion Fans in the MyUnreal BBS and from different other web sites for the suggestions and feedbacks.
thank you ->you for downloading and playing vehicle invasion.
 

Other Mutators used with this one
----------------------------------
UT2004RPG.
Bersek or Bersek fixer.
Regen.
Quadjump.
Ejection.
CHute.
Wheeled Vehicle Stunts.
Unlimited Translocation 2004 (TLMutator v1.x for UT2004)
Excessive 3.0.
Chaos UT mutators.
ZenCoder's Weapons 2.03
TLMutator 3.01 
InvasionMutator
SMPMonsterConfig (sator monster pack config)
BonusVehicles 1.02a
Master Of Factories (soon)

Available monster packs
------------------------
SatoreMonsterPack v1.18 for UT2004.
Invasion Kang
Invasion Parser
U4E 2 monsters
C502Invasion
Alien invasion
FaceHugger
Evil monsters
and more....


version 1.16   
-----------------
AVRiL and Raptor rockets can lock-on flying monsters/non-flying monster with specific minimum health.
Momentum scaling for flying vehicles and non-flying vehicles

version 1.15   
-----------------
Now you can change the fixed Cicada Class Name in the VehicleInvasion.ini
Health Chargers are added in map without health charger.
Fixed Raptor Invasion Crosshair (for old and new UT2004 patch)

version 1.14   
-----------------
When you start with the vehicle Invasion gametype now the mutator always use the vehicle Invasion maplist in standalone.
Auto Turrets are disabled in Navy maps like VCTF-NavalCombat.
vehicle Invasion Mutator auto added if the "Invasion server" option is checked. (note: use this option if you have a dedicated Invasion server with only one mapvote gametype selection using the vehicle Invasion maplist)
Cicada replaced by a fixed Cicada.
It's now possible to play in AS-Acatana. 

 
version 1.13   
-----------------
Option 'Invasion Server' added for server admin using the mutator with the VehicleInvasion maplist. 
The server always stay to the standard Invasion gametype with this option enabled.
So now it's very easy to create a vehicle Invasion server you can see in the Invasion section of the browser.
This option is only available in the mutator option in the server config menu or under WebAdmin. 

version 1.12   
-----------------
maplist configuration (with all maps) added in the mutator menu and in the gametype menu.
Use the current gametype maplist by default for the standalone mutator users.
BR goal lights coranas disabled online.
Better description in the menus.
Some options removed like allowing Health addition, allowing shield addition not really useful after all.
Removed Remove/Hide stuff in map option. Why using this mutator if it's not for that! :D
Force default weapons ultra option added in the mutator menu for maps with standard prefix and custom weapons. 

version 1.11
------------
fixed: 'Force Default Weapons' exchange weapons and ammo in standard map
Remove instagib weapons option added.
hidden option 'Force Default Weapons ultra' for map with standard prefix but custom weapons added (VehicleInvasion.ini)

version 1.10
------------
Now really all Auto Assault turrets are removed in Assault maps.
Now really All PowerCores / shields are removed in Ons maps including Ons-Crossfire.
Now really All BR xEmitters removed in BR maps. online.
Filter in Weapon selection for the AVRiL Invasion mutator. (Official Weapons first and (mod) added after custom weapon name)
Force default weapon completly recoded (sorry for the experimental ugly bugged version  )
Better ASsault maps support.
Force Default Vehicles option added to try to force default vehicles in map with modified vehicles using the original UT meshes.
support for mixed Raptor Invasion and Force Default Weapon option.
config in a VehicleInvasion.ini 
some other minor fix.  


version 1.09
------------
Avril and Raptor Invasion mutator detect the satore MonsterPack version (beta release not supported, please update it).
You can play in JailBreak maps now.
More Assault maps supported including AS-MotherShip.
Monsters have 50% chance to be spawned at monsters spawn points in FHI maps.
Flag base removed in CTF maps.
Goal Emitters removed in BR maps (Online like offline).
Added: Remove/Hide stuff in map option.
Added: Use Vehicle Invasion Maplist option.
Section added in WebAdmin for mutator configurations.
some other minor fix to reduce the log spam.

version 1.08b
------------
fixed Shield / Health exploit with the speed combo.

version 1.08
------------
final touch with some fix for the Shield / Health config.

version 1.07
------------
Fixed: 'Force Default Weapons' is fonctional now (please don't try to replace weapons with this option checked)
	for example: Force default Weapons is useful to play in FHInv maps with default UT2004 Weapons and vehicles setting.  
Fixed:  AVRIL Invasion Ammo replacement  (little error in the code)

version 1.06
------------
AVRIL and Raptor can lock on satoreMonsterPack2004_v1b monsters and AlienInv monsters
You can add / increase  players health and the vehicles health.

version 1.05a
------------
fixed: some spam in the log

version 1.05
------------
 Avril Invasion (lock on Monsters) mutator.
 Raptor Invasion (lock on focused Monsters) mutator.
 Vehicle Invasion mutator. 
 Vehicle Invasion mod.
 You have the choice now.
 The mutator convert different maps type to Invasion.

version 1.04
------------
integrated Avril lock on Monsters mutator (config include to choose the monster type)
lock on Monsters added for the Raptor also (test phase)
some AS maps can be played with the mutator now (you need to forget the spaceship map)

version 1.03
------------
now the turrets are powered like the first release.
Some errors spam in the log removed. (can't remove all)
I added the map converter code in the mutator so
now all map types (except CTF and AS) are converted to DM or inv maps by removing stuff.


version 1.02
------------
user friendly version. You can choose any gametype in the menu and the mutator
convert the gametype to Invasion.


version 1.01
-------------
The mod is now based on a mutator so the experimented admin
 can setup a standard invasion server with vehicles. (using standard Invasion waves and maplist)
fixed stuff: mysterious locked vehicles in ONS-Crossfire are now unlocked


Enjoy!
Amusez-vous bien!

-----------------------------------------------------
Copyright, permissions
-----------------------------------------------------
Copyright 2004 by -=Musc@t=-.  All rights reserved.

Authors may NOT use this mod as a base to build additional
mods, mutators, levels, or other content without our expressed, 
written permission.

You are NOT authorized to distribute this mod EXCEPT in its
original, unmodified form with THIS file attached in its original,
unmodified form.

You are NOT authorized to charge fees for the sale, use or 
distribution of this mod without our expressed, written 
permission.  This includes, but is not limited to, compilation 
CD's, disks or software bundles.

--------
Unreal Tournament 2004 2004 Epic Games, Inc. Raleigh, N.C. USA. 

Unreal is a registered trademark of Epic Games, Inc. ALL RIGHTS RESERVED. 
All other trademarks are the property of their respective owners. 

--------
This map/mod is not supported by Atari, Epic, or any such parties'
subsidiaries.