DLL plugin loader

A dinput8 proxy loader for "Nioh 3" that can load DLL modules from the plugins folder and write detailed crash logs.

DLL plugin loader

🎮 **A lightweight dinput8.dll proxy loader, specially built for "Nioh 3". **

It can load DLL modules from the `plugins` folder and write detailed crash reports to aid debugging.

---

✨ Function introduction

• **Proxy system file**: Proxy the original system `dinput8.dll` to ensure that game behavior remains normal.
• **Autoload plugins**: Scan and load plugin DLLs from the `/plugins` folder.
• **Standard entry point**: Call the `nioh3_plugin_initialize` entry function of each plugin.
• **Crash Diagnosis**: Install an unhandled exception recorder and write crash diagnostic information.

---

📥 Installation Guide (Players)

• **Place core files**: Place the `dinput8.dll` file of this module into the root directory of your "Nioh 3" game (i.e. the same folder as the game .exe file).
• **Create plugins folder**: Create a folder named `plugins` in the game root directory (if it does not exist).
• **Insert plugin**: Place your DLL module file into the `plugins` folder.
• **Start Game**: Just start the game as usual!

---

📄 Log file

• **Log name**: `NIOH3PluginLoader.log`
• **Save Location**: In your Windows **Documents** folder.

---

🔧 Troubleshooting

If a plug-in fails to load, check the following:

• **Confirm location**: Make sure the DLL file is indeed located in the `/plugins` folder.
• **Check exported functions**: Make sure the DLL correctly exports a function named `nioh3_plugin_initialize`.
• **View log**: Check the `NIOH3PluginLoader.log` file for loading or initialization error messages.

---

👨‍💻 To mod developers

Your plugin DLL needs to export the following functions:

```cpp

constexpr uint32_t NIOH3_PLUGIN_API_VERSION = 1;

struct Nioh3PluginInitializeParam {

uint32_t loader_api_version;

uint16_t game_version_major;

uint16_t game_version_minor;

uint16_t game_version_patch;

uint16_t game_version_build;

const char* game_version_string;

const char* game_root_dir;

const char* plugins_dir;

};

extern "C" __declspec(dllexport)

bool nioh3_plugin_initialize(const Nioh3PluginInitializeParam* initialize_param);

```

---

🗑️ Uninstall method

• Delete the `dinput8.dll` file from the game root directory.
• (Optional) Remove your `plugins` folder and all plugin DLLs in it.

---

🔗 Source code

📂 **GitHub Repository**:

---

💡 **Usage Suggestions**: This loader is the basis for many advanced function modules. After installing it, you can easily enjoy the new features brought by various community-made DLL plug-ins!