ScriptHookRDR2.NET

This is an ASI plug-in for "Red Dead Redemption 2", transplanted from ScriptHookVDotNet, based on Alexander Blade's C++ ScriptHook, allowing to run any script written in .NET language in the game. ⚠️ This project has stopped development and may not work properly. There is an improved, updated fork of the project on GitHub.

Community ScriptHookRDR2.NET

✨ **IMPORTANT NOTICE** ✨

**This project has stopped development and may not work properly. **

There is an improved, updated fork of the project on GitHub at: Halen84/ScriptHookRDR2DotNet-V2 - many thanks for their work!

---

🎮 Module Introduction

This is an ASI plug-in designed for "Red Dead Redemption 2". It is transplanted from the famous **ScriptHookVDotNet** and is based on the C++ ScriptHook core developed by **Alexander Blade**. Its core function is to allow players and developers to run scripts written in any **.NET language** (such as C#, VB.NET, etc.) in the game, greatly expanding the game's module development possibilities.

📢Official Community

Join the official **Red Dead Redemption 2 Modding Discord** server to get the latest news and community support on Red Dead Redemption 2 PC mods!

🛠️ How to use

• Copy the following files to the root directory of your Red Dead Redemption 2 game installation:
• `ScriptHookRDRDotNet.asi`
• `ScriptHookRDRNetAPI.dll`
• `ScriptHookRDRDotNet.ini`
• Place the script file (`.cs`, etc.) you want to run into the `/scripts/` folder in the game root directory.

📋 System Requirements

To use this plugin, you need to install the following components first:

• **Alexander Blade's C++ ScriptHookRDR2** (basic runtime library)
• **.NET Framework v4.6 or higher**
• **Visual C++ Redistributable for Visual Studio 2019 x64**

💻 Developer Guide

If you want to develop your own script, follow these steps:

• Create a project that targets the **.NET Framework 4.6 or higher**.
• Add a reference to `ScriptHookRDRNetAPI.dll` in the project.
• Use the `RDR2` namespace in your code.
• Refer to the **`ExampleScript.cs`** file that comes with the project as an example.

🔧 Project Contribution

**The source code for this project is hosted on GitHub: Saltyq/ScriptHookRDR2DotNet**

If you want to participate in development or compile source code, you need:

• **Visual Studio 2017 or higher**.
• Extract **Script Hook RDR2 SDK** to the `/sdk` folder in the project directory.
• Create an environment variable called `RDR2DN_VERSION` and set its value to the version number you are trying to build.

We welcome any contributions to the project and recommend using GitHub's **Pull Requests** feature to submit code.

🙏 Thanks

• **Crosire** - Thanks to ScriptHookVDotNet for its development.
• **Jedijosh920** - provided a lot of help ❤️
• **Mooshe** - Thanks to its RDR3CrashDiagnostics program.