
-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
 Mega SuperJump Script
-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
 Version 1.5
-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
 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.


The new 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.



Default Hotkeys:

Page Up (33): SuperJump1
Page Down (34): Dig
Delete (46): Float/Fly/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


Options Information:

SuperJump1: Positional jump. Increases both player position and velocity.
Dig: Positional fall. Decreases both player position and velocity.
Float/Fly/Hover: Freezes your Z velocity allowing you to hover 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. (NOTE1: If you don't notice any change in speed, jump once or twice while running.) (NOTE2: This also works for your current vehicle.)
SuperJump2: Velocity jump. Increases only player velocity and not position. Rapidly press for greater effect.
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.
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.
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.


Settings Information:

[KEYS]
POSJUMP = SuperJump1
POSDIG = Dig
VELOJUMP = SuperJump2
LOCKVELO = Float/Fly/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

[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. (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)
TRYRECOV = Determines whether the script will try to recover from being a ragdoll when using the Air Brakes or Downward Thrust. (DEFAULT=true)
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. (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)

[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 hotkey alone, however, if you wish to cycle in reverse just hold the CTRL key while pressing this hotkey. 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 to the GTAIV root 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.


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
YAASIL - Yet Another ASI Loader by HaxardX:
 - http://www.gtaforums.com/index.php?showtopic=394806
.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~