Jump to content
Toggle menu
  • 64 articles
  • 37 files
  • 9 users
  • 4.6K edits
Shroudforge
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.
This page is a translated version of the page DInput8 chain loading standard and the translation is 100% complete.


DInput8 chain loading standard



许多 Enshrouded 模组加载器和 DLL 模组都希望成为游戏的 `dinput8.dll`,但这个文件名只能由一个文件占用。占用该名称的加载器会启动游戏可执行文件旁边 `dinput8-chain.ini` 中列出的其他 DLL。EMF、Kiln、ShroudForge、XHL-Core 和 Auto Loot Plus 都会读取此文件。本页记录这些规则,让每个加载器以相同方式读取文件,并使玩家的列表适用于占用 `dinput8.dll` 的任意加载器。

本页以 CC0 方式奉献给公有领域。你可以复制到自己项目的文档中并修改,无需署名。多个加载器共同认可的修改欢迎以 pull request 的方式提交到 EMF 仓库。

下文中的 must 和 should 表示遵循本规范的加载器应有的行为。

文件

; my mods
[Chain]
mods\mymod\mymod.dll
autolootplus.dll

[EMF]
creative.dll
  • 位置:`dinput8-chain.ini` 位于游戏可执行文件(`enshrouded.exe` 或 `enshrouded_server.exe`)所在文件夹。
  • 编码:加载器必须读取带或不带 BOM 的 UTF-8,以及带 BOM 的 UTF-16 LE。对于无效 UTF-8 字节,例如旧版记事本保存的文件,也应读取系统 ANSI 代码页。写入文件的工具必须保留检测到的编码和换行符。
  • 行:跳过空行。以 `;`、`#` 或 `//` 开头的行是注释。在 DLL 行前加 `; ` 可关闭该 DLL,而不必删除行。名称后可用空格或制表符添加注释(`mymod.dll ; my mod`),名称也可以用双引号括起。
  • 节区名称不区分大小写。`[Chain]` 是共享节区,遵循本规范的每个加载器都会启动其中的 DLL。其他节区归某个工具所有,并使用其名称,例如 `[EMF]` 或 `[Kiln]`。其他加载器必须忽略这些节区。任何节区之前的行都属于 `[Chain]`。旧文件可能没有节区。
  • `key=value` 行:当 `name=value` 中的值指向 `.dll` 时,它算作 DLL 项。其他键是写入工具自己的设置,其他加载器忽略它们。

DLL

  • 路径相对于可执行文件所在文件夹。将 `/` 按 `\` 读取。加载器必须拒绝绝对路径、驱动器号、UNC 路径(`\\server\...`)以及任何 `..` 路径段。链文件不得越出游戏文件夹。
  • 仅允许 `.dll` 文件。指向其他文件类型的行会被跳过并报告。
  • 绝不能加载 `dinput8.dll` 本身,也不得启动自身的另一个副本。例如 EMF 即使遇到改名后的自身文件也会识别并跳过。
  • 每个 DLL 只启动一次。同一 DLL 即使同时列在 `[Chain]` 和工具专属节区,或在同一节区重复出现,也只在第一次出现的位置启动。
  • 顺序:按照行从上到下启动 DLL。`[Chain]` 和加载器自己的节区按它们在文件中出现的顺序处理。
  • 时机:从加载器自己的 `DllMain` 中或紧接其后、游戏代码运行之前调用 `LoadLibrary`。若链式 DLL 本身是 `dinput8.dll`,它也会在此时启动。
  • 最多处理 256 个项目。超出的项目会被报告并跳过。
  • 失败:缺失或无法加载的 DLL 会被跳过并报告。包括 Windows 错误 126,以及其 `DllMain` 失败时的错误 1114。游戏继续运行。

报告

加载器应为每个链式 DLL 记录一行:已启动、因已关闭、被拒绝或已加载而跳过,或记录 Windows 错误号的失败。EMF 也会将相同信息写入 `emf\chain_status.txt` 表格,方便玩家分享。

移动其他工具的 dinput8.dll

安装程序发现其他工具的 `dinput8.dll` 时应重命名而不要删除,将新名称写入自己的 `dinput8-chain.ini` 节区,并在卸载时恢复。EMF 识别工具后会使用 `<tool>.dll`。否则会使用 DLL 版本信息或 `dinput8-previous.dll`,并将移动记录写入 `emf\moved.txt`。

导出函数

游戏会对占用 `dinput8.dll` 的加载器调用 `DirectInput8Create`。加载器必须将该调用转发给 Windows 自带的 `dinput8.dll`(`%SystemRoot%\System32\dinput8.dll`)。链式 DLL 不会收到 DirectInput 调用。若模组在 `DirectInput8Create` 中执行逻辑,必须将其移到 `DllMain` 或自己启动的线程中。

遵循此规范的工具

工具 读取 `[Chain]` 自有节区
EMF 是,也读取任何节区之前的行 `[EMF]`,用于其安装程序重命名的 DLL
ShroudForge 是。每个项目必须位于 `mods\<folder>\` 内,其他项目会被报告
Kiln 是,也读取 `[EMF]`,用于旧版 EMF 安装程序重命名的 DLL 无。它自己的列表位于 `kiln\chain.ini`。带引号的名称和名称后的注释尚在计划中。
XHL-Core, Auto Loot Plus 是

如果你的工具会读取此文件,或读取方式不同,请告诉我们以便更新表格。

来源

EMF 的 dinput8-chain.ini 共享规范。原始规范以 CC0 方式奉献给公有领域。