This is the original Grand Theft Auto IV ScriptHook SDK by Aru, version 0.4.0, archived for posterity & the sanity of the GTA community into the future.

I noticed that this wasn't super well archived anywhere and struggled to find any live mirrors at all. If anyone has any more related files, please let me know somehow!

Thanks to remoteman123 on GTAForums for maintaining this mirror prior to my upload!

GTAIV Script Hook 0.4.0 SDK Copyright (C) 2009, Aru

== What ==

This code will let you create a custom script thread in C++ and have GTAIV process it along with its real scripts threads. Additionally, a type-safe manner to access native functions in GTAIV is provided.

A sample implementation having the following features is included:

F4 - Teleport to the waypoint marked on your map (in SampleCustomFiber only) F5 - Spawn a random car F6 - Give player $1000 F7 - Spawn a Banshee F8 - Change player skin to Johnny F9 - Change player skin to random variation of Niko

Another sample called Speedo is included to demonstrate usage of the extensible services framework ScriptHook 0.3.0+ provides. Press ALT+F10 to bring up a menu in this sample.

ScriptHook 0.4.0+ contains some breaking API changes which require you to make some minor changes to your code to get them to compile. See UpdateGuide.txt for more information.

For development, you can choose to use your own ASI loader or use the one provided in the DevLoader directory. DevLoader implements a menu interface to loading/unloading modules to ease development. To use it, copy d3d9.dll and DevLoader.config to your GTAIV directory and edit DevLoader.config with a text editor.

== How ==

1. Edit CustomThread.h/.cpp as per your liking
2. Compile
3. Use a dll/asi loader to get the dll loaded into GTAIV.

If you need to use any natives that are not in Scripting.h, find them in ScriptingDirty.h, clean it up, and move it to Scripting.h in your project before using it.

The SampleCustom project presents a sample with a tick-based approach to scripting GTAIV, where as the SampleCustomFiber project presents a sample with a linear script based approach (new in version 0.2.0 of the Script Hook). It's recommended that you use the SampleCustomFiber as a starting point unless you are converting legacy 0.1.x Script Hook code.

== Why ==

Why not... :)

== License ==

Please see ScriptHook-License.txt.

If you redistribute ScriptHook.dll as part of your mod, make sure you distribute ScriptHook-License.txt as well.