9:02 PM 9/29/2010

Dropper for Unreal Tournament by Mr.Loathsome.  aka Scott Armitage

Spawns Actors when players or monsters are killed.

Features seperate lists for players and Monsters.
Supports up to 255 Actor classes per list.
Allows for setting % of time Actors will be dropped, as well
as the individual odds for each individual Actor.

Tested with Inventory items, Weapons, ScriptedPawns, Flockpawns and Bots.
(*Use of bots with this for actual gameplay is not recommended....)


Install:

1.  Drop Dropper.int and Dropper.u into
    your UnrealTournament\System folder.

2.  Read this entire file.

3.  Read this entire file again, then edit the Dropper.ini file to suit your needs.

WARNING !!!!!!    This is a very powerful and dangerous mutator.

If used incorrectly, you can add way too many items and ruin gameplay, or
generate enormous log files full of warnings that The Dropper will not be held
accountable for.  Or crash your game at an amazing rate of speed.

Example, try setting things up so that when a bot is killed, another bot 
is spawned. Leave the DropFreq at 1.0    Start up a nice DM practice match
with a bot or 2.  When I tested that, the map filled and crashed the game
within 1 minute.

Same would happen if you had monsters spawning more than 1 monster when they
die.   However via use of the DropFreq and SPDropFreq vars and also the DLFreq and
SPDLFreq tables, you can indeed have monsters spawning monsters if you wish and
plan your ini file carefully.

The Dropper cannot be held responsible for errors caused by any ini misconfigurations.

If you configure the file to reference classes that are not available, or cause a
confict with either the gametype you have selected or other mutators being used, those
classes are likely to generate warnings and errors in your log file, and things may
or may not work as you had intended.   This seems to happen most often with weapons.

The Dropper will not be held repsonsible for your poor choice of classes.

If used correctly, The Dropper seems to perform very well.

A Dropper_Blank.ini template and several example ini files are included.
Copy one of those to your System folder, rename it Dropper.ini and edit as
you wish.

Note the drop frequency variables in the examples are probably set a bit high for tesing.

Dedicated servers add Dropper.DeathDrop to the mutators= section of
your server line.    The Dropper mutator is not needed in the
ServerPackages section of your UnrealTournament.ini, however the
packages that contain any classes you are having the Dropper spawn
do need to be included there.


Configuration variables:

NumItems:  Total Number of classes in the DropList array used by Players and Bots.

NumDrops:  Number of items from the list to drop.

SPNumItems:  Same as NumItems above, but for the SPDropList array used by ScriptedPawns. (Monsters)

SPNumDrops:  Ditto.

bRandMode:  If True, items will be randomly selected from the list.  Dups are possible if
NumDrops > 1.   If False the mutator will drop items sequentially starting with element [0].

bSPRandMode:  Same as above but for the SPDropList.

bFRotate:

  If true, some Actors will rotate if their class allows that, if false, they wont....
Note, settings in the gametype and/or class itself may override this in some cases.
Recommend setting False.

bSuicideDrop:

  If True spawning will occur when a player or scriptedpawn kills himself.
Recommend False.

bDebugMode:

If True a line will be logged when an item is spawned, and you will also
get a line when a item is unable to spawn for whatever reason.
The mutator will make 8 attempts to spawn an item before it moves onto the next.
Recommend True until you are sure the Dropper.ini is working the way you want.
Then set it to False.

The following applies for all the Freq variables.

1.0 = Every death will drop.
0.5 = 1/2 will drop.
0.1 = 1 out of 10
0.01 = 1 out of 100


DropFreq:

   Percentage of player/bot deaths that will result in Actors being spawned.

SPDropFreq:

   Same as above, but for scriptedpawns.  (Monsters)

The DropList and SPDropList arrays are the classes to be spawned and the
DLFreq and SPDLFreq arrays contain the individual odds of each class to spawn.

Note, if nothing spawns but SearchLights and Dispersion Pistols or ImpactHammers, this
indicates your Dropper.ini file is either missing or borked up beyond comprehension.

The Dropper can't help you if you lose or bork up your ini file.... 

Enjoy !


You may use and modify this code for your own personal use.
Any modifications for redistribution or commercial use require permission of the author.

(c) 2010 Scott A. Armitage