DusklightのModマネージャー：Modと読み込み順の仕組み

DusklightのModマネージャーが実際に行うこと

「マネージャー」という名前から大きな外部カタログを想像しがちですが、重要なのは変更を管理できることです。公式Mod APIは、リソースだけを置き換えるMod、C++のネイティブMod、LuauスクリプトModを区別しています。リソース型はディスクのオーバーレイやテクスチャを置き換え、ネイティブ型はゲームコードやフックと連携し、スクリプト型はLuauランタイムを通じてより限定された範囲にアクセスします。種類が違えば、起きる問題も変わります。

最初に、そのバンドルが何に触れるかを確認しましょう。テクスチャ置換なら表示欠落やメモリ負荷、スクリプトならランタイムサービスへの依存、ネイティブライブラリなら使用中のプラットフォーム向けビルドが問題になります。有効化する前に、説明、作者、バージョン、依存関係を記録してください。画面に表示された項目は安全証明ではなく、確認を始めるための手掛かりです。

1. バンドルを確認マネージャーの項目とmod.jsonを読み、名前、id、バージョン、作者を記録します。
2. 範囲を分類他のModと比較する前に、リソース、ネイティブ、スクリプトのどれかを判断します。
3. 基準を残す最初の有効化の前に、Modなしの起動結果とバックアップを保存します。

有効化する前に.duskバンドルを読む

.duskファイルは、一般的にはzipに似た構造を持つバンドルで、複数種類の内容を含められます。ファイル名やサムネイルだけで判断しないでください。メタデータを探し、説明を読み、記載されたバージョンを現在のDusklightと比べます。公式テンプレートには安定したidと説明用フィールドがあり、公式デモにはグラフィック、オーディオ、ランタイムサービスを試すModがあります。

idは似た名前を区別し、versionは実際に試した版を示します。authorはサポート情報を探す手掛かりになり、descriptionはグラフィック、音声、スクリプト、メニューなどの対象を示します。メタデータが足りないことだけで悪意を断定はできませんが、配布元が明確になるまで有効なテストから外す理由になります。元のアーカイブは実行中のデータフォルダー外に置き、配布元と確認日を記録しましょう。

控えめなModの読み込み順を作る

読み込み順とは、複数のModが同じ領域に触れるとき、どのパッケージがリソースを提供または置換する機会を持つかを考えるための言葉です。正確な規則はDusklightの実装とModの種類によって変わるため、フォーラムの数字から普遍的な優先度を作らないでください。作者が示した依存関係や順序の注意を先に読み、マネージャーの表示と公式ノートを確認材料にします。

最初のテストでは、役割が重なるパッケージを離しておきます。2つのテクスチャ置換、同じイベントに接続するスクリプト、実験的なレンダラーと視覚Modの組み合わせは、単独なら動いても原因不明の結果を生みます。バックアップ、最小の変更、再現テスト、次の追加という単純な順序を守りましょう。

1. ゼロから開始Modなしで起動し、メニュー、ゲームプレイ、保存、再読み込みの結果を記録します。
2. 最小の変更を有効化正規の配布元と狭い目的が確認できる1つのパッケージを選びます。
3. 順序を記録次を追加する前に、マネージャーの順番と依存関係を書き留めます。
4. 最後の変更を戻す最初の失敗が出たら、直前に追加したパッケージを無効にします。

変更を一つずつテストする

ゲームが起動しただけでは、互換性を確認したことになりません。タイトル画面とメニューから始め、Modが対象とする内容を使う再現可能なシーンに進みます。対象に含まれる場合は、画像、音声、入力、保存、再読み込みを確認してください。目的はすべての環境で動くと証明することではなく、現在のパッケージ、ビルド、プラットフォームで同じ結果が得られるかを見ることです。

変更前と変更後で、グラフィックバックエンド、解像度、コントローラー、ゲームデータ、シーンをそろえます。ドライバー、入力設定、データ、Mod一覧を同時に変えると、原因を特定できません。id、バージョン、有効な順序、アプリのリリース、プラットフォーム、最初に現れた症状を短く記録しましょう。

• タイトル画面とメニューで、インターフェースの欠落がないか確認する。
• 同じシーンを読み込み、Modの前後で同じ操作を行う。
• 追加のパッケージや設定を入れる前に、保存と再読み込みを確認する。
• 最初の失敗と最後の変更を記録してから環境を戻す。

基準環境を失わずに競合を切り分ける

エラー、アイコン欠落、クラッシュ、黒い画面、何も変わらないパッケージが出ても、最初から複数の設定を変えないでください。最後に追加したModを無効にして同じテストを行います。Modなしで動くなら、パッケージ、順序、互換性が原因候補です。Modなしでも失敗するなら、アプリの版、ゲームデータ、ドライバー、入力層、権限などを確認します。

あるリリースで動いたパッケージが更新後に動かなくなることもあります。公式v1.4.1のリリースノートには、v1.4.0期のテクスチャ置換の読み込み順とUIテクスチャ欠落の修正に加え、プラットフォームとバックエンドの修正も記載されています。マネージャーの不具合と決める前に、アプリの版とパッケージの対応範囲を比べてください。

Modを外し、再現できる結果を報告する

パッケージを外すときは、まずDusklightを終了します。対応していればマネージャーで無効にし、アーカイブや指定されたパッケージフォルダーを日付付きの隔離場所へ移します。すぐ削除するより、試した証拠を残せます。クリーンな環境を起動し、同じシーンと保存テストを繰り返して、症状が消えたかを確認してください。

役に立つ報告には、公式リリース、プラットフォームとアーキテクチャ、パッケージのidと版、マネージャーの状態、読み込み順、失敗するシーン、Modなしの結果を含めます。機密でないログと正規の配布元へのリンクを添え、権利のないゲームデータやアーカイブはアップロードしないでください。

1. ゲームを終了Dusklightが読み込み中のバンドルを移動または置換しないでください。
2. パッケージを隔離試したアーカイブやフォルダーを日付付きの場所へ移し、すぐ削除しません。
3. 基準を確認Modを無効にした状態でメニュー、シーン、保存、再読み込みを繰り返します。
4. 証拠を書くid、版、順序、最初の失敗、クリーンな比較をゲームデータなしで報告します。

DusklightのModマネージャー FAQ