
-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
 Super Spawner Script
-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
 Version 1.1
-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
 Created by: CoMPuTer MAsSteR [.:AKA:.] CoMPMStR



Here it is, yet another spawner script.. or is it? This script allows you to spawn vehicles and peds alike. Not only can you spawn vehicles and peds, you can also alter them in different ways upon spawning them.

Some of the ways you can alter peds is by giving them different tasks. Those tasks include:

 - Stand Still: Spawns the ped and they won't move, maybe a little.
 - Flee Player: Spawns a ped who's scared of you and runs away.
 - Flee Player Then Fall: Spawns a ped who's scared of you and runs away, but then trips and falls some time later.
 - Defend Player: Spawns a ped that will defend you to the death. You can only have 7 that will defend you.
 - Fight Player: Spawns a ped that will fight you to the death.
 - Follow Player: Spawns a ped that will always try to get close to you. They will stop of you're too high or low.
 - Wander Around: Spawns a ped that just walks around the city.
 - On Fire: Spawns a ped on fire. If you spawn more than 3 or 4 peds before they die, the subsequent peds will run away on fire.
 - Ragdoll: Spawns a ped that gets slung to the ground, thus resulting in them falling over as a ragdoll.

Some of the ways you can alter vehicles is by giving them different characteristics. Those include:

 - Normal: Spawns a normal vehicle with no special attributes.
 - Invincible: Spawns a vehicle with all proofs enabled (bullet, fire, explosion, damage, and melee). You may still receive visual damage.
 - Hazard Lights: Spawns a vehicle with it's hazard lights constantly blinking.
 - With Passengers: Spawns a vehicle with random passengers sitting in the vehicle.
 - Explode: Spawns a vehicle that will explode within a certain amount a time.


NEW in v1.1:
 - Now works for game version v1.0.2.0.
 - Fixed the issue with some peds not performing their tasks after spawning lots of peds.
 - Stand still-task peds will now stand still, even when you drop a grenade.
 - Fight player-task peds will now stay focused on fighting the player. Some may even kill off the others to try to kill you first.


This script allows you to configure the hotkeys and options to your liking. The keys are assigned the numerical representation of the respective VK enum. I've included a text file with a listing of all available keys, incase some of you don't know the numerical value of the key you'd like to use.

NOTE: You can change the options during gameplay without exiting the game. After you've saved any changes, simply reload the game and the changes will take effect.



Default Hotkeys:

Numpad 0 (96): Change Spawner Type
Numpad 1 (97): Previous Spawn Index
Numpad 2 (98): Next Spawn Index
Numpad 3 (99): Change Task
Numpad Decimal (110): Spawn Object


Options Information:

Change Spawner Type: Switches spawner types, currently only peds and vehicles.
Previous Spawn Index: Decreases the current spawn index by 1.
Next Spawn Index: Increases the current spawn index by 1.
Change Task: Changes the current spawn alteration for the next spawned object.
Spawn: Spawns the selected object.


Settings Information:

[KEYS]
SPAWNTYPE = Change Spawner Type
PREVINDEX = Previous Spawn Index
NEXTINDEX = Next Spawn Index
TASKTYPE = Change Task
SPAWN = Spawn Object

[VALUES]
MINPEDDIST = Minimum distance to spawn peds from Niko. (DEFAULT=2.0)
MAXPEDDIST = Maximum distance to spawn peds from Niko. (DEFAULT=4.0)
MINCARDIST = Minimum distance to spawn cars from Niko. (DEFAULT=2.5)
MAXCARDIST = Maximum distance to spawn cars from Niko. (DEFAULT=5.0)
FLEEFALLTIME = Amount of time (in ms) it takes for the ped to trip when fleeing. (DEFAULT=5000)
FLEEFALLFORCE = Amount of force applied when the ped trips and falls. (DEFAULT=2.0)
PEDINITHEALTH = Amount of health spawned peds start with. (DEFAULT=0)
DEFENDPEDHEALTH = Amount of health defend-task spawned peds have when spawned. (DEFAULT=200)
DEFENDPEDARMOR = Amount of armor defend-task spawned peds have when spawned. (DEFAULT=200)
DEFENDPEDWEAPON = The weapon that defend-task spawned peds have when spawned. (DEFAULT=12)
FIGHTPEDHEALTH = Amount of health fight-task spawned peds have when spawned. (DEFAULT=200)
FIGHTPEDARMOR = Amount of armor fight-task spawned peds have when spawned. (DEFAULT=200)
FIGHTPEDWEAPON = The weapon that fight-task spawned peds have when spawned. (DEFAULT=7)
FOLLOWPEDHEALTH = Amount of health follow-task spawned peds have when spawned. (DEFAULT=10)
FIREPEDHEALTH = Amount of health onfire-task spawned peds have when spawned. (DEFAULT=2000)
EXPLODECARTIME = Amount of time (in ms) it takes for explode-task spawned cars to explode. (DEFAULT=5000)
RAGDOLLFORCE = Amount of force that slings the ragdoll ped to the ground. (DEFAULT=10.0)
RICHPEDS = Determines whether the spawned peds will have lots of money or not. (DEFAULT=false)



To Install:

First you will need to obtain a copy of HazardX's .NET ScriptHook. After you've installed the .NET ScriptHook simply copy the /scripts folder to the GTAIV root folder.

Optional: If you choose to use the default values, you don't need to copy the "sspsettings.ini" file. However, if you do intend to change some things, you need to copy the "sspsettings.ini" file to the same location as the script, in the <GTAIVROOT>/scripts folder.

Optional2: Also included in the /scripts folder is a file "spawnexm.ini". This file contains all the DLC content vehicles and peds to spawn. The file initially contains the bikes from Lost and Damned DLC and can be modified for any future DLC releases or even custom models. All you do is open the file in notepad or similar and enter the vehicle and ped model names in the respective locations, and they will be loaded with the rest. If you don't have any DLC content you can simply ignore/delete/remove this file because spawning any invalid models will crash the game. If you do intend to use this file just copy it to the same location as the script, in the <GTAIVROOT>/scripts folder.


Minimum Requirements:

.NET Framework v2.0
GTAIV PC Installation
Any ASI Loader
HazardX's .NET ScriptHook


Recommended Requirements:

.NET Framework v3.5
GTAIV PC Installation
Any ASI Loader
HazardX's .NET ScriptHook


Links:

.NET Framework v3.5:
 - http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6
ASI Loader by Alexander Blade:
 - http://www.gtaforums.com/index.php?showtopic=380830
Xliveless by listener:
 - http://www.gtaforums.com/index.php?showtopic=388658
.NET ScriptHook by HazardX:
 - http://www.gtaforums.com/index.php?showtopic=392325



-+-+-+-+-
 Contact
-+-+-+-+-

If you have any comments, questions, problems or anything else regarding this software:
 - Email: computermasster[at]gmail[dot]com
								~EOF~