************************************************************************************************************************************************
Farnsworth's Armoured Car v0.5                                                                                  Copyright 2015, Prof. Farnsworth
************************************************************************************************************************************************

This mod will enable a convoy of vehicles to spawn at the Maze Bank headquarters building in downtown LS. The convoy will follow a route around the city, making stops to pickup money at 5 locations. After each stop, the armoured car will be carrying more cash.

The objective is to steal the armoured vehicle and return it to a dropoff point before being killed or having the vehicle destroyed. If you make it to the dropoff, you will be rewarded with cash from the heist, however, you will still need to escape any remaining pursuers as well as any police whose attention you may have drawn.

There are multiple ways to get the armoured car which are all viable.

***************************
0.4 UPDATES
- Updated for Scripthook.net v 1.0
***************************
0.4 UPDATES
- Should fix convoy not spawning for some
***************************
0.3 UPDATES
--Added adjustable spawn delay. Set "minutesbetweenpickups" to the amount of minutes you want between convoy runs 
***************************
0.2 UPDATES

-Multiple bugs fixed related to blip, car, and spawn, deletion
-Multiple locaitons added for drop location
-Rocket wielding spawns configured to be more frequent
-Some other minor changes

***************************

***************************
0.1 UPDATES

-Initial Release

***************************

INSTALLATION: Copy the included files (UNConvoy.net.dll & UNConvoy.ini) into your scripts folder. The mod is ambient (it will run on it's own, thus requires no keypresses).

***************************

*****
CUSTOM ROUTE SETTINGS: The following explains how to change the route of the convoy: ****(Custom routes are not yet available, but you can alter the speed, and the vehicles that spawn)****

"XVehicleSpawn" - Determines the starting spawn for vehicle X (X,Y,Z).
"XSpawnHeading" - Determines the heading of vehicle x when spawned (Float).
"destX" - These are the stop points on the route (X,Y,Z).
"destXspeed" - This is the speed at which the convoy will drive to the next stop (Float)
"dropStopX" - This is where the vehicle will stop to make a pickup (X,Y,Z).
"pickupX" - This is where the runner will go to pickup the money (X,Y,Z).
"arrivalLocation" - Where the convoy personnel walk to after reaching "dest19" (X,Y,Z).
"dropoffX" - Possible locations for dropoff points after stealing the lead vehicle (X,Y,Z).

NOTES:
-If the convoy fails to stop at a custom pickup, try lowering the speed at which they drive to the stop (they need to stop within a certain distance of the location
- The convoy will follow the destinations in a sequential order (ie. dest1, dest2, etc).
- The pickups will also be made in sequence (ie. "pickup1" after "dest3") so routes need to be planned accordingly. 
- The convoy personnel will be deleted after reaching the "arrivalLocation"
- There can be seven different dropoff locations set. When stealing the armoured car, the mod will choose the furthest drop away from where the player is at that moment.
*****

SETTINGS: The following settings can be changed in the included .ini file.

"minutesBetweenPickups" - Changing this setting will determine how many minutes go by before the armoured pickup's next run.(Setting to 0 will cause the convoy to spawn everytime you are close to the Maze building)

"showMoneyTruck" - Change this setting to determine whether the amount of money currently in the lead car will be shown on screen. (0 is off - more realistic, 1 is on)

"spawnDelay" - Change this number to increase or decrease the delay of the Convoy spawn after you enter the surrounding area (e.g. Per second setting: 10 = 10 seconds or less)

"spawnDelete" - Change the value to determine how many cars are deleted when the convoy spawns (used to free up space, avoid crashes). If you are crashing, try raising this number by one each time and testing.****(Not active)****

"obeyTraffic" - Change the value to determine whether the convoy obeys traffic laws (true or false).****(Not active)****

"haveRockets" - Change this setting to determine whether rocket launchers spawn in the streets (true or false, too easy if set to false, default is true).

VEHICLES are as follows (set with model name, WARNING - spelling errors will cause errors in mod):

"leadVehicle" - first vehicle in convoy (!!!MUST USE A FOUR DOOR VEHICLE FOR LEAD CAR!!!)
"2ndVehicle" - second vehicle in convoy (CAN BE TWO DOOR)
"3rdVehicle" - third vehicle in convoy (CAN BE TWO DOOR)
"4thVehicle" - fourth vehicle in convoy (CAN BE TWO DOOR)
"5thVehicle" - fifth vehicle in convoy (CAN BE TWO DOOR)

******These vehcicles spawn after you have gotten into the armoured vehicle*****
"attackSpawn1"
"attackSpawn2"
"attackSpawn3"
"attackSpawn4"

***************************

HOW IT WORKS: When the convoy spawns, the only indication will be a new icon on the map, which is a blue garbage truck. There is no text or any other indication that it has spawned. You need to recognize the appearance if you want to take the convoy. The convoy will also disappear if you travel to far away from it (fairly generous distance, approx. 3-4 downtown city blocks). When in the armoured vehicle, a drop marker will appear on the map (Green Dollar sign), as well as a route. When arriving at the drop, simply drive into the marker. You will exit the vehicle automatically, and be paid accordingly.

***************************

KNOWN BUGS: -Incompatibility with Szabo's Persistence Mod (Disable persistence (-) before getting in the armoured car (thanks reddevilthp))
-Bikers will not get back in a vehicle after falling off bike.
-

***************************

Please feel encouraged to report any other bugs, suggestions, comments or criticisms.


COPYRIGHT: Please do not re-upload, modify, or otherwise alter this mod. I am happy to help if you have questions, but please respect other people's work. 

Enjoy

Prof. Farnsworth