
-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
 Mega SuperJump Script
-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
 Version 1.8
-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
 Created by: CoMPuTer MAsSteR [.:AKA:.] CoMPMStR
 Special Thanks to dingbat2000 for his Flying Niko ASI source.



This is a complete rewrite of my superjump/dig lua script. The features available in the lua script are also available in this release, but this release has so much more and it's much more stable. It's all thanks to HazardX and his .NET ScriptHook, without it this wouldn't be possible.


This script gives quite a few more options from the lua script. Some of the new options are:

 - Infinite Health/Armor/Ammo
 - Niko Fling (ragdoll toggle)
 - Speed Increase (travel faster than vehicles while on foot)
 - Configurable hotkeys and options


NEW in v1.1:

 - Added Niko's current vehicle to the infinite health/invincibility functions.
 - Fixed the problem of the invincibility overwriting other trainers/scripts. Set the hotkey used to 0 in the "sjsettings.ini" file to completely disable it.

NEW in v1.2:

 - Now works for game version v1.0.2.0.
 - Added a time scale AKA bullet time option.

NEW in v1.3:

 - Added some new features and more selections for the infinite health/invincibilty option.
 - Fixed the issue when infinite health for the vehicle is enabled and attempting a drive-by.
 - Now when infinite health is enabled for the vehicle, it will only apply when the vehicle loses health.
 - Now when player invincibility is enabled, you will no longer fly out of the vehicle when hitting a solid object at full speed.
 - Fixed the problem of the bullet time option overwriting other trainers/scripts. Set the hotkey used to 0 in the "sjsettings.ini" file to completely disable it.

NEW in v1.4:

 - Updated to work with the new scripthook version.
 - Added more features to the bullet time option. Now you can have it with gravity on or off.
 - Infinite Health/Invincibility functions now work for group members as well.
 - Now when player invincibility is enabled, Niko will no longer become tired after sprinting for awhile.
 - Now when player invincibility is enabled, the vehicle you attempt to enter will already be owned by you. No hotwire, no cops.

NEW in v1.5:

 - Fixed some issues when fully disabling a used key in the INI file.
 - Added a self-flying script addon. Hancock style.

NEW in v1.6:

 - Fixed the player invincibility feature a bit. Now all doors will be unlocked for vehicles when enabled. You can also jack cop cars!
 - Added mouse turning to the self-flying script addon, with or without holding the Aim button.
 - Added flame trails to the self-flying script addon. You can toggle it on or off even without flying.
 - Added a car-attach/ride script addon. Ride on top of vehicles without falling.
 - Added an invisibility feature to the car-attach/ride script. Cops ignore you and, also works for group members and/or vehicles.
 - Improved the SuperJump2 and Speed Increase features.

NEW in v1.7:

 - Updated to work with new game version and scripthook.
 - Added a flamethrower script, complete with spread shot addon.
 - Added a model change script and an animation player.
 - Added a wanted level feature to the mix.
 - Fixed the infinite ammo so now you also have no reload when enabled.
 - Improved the SuperJump2 feature which plays an animation when falling rather than hitting the ground as a ragdoll.
 - Improved the self-flying script addon, now plays an idle animation when flying rather than the falling animation.

NEW in v1.8:

 - Updated to work with v1.0.7.0 and new scripthook.
 - Changed the flamethrower script, some weapons became buggy after the update.
 - Removed flames (fire effects) from all scripts. Also due to buggyness.

The feature I'd like to point out is the ability to configure your hotkeys, weapons, and values to anything you want. This gives the script complete customization and grants you complete control of how the script will perform.

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.

The values and weapons also give you control over how the script will perform. You can change the values to suit your needs, even though the defaults should be just fine. The weapons can be changed according to the weapon indexes. I've also included a text file with all the weapon indexes as well for people who can't find them.

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. Alternately, you can toggle the scripthook console and type the command 'reloadscripts' to reload them without reloading the game.



-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
 Default Hotkeys:
-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-

ControlKey+AltKey+Insert (17+18+45): Master ON/OFF Keys
Page Up (33): SuperJump1
Page Down (34): Dig
Delete (46): Float/Hover
Insert (45): Infinite Health/Invincibility *READ INFO BELOW
End (35): Niko Fling
Shift (16): Speed Increase
Space (32): SuperJump2
Home (36): Bullet Timescale
Numpad9 (105): Upward Thrust
Numpad7 (103): Downward Thrust
Numpad8 (104): Forward Thrust
Numpad5 (101): Air Brakes
Numpad4 (100): Turn Left
Numpad6 (102): Turn Right
OemPeriod (190): Attach Car
OemQuestion (191): Change Offset
Middle Mouse Button (4): Alternate Shot
M Key (77): Model Change/Outfit Randomize
N Key (78): Animation Play


-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
 Options Information:
-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-

 - Master ON/OFF Keys: Switches the script on and off, allowing you to free up the used hotkeys. You can choose any number of keys to use, just make sure your keyboard allows pressing them all simultaneously. Seperate each with a plus sign.
 - SuperJump1: Positional jump. Increases both player position and velocity. Hold the CTRL key to increase Niko's wanted level.
 - Dig: Positional fall. Decreases both player position and velocity. Hold the CTRL key to decrease Niko's wanted level.
 - Float/Hover: Freezes your Z velocity allowing you to hover or float in mid air.
 - Niko Fling: Transforms Niko into a ragdoll, and puts a bit of force to push him forward. (NOTE: The amount of force depends on how much momentum Niko has initially.)
 - Speed Increase: Increases your speed as you hold down the button. Speed will begin to decrease when it's released. (NOTE: This also works for your current vehicle.)
 - SuperJump2: Velocity jump. Increases only player velocity and not position. Rapidly press for greater effect if BUILDUPJUMP is disabled. Hold down to build up force if BUILDUPJUMP is enabled.
 - Bullet Timescale: Allows changing the timescale to slow it down. You can choose to have it speed up if you change the option value. Toggle once for no gravity, toggle again for with gravity. Hold the CTRL key to cycle in reverse.
 - Upward Thrust: Part of the self-flying script addon. Raises you up in the air.
 - Downward Thrust: Part of the self-flying script addon. Lowers you back to the ground.
 - Forward Thrust: Part of the self-flying script addon. Makes you fly forward.
 - Air Brakes: Part of the self-flying script addon. Slows down your speed. Hold the CTRL key to toggle the flame trail.
 - Turn Left: Part of the self-flying script addon. Turns to the left, Niko turns too.
 - Turn Right: Part of the self-flying script addon. Turns to the right, Niko turns too.
 - Attach Car: Part of the car-attach/ride script addon. Attaches Niko to the top of the closest vehicle. Hold the CTRL key to toggle player invisibility, hold the ALT key to toggle player vehicle invisibility.
 - Change Offset: Part of the car-attach/ride script addon. Allows changing the placement when attached to a vehicle. Hold the CTRL key to decrease, hold the ALT key to increase, press alone to cycle which axis (x, y, z).
 - Alternate Shot: This is your alternate weapon that doesn't get you caught by the cops unless you directly aim your gun at one. Hold the CTRL key to cycle weapons.
 - Model Change/Outfit Randomize: Allows you to change the player model and/or randomize the model outfit. Hold the CTRL key to select the next model or hold the ALT key to select the previous model. You MUST hold both CTRL+ALT in order to change models. Also you can aim at any ped, while holding the CTRL key, to get the model of the selected ped; then you can change into the ped model.
 - Animation Play: This is to play a certain animation set with one of the given animation names. Press the key alone to play the current animation, or hold CTRL+ALT to cycle the animation changes. You can choose to change the current animation set, name, or speed by cycling. Once you choose one to change you hold the CTRL key to select the next animation set or name, or increase the speed; and you hold the ALT key to select the previous animation set or name, or decrease the speed.

-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
 Settings Information:
-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-

[KEYS]
MASTERONOFF = Master ON/OFF Keys
POSJUMP = SuperJump1
POSDIG = Dig
VELOJUMP = SuperJump2
LOCKVELO = Float/Hover
SPEEDINC = Speed Increase
HEALTHWEAPS = Invincibility
NIKORAG = Niko Fling
BULLETTIME = Bullet Timescale
GOUP = Upward Thrust
GODOWN = Downward Thrust
ACCEL = Forward Thrust
DECEL = Air Brakes
TURNL = Turn Left
TURNR = Turn Right
ATTACH = Attach Car
POSITION = Change Offset
SPECIALWEAPON = Alternate Shot
MDLCHANGE = Model Change/Outfit Randomize
ANIMCHANGE = Animation Play

[VALUES]
POSJUMPPOSINC = Amount of positional increase when performing SuperJump1. (DEFAULT=1.0)
POSJUMPVELOINC = Amount of velocity increase when performing SuperJump1. (DEFAULT=3.0)
POSDIGPOSDEC = Amount of positional decrease when performing Dig. (DEFAULT=3.0)
VELOJUMPVELOINC = Amount of velocity increase when performing SuperJump2. Also affects build up speed. (DEFAULT=6.0)
SPEEDINCFORCE = Multiplier of the Speed Increase force. (DEFAULT=1.15)
NIKORAGFORCE = Multiplier of the Niko Fling momentum force. (DEFAULT=2.0)
BTSCALE = Multiplier of the Bullet Time scale when enabled. (DEFAULT=0.2)
HEALTH = Amount of health to give Niko and group members when infinite health is enabled. (DEFAULT=200)
ARMOR = Amount of armor to give Niko and group members when infinite health is enabled. (DEFAULT=200)
SPEEDCAP = Amount of speed to limit the Speed Increase feature. This will result is much smoother running when in use. (DEFAULT=18.0)
BUILDUPJUMP = If enabled, allows you to build up your jump force rather than using small increments. (DEFAULT=true)
LOCKTOGROUND = If enabled, will lock you to the ground to avoid jumping in the air when building up jump force. (DEFAULT=true)
LIMITJUMPS = Limits the jumping ability, when BUILDUPJUMP is enabled, until Niko hits the ground. (DEFAULT=true)
MOUSESPEEDTURN = Allows the mouse to be used to turn Niko when using the Speed Increase feature. Does NOT work when Niko's a ragdoll. (DEFAULT=true)
JUMPTURNRATE = Multiplier of the turning rate after the jump force is released. Used by moving left and right. (DEFAULT=1.8)
JUMPMOMENTUM = Percentage of jump force to be used as forward velocity. (DEFAULT=0.3)
DISPJUMPTEXT = Determines whether the jump force meter will also display text. (DEFAULT=false)
RAGDOLLFLY = Determines whether Niko will lose control of flying when he becomes a ragdoll. (DEFAULT=true)
ACCEL = Multiplier of the Forward Thrust speed. Ultimately, how fast you fly. (DEFAULT=1.32)
DECEL = Multiplier of the Air Brakes power. The lower the value, the more power they have. Hold the CTRL key to toggle fires on or off when not flying. (DEFAULT=0.84)
TURN = Multiplier of the in-air power steering. Ultimately, how quickly you turn left and right. (DEFAULT=2.63)
LIFT = Amount of Upward and Downward thrust. (DEFAULT=4.20)
MOUSETURN = Determines whether you turn with the mouse, or hotkeys, while flying. (DEFAULT=true)
WHILEAIM = Determines whether you have to hold the aim button in order to turn with the mouse. (DEFAULT=true)
CARRADIUS = The radius to search for the closest car to attach Niko. (DEFAULT=20.0)
CRUISESPEED = Speed at which vehicles will cruise once you're attached to them. (DEFAULT=45.0)
SPREADSHOTDIST = Maximum distance for the spread shot to reach, in short, how far it shoots. (DEFAULT=200.0)
FINALJUDGEMENTDIST = Maximum distance for the final judgement to expand. (DEFAULT=100.0)

[WEAPONS]
Each property specifies a certain weapon slot ingame. Entering a value other than the required value for the property will NOT put the chosen weapon into the respective slot. For example, putting a value of 18 for MELEE will NOT give you the RPG in the Handgun slot. (DEFAULTS: MELEE=1, THROWN=4, HANDGUN=9, SHOTGUN=11, SMG=13, RIFLE=15, SNIPER=17, HEAVY=18)



-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
 Infinite Health/Invincibility Info:
-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-

This feature now has quite a few more options. First of all, you can cycle these options forward and in reverse by use of the CTRL key. If you want to cycle forward simply press this key alone, however, if you wish to cycle in reverse just hold the CTRL key while pressing this key. I also changed how it assigns the properties to Niko and his vehicle. There are two main differences in these properties, single and dual. Single means the property will only be assigned to Niko, and dual means that it will be assigned to both Niko and his vehicle. The available options are:

Normal: Returns Niko's health/armor/ammo/invincibility status back to normal. Also restores your current vehicle back to normal.
Single Infinite Health/Armor/Ammo: Freezes them at max so you never lose any.
Dual Infinite Health/Armor/Ammo: This will repair and wash your vehicle anytime it receives any damage.
Single Invincibility: AKA Godmode. With this enabled you will NEVER die. You will also never fall off bikes or out of vehicles (unless you open the door).
Single Invincibility With Helmet: Same as single invincibility, except you're always wearing the crash helmet.
Dual Invincibility: This will set you and your vehicle invincible, no physical or visual damage.
Dual Invincibility With Helmet: Same as dual invincibility, except you're always wearing the crash helmet.
Dual Invincibility Color Change: Same as dual invincibility, except your current vehicle's colors will randomly change.
Dual Invincibility Color Change With Helmet: Same as dual invincibility color change, except you're always wearing the crash helmet.



-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
 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 in the archive to your GTAIV installation folder.

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


-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
 Requirements:
-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-

One of the following installations:
 - GTAIV (v1.0.1.0 - v1.0.7.0)
 - EFLC (v1.1.1.0 - v1.1.2.0)

HazardX's .NET ScriptHook
Any ASI Loader for GTAIV
.NET Framework v4


-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
 Links:
-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-

.NET ScriptHook by HazardX:
 - http://www.gtaforums.com/index.php?showtopic=392325
YAASIL - Yet Another ASI Loader by HaxardX:
 - http://www.gtaforums.com/index.php?showtopic=394806
ASI Loader by Alexander Blade:
 - http://www.gtaforums.com/index.php?showtopic=380830
Xliveless by listener: (ASI Loader included)
 - http://www.gtaforums.com/index.php?showtopic=388658
.NET Framework v4:
 - http://www.microsoft.com/downloads/details.aspx?FamilyID=0a391abd-25c1-4fc0-919f-b21f31ab88b7



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

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