ScriptHook Multi-Game

A universal ScriptHook implementation supporting multiple Rockstar games with automatic 32-bit/64-bit architecture selection.

Supported Games

• Grand Theft Auto V (64-bit)
• Red Dead Redemption 2 (64-bit)
• Red Dead Redemption (64-bit)
• Max Payne 3 (32-bit)

How It Works

This ScriptHook acts as a bridge between your custom scripts and the game's native functions. It dynamically loads function pointers from the main ScriptHook DLL and forwards calls with the correct architecture (32-bit or 64-bit).

Architecture Selection

The build system automatically selects the correct architecture and target game based on your CMake preset:

• x64 presets (x64-debug, x64-release, x64-release-debug): Automatically compiles in 64-bit mode for GTA V
• x32 presets (x32-debug, x32-release, x32-release-debug): Automatically compiles in 32-bit mode for Max Payne 3

Configuration

Changing Target Game (64-bit only)

For 64-bit builds, you can change between GTA V, RDR2, and RDR by modifying common.hpp:

#if defined(FORCE_X32)
	#define BIT_MODE X32
	#define VERSION MP3
#elif defined(FORCE_X64)
	#define BIT_MODE X64
	#define VERSION GTAV  // Change to: GTAV, RDR2, or RDR

Build Presets

64-bit builds (GTA V / RDR2 / RDR):

• x64-debug - Debug build
• x64-release-debug - Release with debug info
• x64-release - Full release build

32-bit builds (Max Payne 3):

• x32-debug - Debug build
• x32-release-debug - Release with debug info
• x32-release - Full release build

---

Building

1. Detect the architecture from the selected preset
2. Set the appropriate game target (x32 → MP3, x64 → configurable)
3. Display build information during compilation

---

API Documentation

Full API Documentation

---

License

This project is provided as-is for educational and modding purposes. 2026 Vey Inc