EC HPlay Character Swap – 取扱説明書 (README)

『EmotionCreators（エモーションクリエイターズ）』の Hシーン（HPlayScene）中に、登場キャラクターを別のキャラカードへリアルタイムに入れ替えることができる BepInEx プラグインです。

1. 主な機能

• Hシーン中のキャラ差し替え: HPlayScene 内で専用ウィンドウを開き、対象キャラクターを別のカードに切り替えます。

• 直感的な操作: 画面左下のクイックランチャーボタン、ゲーム内UIボタン、またはキーボードショートカットから即座にウィンドウを呼び出せます。

• サムネイル自動読み込み: 選択画面でキャラカードのサムネイルを確認可能です。

• ボーン保護機能: 差し替え時のボーン崩れや読み込み競合を防止するセーフティ機能を搭載しています。

2. 導入方法

1. 前提条件:

   • EmotionCreators 本体

   • BepInEx 5.x が正しくインストールされていること

2. インストール:

   • ダウンロードした ECHplayCharaSwap.dll を、ゲームフォルダ内の BepInEx/plugins/ フォルダに配置してください。

3. アンインストール:

   • 配置した ECHplayCharaSwap.dll を削除してください。

3. 操作方法・呼び出し方

本プラグインは Hシーン（HPlayScene）でのみ動作 します。

ウィンドウを開く方法は以下の3通りです：

1. ショートカットキー:

   • デフォルト: Left Alt + A + S

2. ゲーム内UIボタン:

   • Hシーン右側の操作パネルに追加される換人（キャラ入れ替え）ボタンをクリック

3. 画面左下のランチャーボタン:

   • 画面左下に常駐するアイコンをクリック（設定で非表示にすることも可能）

※ Hシーン以外のシーン（キャラメイクやスタジオ、タイトル画面など）ではウィンドウは開きません。

4. 設定項目 (Configuration)

一度ゲームを起動すると、BepInEx/config/com.yourname.ec.hplay.charaswap.cfg が生成されます。また、ゲーム内で BepInEx ConfigurationManager（F1キー等）から変更することも可能です。

5. 注意事項

• 対応シーンについて:

  • 本プラグインは HPlayScene 専用です。スタジオ等の別モードでのキャラ差し替えには対応していません。

• キャラ読み込み待機:

  • Hシーン開始直後など、キャラクターのロードが完全に終わっていない状態では「未找到角色（キャラ未検出）」と表示される場合があります。ロード完了まで数秒お待ちください。

• カードの互換性:

  • 大幅に構造が異なる衣装MODや特殊なボーンMODを使用しているキャラカードに切り替えた場合、ポーズや衣装が一時的に崩れることがあります。不具合が起きる場合は、設定の GuardBoneRebuild を切り替えてお試しください。