DInput8 チェーン読み込み標準
More actions
Enshrouded の多くの Mod ローダーや DLL Mod はゲームの `dinput8.dll` になろうとしますが、この名前のファイルは 1 つしか置けません。その名前を持つローダーは、ゲームの実行ファイルと同じ場所にある `dinput8-chain.ini` に記載された他の DLL を起動します。EMF、Kiln、ShroudForge、XHL-Core、Auto Loot Plus はこのファイルを読み込みます。このページでは共通の規則を定め、どのローダーが `dinput8.dll` を持つ場合でもプレイヤーの一覧を同じように扱えるようにします。
このページは CC0 のパブリックドメインです。プロジェクトのドキュメントにコピーして変更でき、クレジット表記も不要です。複数のローダーが合意した変更は、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 の行の前に `; ` を付けると削除せずに無効化できます。名前の後に空白またはタブを置いてコメントを書けます(`mymod.dll ; my mod`)。名前を二重引用符で囲むこともできます。
- セクション名は大文字と小文字を区別しません。`[Chain]` は共有され、この仕様に従う各ローダーが記載された DLL を起動します。他のセクションは `[EMF]` や `[Kiln]` のように各ツール専用で、他のローダーは無視します。セクションより前の行は `[Chain]` に属します。古いファイルにはセクションがない場合があります。
- `key=value` 行: 値が `.dll` を示す `name=value` は DLL エントリーです。他のキーは記述したツール固有の設定なので、他のローダーは無視します。
DLL
- パスは実行ファイルのフォルダーからの相対です。`/` は `\` として扱います。絶対パス、ドライブ文字、UNC パス(`\\server\...`)、`..` を含むパスは拒否する必要があります。ゲームフォルダーの外へ出てはいけません。
- `.dll` ファイルのみです。それ以外を示す行はスキップして報告します。
- `dinput8.dll` 自体を読み込んではいけません。ローダー自身の二重起動も禁止です。たとえば EMF は別名でも自身を認識し、そのコピーを起動しません。
- 各 DLL は一度だけ起動します。[Chain] とツール専用セクションの両方、または同じセクションに重複していても最初の位置だけで起動します。
- 順序: DLL は行の上から順に起動します。[Chain] とローダー専用セクションはファイル内で現れる順に扱います。
- タイミング: ゲームコードの実行前に、ローダー自身の `DllMain` から、または直後に `LoadLibrary` を使います。チェーン DLL が `dinput8.dll` 自体だった場合に起動したタイミングです。
- 最大 256 件を処理します。超過分は報告してスキップします。
- 失敗: DLL がない、または読み込みに失敗した場合はスキップして報告します。Windows エラー 126 と `DllMain` の失敗時の 1114 が含まれます。ゲームは続行します。
報告
ローダーはチェーン DLL ごとに、起動、無効・拒否・読み込み済みのためスキップ、または Windows エラー番号付きの失敗を 1 行記録するべきです。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` で処理する Mod は、その処理を `DllMain` または自分が起動するスレッドへ移す必要があります。
この仕様に従うツール
| ツール | `[Chain]` を読む | 独自セクション |
|---|---|---|
| EMF | はい。セクションより前の行も読む | `[EMF]`。インストーラーが名前を変更した DLL 用 |
| ShroudForge | はい。各項目は `mods\<folder>\` 内に必要で、他は報告される | |
| Kiln | はい。旧 EMF インストーラーが名前を変更した DLL 用に `[EMF]` も読む | なし。独自リストは `kiln\chain.ini`。引用符付き名前と名前の後のコメントは予定 |
| XHL-Core, Auto Loot Plus | はい |
ツールがこのファイルを読む場合や解釈が異なる場合は知らせてください。表を更新します。
出典
dinput8-chain.ini の EMF 共通仕様。原仕様は CC0 のパブリックドメインです。