DLL Manager

Modloader で Compatibility → DLL Manager を開きます。このパネルの上部にガイドが表示されます。ShroudForge が見つけた Mod DLL と、その読み込み状況を一覧で確認できます。既知の Mod には準備済みプロファイルがあります。それ以外の DLL はここで選択して確認します。

ネイティブ DLL Mod を複数使えますか？

はい。各 Mod を mods/ 直下の個別フォルダーにインストールし、作者が提供したファイルとサブフォルダーをそのまま保持してください。一致するプロファイルが正しい DLL をすでに選択している場合があります。対応するプロファイルがない Mod では DLL Manager の Adjust DLL selection を開きます。作者が指定したエントリー DLL のみを選択してください。読み込み先を選び、その DLL を信頼することを確認します。通常のネイティブライブラリには Normal DLL を使用します。DirectInput proxy は、DirectInput を提供する目的の DLL が DirectInput8Create をエクスポートしている場合に限り選択します。Apply selection をクリックし、ゲームを再起動します。検出されただけでは、プロファイルのない DLL は読み込まれません。DLL Manager で選択を確定するか、native-plugin.ini または dinput8-chain.ini に宣言するか、その Lua Mod から登録する必要があります。

ダウンロードした Mod はどうすればよいですか？

No DLL included: 通常どおり Mod をインストールします。ShroudForge または EML 向けの Mod に追加のネイティブ DLL は不要です。
DLL included: 下記のように Mod の DLL をその Mod フォルダーに置きます。DLL Manager に表示されます。既知のプロファイルでは選択が準備済みです。それ以外の場合は DLL を選択して確認します。
Other mod files included: Mod フォルダー全体を保持してください。mod.json、native-plugin.ini、設定ファイルなどを削除しないでください。

1 つの Mod に複数の DLL ファイルがある場合

多くの Mod フォルダーには補助ファイルとしてのみ使われる DLL があります。Mod プロファイルまたは作者の説明で読み込み対象として指定された DLL だけを選択してください。上下のボタンは、その Mod フォルダー内で選択した DLL の順序を設定します。別々の Mod フォルダーにある通常 DLL のグローバルな手動順序は設定しません。

Mod DLL のインストール

ShroudForge インストーラーがダウンロードした Mod パッケージを認識する場合は、そこでインストールしてください。手動でインストールする場合は、各 Mod 用のフォルダーを mods/ 直下に作成し、DLL をそのフォルダーに入れます。アーカイブ内で DLL が Mod フォルダーの隣にある場合は、Mod と一緒に配置してください。元のファイル名とパッケージのサブフォルダーを維持します。

mods/
  my-mod/
    mod.json        (if included)
    dinput8.dll     (or the mod's DLL)
    config.ini      (if included)

フォルダーに入れただけでは DLL は読み込まれません。上記のとおり DLL Manager で選択してください。

Mod のファイル名が dinput8.dll でもよいのはなぜですか？

ShroudForge 自身の起動ファイルはゲームフォルダー内の dinput8.dll です。Mod のファイルは mods/<mod-folder>/dinput8.dll に別途置きます。ShroudForge はそのフルパスから読み込みます。一致するプロファイルまたは DLL Manager の選択があると、ShroudForge は DirectInput 呼び出しを転送します。両方のファイル名が同じでも問題ありません。Mod のファイル名を変更したり、ゲームフォルダーへ置いたりしないでください。そこにある ShroudForge の起動ファイルを置き換えないでください。

プロファイルについて

プロファイルは既知の Mod 向けに準備された設定です。読み込むファイルと方法を ShroudForge に指示します。mod.json の Mod ID、ID がない場合はフォルダー名で照合します。DLL Manager でプロファイルを選ぶこともできます。プロファイルは Mod ファイルを変更しません。保存済みのカスタム DLL 選択は、プロファイルのファイル選択を置き換えます。

既存の DirectInput チェーン

ゲームフォルダーに既存の dinput8-chain.ini がある場合は、確立された形式を使用します。

[Chain]
mods\my-mod\dinput8.dll
mods\another-mod\native.dll

各項目は mods/<mod-folder>/ のような直下の Mod パッケージ内のファイルを指す必要があります。ゲームルートにある DLL やパッケージ外のパスは拒否されます。記載順は自動的に導出された宣言より優先されます。このファイルは DirectInput プロバイダーのチェーン順を設定するもので、Mod フォルダー間の通常 DLL の順序は設定しません。同じ解決済みファイルパスは 1 回だけ読み込まれます。独自の DirectInput8Create をエクスポートする最初の有効な DLL が転送呼び出しを受け取ります。後続の DirectInput プロキシ DLL も読み込まれる場合がありますが、チェーン内で DirectInput エクスポートは有効になりません。複数のプロキシが連携して動くとは限りません。ShroudForge 自身の起動ファイルは除外され、転送が再帰する場合は元の Windows ライブラリに戻ります。

スイッチ、対象プロセス、再起動

メインスイッチは INI、プロファイル、チェーン、Lua 登録を含む ShroudForge のすべてのネイティブ読み込みを制御します。選択を無効にすると、そのフォルダーの自動読み込みを抑止します。Client、server、both の指定で対象プロセスを決めます。ファイル名の除外は読み込み直前に適用されます。名前から Mod の機能を判別するものではありません。

読み込まれた DLL はプロセスが終了するまでメモリに残ります。無効化、順序変更、別プロファイルの選択にはゲームの再起動が必要です。同じファイルを複数回宣言しても、インスタンスは増えません。

読み込みエラーが表示される

Mod 名、ファイルパス、表示された原因を確認してください。Windows エラー 126 は、メインファイルまたは必要なライブラリのいずれかが欠けていることを示す場合があります。DirectInput エクスポートが見つからない場合は、選択したファイルと読み込みモードを確認してください。「Loaded」は読み込みを確認するもので、Mod のすべての機能を保証するものではありません。

未知のネイティブプラグイン形式、Vulkan レイヤー、追加の完全なローダー、外部プログラムには、それぞれ意図された統合方法が必要です。ライブラリを読み込むだけでは、そのインターフェースの代わりになりません。

パッケージのインストール

インストーラーは入れ子になったアーカイブフォルダーからも単一の Mod パッケージを見つけます。既知のプロファイルは、明示的に指定された関連ファイルを読み込みます。複数の Mod パッケージを含むアーカイブは、グループとして自動インストールされません。展開して、Mod フォルダーを 1 つずつインストールしてください。通常のランタイム動作では、アーカイブを開いたり外部プログラムを起動したりしません。