【搬运】DLL 插件加载器

smile417

转自n网：https://www.nexusmods.com/nioh3/mods/49
A dinput8 proxy loader for Nioh 3 that loads DLL mods from plugins folder and writes detailed crash logs.
一个用于仁王 3 的 dinput8 代理加载器，可以从 plugins 文件夹加载 DLL 模组并写入详细的崩溃日志。

A lightweight dinput8.dll proxy loader for Nioh 3.
一款轻量级 dinput8.dll 的《仁王 3》代理加载器。
It loads DLL mods from plugins folder, and writes detailed crash reports to help with debugging.
它会从 plugins 文件夹加载 DLL mod，并写详细的崩溃报告来帮助调试。


What This Mod Does  这个模组的作用

• Proxies the original system dinput8.dll so the game behavior stays normal.
  代理原系统 dinput8.dll，使游戏行为保持正常。
• Scans and loads plugin DLLs from <game root>/plugins.
  扫描并加载来自 <game root>/plugins 的插件 DLL。
• Calls each plugin's nioh3_plugin_initialize entry point.
  调用每个插件的 nioh3_plugin_initialize 入口点。
• Installs an unhandled-exception logger and writes crash diagnostics.
  安装未处理异常记录器并编写崩溃诊断文件。
  

Installation (Players)  安装（玩家）

• Place this mod's dinput8.dll in your Nioh 3 game root (same folder as the game .exe).
  把这个模组的 dinput8.dll 放在你的《仁王 3》游戏根目录里（和游戏.exe 相同的文件夹）。
• Create a plugins folder in game root if it does not exist.
  如果游戏根目录里不存在插件文件夹，就创建一个。
• Put DLL mods inside plugins.
  把 DLL 模组放进插件里 。
• Launch the game.  启动游戏。
  

Log File  日志文件

• Log name: NIOH3PluginLoader.log
  日志名称：NIOH3PluginLoader.log
• Location: your Windows Documents folder
  位置：您的 Windows 文档文件夹
  

Troubleshooting  故障排除
If a plugin does not load:
如果插件无法加载：

• Make sure the DLL is in <game root>/plugins.
  确保 DLL 在 <game root>/plugins 中。
• Make sure it exports exactly: nioh3_plugin_initialize.
  确保导出完全正确：nioh3_plugin_initialize。
• Check NIOH3PluginLoader.log for load/initialize errors.
  检查 NIOH3PluginLoader.log 加载/初始化错误。
  

For Mod Authors  给模组作者
Required export:  必导出：
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  卸载

• Delete dinput8.dll from game root.
  从游戏根删除 dinput8.dll。
• Optionally remove your plugins folder and plugin DLLs.
  可以选择移除你的插件文件夹和插件 DLL。
  

Source Code  源代码
Github

danecom58

谢谢分享！谢谢！