; ************************* Scripts by CPU Killer *************************

 - Contact: cpukiller@viralsound.com

====================================================================================================

; ************************* [Script Name] CPU_Neo_Vehicle_AI

====================================================================================================

 [Description]

 - This is a Vehicle/Turret/Human AI script loosely based on Neo_Vehicle_AI. The code is still needs to be
   cleaned up a bit, but it seems to be stable.

 [Parameters]

 - MaxRange
    If ChaseTarget is 1, this is the max distance it will fire from before chasing the target.
    Otherwise, it is the maximum distance it will try to fire from.
 
 - ChaseTarget
    Set to 1 to chase down targets that run away, 0 to maintain it's position.
    Should be set to 0 for a Turret
     
 - ReturnHome
    If ChaseTarget is set to 1, return to it's original position if it runs out of things to kill.
 		
 - RespondToSound
    Respond to enemies by sound as well as sight.
    
 - vsSoldier
 - vsVehicle
 - vsAircraft
    For the 3 above, you can use the following values:
      -1 = Do Not Attack Unit Type
       0 = Use secondary weapon
       1 = Use primary weapon
       2 = Switch between primary/secondary weapon as needed
       
 - EnableTransitions
    Allow users to enter/user vehicles still. This will kick out users if they are from a different team
    from the unit. Also returns unit team to the original GDI/Nod setting instead of Unteamed when user exits
    and resumes AI control.

====================================================================================================

; ************************* [Script Name] CPU_BaseAirSpace_AI

====================================================================================================

 [Description]

 - This is a script for enforcing your teams Air Space. You place the script on a VTOL and set the param
   to the Script Zone that marks your Air Space. Please note that the CPU_BaseAirSpace_AI script is incomplete
   and still need a lot of work.

 [Parameters]

 - ZoneID
    The ID of the Script Zone with CPU_BaseAirSpace_ScriptZone attached.

====================================================================================================

; ************************* [Script Name] CPU_BaseAirSpace_ScriptZone

====================================================================================================

 [Description]

 - This detects when enemies enter the Script Zone and tells one of however many units you have
   CPU_BaseAirSpace_AI attached to to attack the invader.

 [Parameters]

 - Team
    0 for Nod
    1 for GDI
    (I think, reverse them if it attacks the wrong team lol)
 
====================================================================================================

; ************************* [Script Name] CPU_Follow_Random_Waypath

====================================================================================================

 [Description]

 - Makes a unit follow 1 of up to 5 Waypaths randomly upon spawning. Adds some variety to your maps
   with AI-based battles.

 [Parameters]

 - Speeed
    Speed at which to travel the Waypath

 - WayPathID1
 - WayPathID2
 - WayPathID3
 - WayPathID4
 - WayPathID5
    The IDs of your Waypaths, just set any you don't use to 0

====================================================================================================

; ************************* [Script Name] CPU_VTOL_Harvester

====================================================================================================

 [Description]

 - This allows a VTOL to be your harvester. This was originally made for the Star Wars: A New Hope mod.

 [Parameters]

 - Speeed
    Speed at which to travel the Waypaths
    
 - WaypathIDIn
    The ID of the Waypath to fly to the Drop Point (Refinery) on.
    
 - WaypathIDOut
    The ID of the Waypath to fly to the Gather Point (away from the Refinery) on.
       
 - WaitAtGatherPoint
    How long to sit at the Gather Point before making another run to the Refinery.
    
 - WaitAtDropPoint
    How long to sit at the Drop Point (Refinery) before leaving for the Gather Point
    
 - MoneyAmount
    How much money to deposit to the team each run.
    
 - DropPointMsg
    The message it will get when it reaches the Drop Point Script Zone (2200 by default)
    
 - GatherPointMsg
    The message it will get when it reaches the Gather Point Script Zone (2201 by default)

====================================================================================================

; ************************* [Script Name] CPU_Change_Team

====================================================================================================

 [Description]

 - This changes the team of whatever it is attached to.

 [Parameters]

 - Team
    Set's the player's team (should be 0 or 1)

====================================================================================================

; ************************* [Script Name] CPU_Enable_Spawner_ScriptZone

====================================================================================================

 [Description]

 - This enables and triggers or disables a spawner when someone enters a Script Zone.

 [Parameters]

 - ID
    The ID of the spawner.

 - Enable
    0 to disable the spawner, 1 to enable and trigger it.

====================================================================================================

; ************************* [Script Name] CPU_Indestructible

====================================================================================================

 [Description]

 - This makes whatever it is attached to invincible.

====================================================================================================

; ************************* [Script Name] CPU_Indestructible_Custom

====================================================================================================

 [Description]

 - This makes whatever it is attached to invincible or not depending on messages received.

 [Parameters]

 - DisableMessage
    The message ID that should disable invincibility.

 - EnableMessage
    The message ID that should enable invincibility.

====================================================================================================

; ************************* [Script Name] CPU_Play_Cinematic_For_Money_ScriptZone

====================================================================================================

 [Description]

 - This plays a cinematic when whatever it is attached to is Poked and takes credits to purchase it.
 - If the player doesn't have enough credits it will not allow the purchase.

 [Parameters]

 - Team
    The team type that should be allowed to use it (0 or 1)

 - Script_Name
    The filename of the cinematic script.

 - Object_ID
    The ID of the object who's position is where the cinematic will be created at.

 - CreatedMessage
    Something in the cinematic should send this message to the ScriptZone to let it know the cinematic was successful.

 - DeathMessage
    You have 2 options for this:
	1. Leave DeathMessage as 0, it will make the ScriptZone reset and allow a new purchase in 60 seconds from the last purchase.
	2. Set this to a message # that something in your cinematic should send to the ScriptZone telling it that it can allow another purchase.

====================================================================================================

; ************************* [Script Name] CPU_Display_Text_ScriptZone

====================================================================================================

 [Description]

 - This will display some text whenever a user enter's the ScriptZone

 [Parameters]

 - Team
    The team type that should be allowed to use it (0 or 1)

 - Text
    The text that should be displayed.

====================================================================================================

; ************************* [Script Name] CPU_Random_Character

====================================================================================================

 [Description]

 - This will assign a random character preset and weapon to a real player when they enter the ScriptZone it is attached to.
 - Hint: Make a script zone around your player spawns so it instantly activates.
 - This was originally made for Oblivion165's Rage Wars mod, but felt it may be useful to others here.

 [Parameters]

 - CharacterTextFile
    The filename of a text file with one character (Soldier) preset per line.

 - WeaponPowerupTextFile
    The filename of a text file with one weapon powerup preset per line.
    Remember: It has to be the name of a POWERUP preset, not the name of the WEAPON preset.

 - DefaultWeaponPowerupPreset
    The name of a Weapon Powerup that will always be given in addition to the random one given.
    Remember: It has to be the name of a POWERUP preset, not the name of the WEAPON preset.

 - SetHealth
    Leave it as o to not effect player health, otherwise will reset the player's max health to what is given.

====================================================================================================

; ************************* [Script Name] CPU_Powerup_AmmoBox

====================================================================================================

 [Description]

 - This allows you to give ammo for up to 5 weapons from one powerup.
 - Attach this script to the powerup's preset, not a Script Zone or otherwise.
 - This was originally made for Oblivion165's Rage Wars mod, but felt it may be useful to others here.

 [Parameters]

 - WeaponPreset1-5
    The name of a weapon preset to give ammo for

 - GiveAmmoAmount1-5
    How many rounds of ammo to be given for each weapon.

====================================================================================================

; ************************* [Script Name] CPU_Powerup_Random_Weapon

====================================================================================================

 [Description]

 - This script gives a random weapon to a bot/character when they get the powerup.
 - If you set TriggerOnCreate to 1 and attach the script to a character preset it will active
   when they spawn versus acting as a powerup.
 - This was originally made for Oblivion165's Rage Wars mod, but felt it may be useful to others here.

 [Parameters]

 - WeaponPowerupTextFile
    The filename of a text file with one weapon powerup preset per line.
    Remember: It has to be the name of a POWERUP preset, not the name of the WEAPON preset.

 - DefaultWeaponPowerupPreset
    The name of a Weapon Powerup that will always be given in addition to the random one given.
    Remember: It has to be the name of a POWERUP preset, not the name of the WEAPON preset.

 - SetHealth
    Leave it as o to not effect player health, otherwise will reset the player's max health to what is given.
