<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en-GB">
	<id>https://wiki.shroudforge.net/index.php?action=history&amp;feed=atom&amp;title=DInput8_chain_loading_standard%2Fzh</id>
	<title>DInput8 chain loading standard/zh - Revision history</title>
	<link rel="self" type="application/atom+xml" href="https://wiki.shroudforge.net/index.php?action=history&amp;feed=atom&amp;title=DInput8_chain_loading_standard%2Fzh"/>
	<link rel="alternate" type="text/html" href="https://wiki.shroudforge.net/index.php?title=DInput8_chain_loading_standard/zh&amp;action=history"/>
	<updated>2026-11-21T15:04:32Z</updated>
	<subtitle>Revision history for this page on the wiki</subtitle>
	<generator>MediaWiki 1.46.2</generator>
	<entry>
		<id>https://wiki.shroudforge.net/index.php?title=DInput8_chain_loading_standard/zh&amp;diff=3225&amp;oldid=prev</id>
		<title>Bonsaibauer: Importing a new version from external source</title>
		<link rel="alternate" type="text/html" href="https://wiki.shroudforge.net/index.php?title=DInput8_chain_loading_standard/zh&amp;diff=3225&amp;oldid=prev"/>
		<updated>2026-11-14T17:01:59Z</updated>

		<summary type="html">&lt;p&gt;Importing a new version from external source&lt;/p&gt;
&lt;p&gt;&lt;b&gt;New page&lt;/b&gt;&lt;/p&gt;&lt;div&gt;&amp;lt;languages /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!-- ShroudForge Modloader Wiki Post&lt;br /&gt;
title: DInput8 chain loading standard&lt;br /&gt;
description: Many Enshrouded mod loaders and DLL mods want to be the game&amp;#039;s `dinput8.dll`, and only one file can have that name. A loader that holds the name starts the other DLLs listed in `dinput8-chain.ini`, next to the game&amp;#039;s exe. EMF, Kiln, ShroudForge, XHL-Core and Auto Loot Plus read this file. This page writes down the rules, so that every loader reads the file the same way and a player&amp;#039;s list works whichever loader holds `dinput8.dll`.&lt;br /&gt;
language: en-GB&lt;br /&gt;
picture:ShroudForge-Wiki-dinput8-chain.svg&lt;br /&gt;
creator: Bonsaibauer&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
[[File:ShroudForge-Wiki-dinput8-chain.svg|thumb|left|600px|DInput8 chain loading standard]]&lt;br /&gt;
&lt;br /&gt;
&amp;lt;br style=&amp;quot;clear:both;&amp;quot; /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
许多 Enshrouded 模组加载器和 DLL 模组都希望成为游戏的 `dinput8.dll`，但这个文件名只能由一个文件占用。占用该名称的加载器会启动游戏可执行文件旁边 `dinput8-chain.ini` 中列出的其他 DLL。EMF、Kiln、ShroudForge、XHL-Core 和 Auto Loot Plus 都会读取此文件。本页记录这些规则，让每个加载器以相同方式读取文件，并使玩家的列表适用于占用 `dinput8.dll` 的任意加载器。&lt;br /&gt;
&lt;br /&gt;
本页以 CC0 方式奉献给公有领域。你可以复制到自己项目的文档中并修改，无需署名。多个加载器共同认可的修改欢迎以 pull request 的方式提交到 EMF 仓库。&lt;br /&gt;
&lt;br /&gt;
下文中的 must 和 should 表示遵循本规范的加载器应有的行为。&lt;br /&gt;
&lt;br /&gt;
&amp;lt;span id=&amp;quot;The_file&amp;quot;&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
== 文件 ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
; my mods&lt;br /&gt;
[Chain]&lt;br /&gt;
mods\mymod\mymod.dll&lt;br /&gt;
autolootplus.dll&lt;br /&gt;
&lt;br /&gt;
[EMF]&lt;br /&gt;
creative.dll&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 位置：`dinput8-chain.ini` 位于游戏可执行文件（`enshrouded.exe` 或 `enshrouded_server.exe`）所在文件夹。&lt;br /&gt;
* 编码：加载器必须读取带或不带 BOM 的 UTF-8，以及带 BOM 的 UTF-16 LE。对于无效 UTF-8 字节，例如旧版记事本保存的文件，也应读取系统 ANSI 代码页。写入文件的工具必须保留检测到的编码和换行符。&lt;br /&gt;
* 行：跳过空行。以 `;`、`#` 或 `//` 开头的行是注释。在 DLL 行前加 `; ` 可关闭该 DLL，而不必删除行。名称后可用空格或制表符添加注释（`mymod.dll ; my mod`），名称也可以用双引号括起。&lt;br /&gt;
* 节区名称不区分大小写。`[Chain]` 是共享节区，遵循本规范的每个加载器都会启动其中的 DLL。其他节区归某个工具所有，并使用其名称，例如 `[EMF]` 或 `[Kiln]`。其他加载器必须忽略这些节区。任何节区之前的行都属于 `[Chain]`。旧文件可能没有节区。&lt;br /&gt;
* `key=value` 行：当 `name=value` 中的值指向 `.dll` 时，它算作 DLL 项。其他键是写入工具自己的设置，其他加载器忽略它们。&lt;br /&gt;
&lt;br /&gt;
&amp;lt;span id=&amp;quot;The_DLLs&amp;quot;&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
== DLL ==&lt;br /&gt;
&lt;br /&gt;
* 路径相对于可执行文件所在文件夹。将 `/` 按 `\` 读取。加载器必须拒绝绝对路径、驱动器号、UNC 路径（`\\server\...`）以及任何 `..` 路径段。链文件不得越出游戏文件夹。&lt;br /&gt;
* 仅允许 `.dll` 文件。指向其他文件类型的行会被跳过并报告。&lt;br /&gt;
* 绝不能加载 `dinput8.dll` 本身，也不得启动自身的另一个副本。例如 EMF 即使遇到改名后的自身文件也会识别并跳过。&lt;br /&gt;
* 每个 DLL 只启动一次。同一 DLL 即使同时列在 `[Chain]` 和工具专属节区，或在同一节区重复出现，也只在第一次出现的位置启动。&lt;br /&gt;
* 顺序：按照行从上到下启动 DLL。`[Chain]` 和加载器自己的节区按它们在文件中出现的顺序处理。&lt;br /&gt;
* 时机：从加载器自己的 `DllMain` 中或紧接其后、游戏代码运行之前调用 `LoadLibrary`。若链式 DLL 本身是 `dinput8.dll`，它也会在此时启动。&lt;br /&gt;
* 最多处理 256 个项目。超出的项目会被报告并跳过。&lt;br /&gt;
* 失败：缺失或无法加载的 DLL 会被跳过并报告。包括 Windows 错误 126，以及其 `DllMain` 失败时的错误 1114。游戏继续运行。&lt;br /&gt;
&lt;br /&gt;
&amp;lt;span id=&amp;quot;Reporting&amp;quot;&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
== 报告 ==&lt;br /&gt;
&lt;br /&gt;
加载器应为每个链式 DLL 记录一行：已启动、因已关闭、被拒绝或已加载而跳过，或记录 Windows 错误号的失败。EMF 也会将相同信息写入 `emf\chain_status.txt` 表格，方便玩家分享。&lt;br /&gt;
&lt;br /&gt;
&amp;lt;span id=&amp;quot;When_you_move_another_tool&amp;amp;#039;s_dinput8.dll&amp;quot;&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
== 移动其他工具的 dinput8.dll ==&lt;br /&gt;
&lt;br /&gt;
安装程序发现其他工具的 `dinput8.dll` 时应重命名而不要删除，将新名称写入自己的 `dinput8-chain.ini` 节区，并在卸载时恢复。EMF 识别工具后会使用 `&amp;lt;tool&amp;gt;.dll`。否则会使用 DLL 版本信息或 `dinput8-previous.dll`，并将移动记录写入 `emf\moved.txt`。&lt;br /&gt;
&lt;br /&gt;
&amp;lt;span id=&amp;quot;Exports&amp;quot;&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
== 导出函数 ==&lt;br /&gt;
&lt;br /&gt;
游戏会对占用 `dinput8.dll` 的加载器调用 `DirectInput8Create`。加载器必须将该调用转发给 Windows 自带的 `dinput8.dll`（`%SystemRoot%\System32\dinput8.dll`）。链式 DLL 不会收到 DirectInput 调用。若模组在 `DirectInput8Create` 中执行逻辑，必须将其移到 `DllMain` 或自己启动的线程中。&lt;br /&gt;
&lt;br /&gt;
&amp;lt;span id=&amp;quot;Who_follows_it&amp;quot;&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
== 遵循此规范的工具 ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! 工具 !! 读取 `[Chain]` !! 自有节区&lt;br /&gt;
|-&lt;br /&gt;
| EMF || 是，也读取任何节区之前的行 || `[EMF]`，用于其安装程序重命名的 DLL&lt;br /&gt;
|-&lt;br /&gt;
| ShroudForge || 是。每个项目必须位于 `mods\&amp;lt;folder&amp;gt;\` 内，其他项目会被报告 ||&lt;br /&gt;
|-&lt;br /&gt;
| Kiln || 是，也读取 `[EMF]`，用于旧版 EMF 安装程序重命名的 DLL || 无。它自己的列表位于 `kiln\chain.ini`。带引号的名称和名称后的注释尚在计划中。&lt;br /&gt;
|-&lt;br /&gt;
| XHL-Core, Auto Loot Plus || 是 ||&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
如果你的工具会读取此文件，或读取方式不同，请告诉我们以便更新表格。&lt;br /&gt;
&lt;br /&gt;
&amp;lt;span id=&amp;quot;Source&amp;quot;&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
== 来源 ==&lt;br /&gt;
&lt;br /&gt;
[https://github.com/matenm/emf-enshrouded/blob/main/docs/modding/dinput8-chain.md EMF 的 dinput8-chain.ini 共享规范]。原始规范以 CC0 方式奉献给公有领域。&lt;br /&gt;
&lt;br /&gt;
[[Category:Modding:Shroudforge]]&lt;/div&gt;</summary>
		<author><name>Bonsaibauer</name></author>
	</entry>
</feed>