”トップページ用”カテゴリより画像をお借りしてます/対策として有効ではなかったため、投稿形式にzipを復活させました。引き続きなりすまし、パスワード付き圧縮ファイルにご注意ください

EC Item & Map Loader (マップ＆アイテム専用サイドローダー)

主な機能と解決する問題

  1. .zipmod 内マップ＆アイテムの完全対応（サイドローダー連携）
    ECの標準システム（AssetBundleCheck.IsFile）はディスク上に実体ファイルが存在するかどうかのみを判定するため、.zipmod 内のバンドルは存在しないものとして処理され、クリックしても何も生成されません（サイレント破棄）。
    本プラグインはファイル存在チェックに介入し、Sideloaderの内部インデックスと連携して .zipmod 内のマップ・アイテムアセットを直接通過・実体化させます。

  2. UIリストの動的キャッシュ再構築（一覧に反映されない問題を解消）
    ECのアイテム一覧リスト（シーン編集の追加画面、および ADV／Hエディットのロード画面）は、起動時に1度だけ辞書を読み込んで固定化する「初回スナップショット」仕様です。本プラグインはリスト生成時に強制的にキャッシュを再構築し、後から追加されたカスタムカテゴリやアイテムを両方のUIへ確実に表示させます。

  3. KK移植アイテムの自動修復（選択不能・パネルが出ない不具合の解消）
    KKから移植されたアイテムは、ECに存在しないコンポーネント（Studio.ItemComponent）が欠落して NullReferenceException が発生し、シーンには出てもツリーに入らずクリック選択もできなくなります。
    本プラグインは生成時に欠落した Map.ItemComponent を自動補完・初期化し、正常にギズモ表示・選択・移動ができる状態へ復旧します。

  4. アイテム追加時の自動選択（ワークパネルの即時展開）
    アイテムを追加した直後、自動的に対象アイテムを選択状態にします。配置した瞬間にプロパティ／操作パネル（ItemUICtrl）が即座に開きます。

  5. 複数フォルダ・別ドライブ検索に対応
    設定ファイルから任意の追加フォルダ（別ドライブのMod保存先など）を指定可能です。

🛠 前提要件

動作には以下のプラグイン／ライブラリが必要です。

  1. BepInEx 5.x (x64)

  2. EC_Sideloader（必須：.zipmod のコア解決に使用します）

  3. (任意) EC_MaterialEditor（シェーダー修復機能を有効にする場合推奨）

📥 インストール方法

  1. ビルドされた EC_ItemMapLoader.dll を以下のフォルダに配置します。

    Text

    EmotionCreators/
└── BepInEx/
    └── plugins/
        └── EC_ItemMapLoader.dll

  2. ゲームを一度起動すると、BepInEx/config/com.custom.ec.itemmaploader.cfg が自動生成され、mods/ 内に専用フォルダが作成されます。

📁 Mod (.zipmod) の配置場所

本ローダーは以下のディレクトリ内の .zipmod を自動スキャンします（最大5階層までのサブフォルダに対応）：

  • 標準フォルダ：

    Text

    EmotionCreators/mods/addzipmod/

    ※通常の mods/ 直下ではなく、mods/addzipmod/ 配下にマップやアイテムの .zipmod を配置してください。

  • 追加フォルダ：
    コンフィグファイルから任意のパスを指定可能です（後述）。

⚙ 設定ファイル (.cfg)

設定ファイルパス：BepInEx/config/com.custom.ec.itemmaploader.cfg

設定項目初期値説明
ExtraModDirectories“” (空欄)追加の .zipmod スキャン先フォルダ。
セミコロン（;）で区切ることで複数指定可能です。
例: D:\EC_Mods;G:\ModArchive\addzipmod
ShaderFixEnabledfalse欠落シェーダー自動修復機能の有効化。
標準ではオフです。初期のKK移植アイテムなどでモデルがピンク色（マテリアル抜け）や真っ黒になる場合は true に変更してください。起動・読み込み時に互換シェーダー（KKUTS等）へ置き換えます。

📑 Mod制作者・移植者向け仕様

マップやアイテムを .zipmod 化する場合、内部のCSV命名および構成を以下のように整えてください。

1. CSV命名規則（大文字小文字不問）

  • アイテム一覧：itemlist_{package番号}.csv（例: itemlist_12.csv）

  • アイテムカテゴリ：itemcategory_{package番号}.csv（例: itemcategory_12.csv）

  • マップ一覧：maplist_{package番号}.csv（例: maplist_12.csv）

2. CSV記述ルール

  • 文字コード：UTF-8 (BOM付き推奨)。Shift-JIS (932) や GBK (936) にも自動判別フォールバックします。

  • ヘッダー行：1〜2行目のヘッダーは自動処理されます（データ開始行の第0列が数値IDであること）。

  • ADV / Hエディットでの表示フラグ（重要）：

    • アイテムリスト（itemlist_*.csv）は 全26列 で構成されます。

    • 第26列（末尾）は ADV フラグです。ここが TRUE になっていないアイテムは、マップ編集画面には出ても ADV／Hエディットのアイテム選択一覧には表示されません（ゲーム側の仕様によるフィルタリング）。

❓ よくある質問とトラブルシューティング

Q. ゲーム内でアイテムやマップが一覧に表示されない

  1. .zipmod の配置場所が EmotionCreators/mods/addzipmod/ になっているか確認してください（mods/ 直下では拾われない場合があります）。

  2. ADV/Hシーンの一覧に出ない場合は、CSVの第26列（ADV列）が TRUE になっているか確認してください。

  3. BepInEx/LogOutput.log を開き、[ItemMapLoader] で検索してリストCSVが正しく検出・注入されているかログを確認してください。

Q. 一覧からアイテムをクリックしても、シーンに出現しない

  • 本プラグインが詳細なエラーをログに出力します。LogOutput.log 内の [ItemMapLoader] 道具实例化失败（インスタンス化失敗）という警告行を確認し、記載されているバンドルパス（bundle）やプレハブ名（file）が .zipmod 内の実際のパスと一致しているか確認してください。

Q. アイテムは出たが、テクスチャがおかしい（ピンク色・真っ黒）

  • ECに対応していないシェーダーが設定されている可能性があります。コンフィグの ShaderFixEnabled を true に設定し、ゲームを再起動してみてください。

コメント

タイトルとURLをコピーしました