EC_HplayTalk 使用説明書【※人数上限解除プラグイン非対応】

1. はじめに

本プラグインは、従来のHシーン会話プラグイン**「EC_HplayMoreExchange」の完全な上位互換・後継プラグイン**です。

従来のバイナリADV保存や複雑なフォルダ階層（ファイル名連番による分岐）を廃止し、完全なプレーンテキストJSON方式へと刷新しました。
ゲームを再起動することなく台詞の追加・修正（ホットリロード）が可能になり、キャラクターの属性情報や体位（アニメーション分類）に応じた自然で高度な会話分岐を実現しています。

同梱されているデフォルトの台詞JSONファイルは日本語以外の言語で記述されています。
日本語環境で使用される場合は、お手数ですが下記のフォルダ内にあるJSONファイルをご自身でお好みの言語（日本語など）に書き換えるか、日本語用の台詞ファイルに差し替えてご利用ください。

▼ 台詞ファイルの保存・差し替え先フォルダ：

Text

[ゲームのインストール先]\BepInEx\plugins\ECHplayTalk\Talks\

(例: 00_默认.json や各種サンプル .json を直接テキストエディタ等で編集、または新規作成した日本語JSONファイルを追加してください)

※注意（文字コードについて）：
ファイルを編集・新規作成する際は、文字化けを防ぐため必ず 「UTF-8（BOMなし）」 で保存してください。

【重要・互換性に関する注意】
本プラグインは、Hシーンの人数上限解除系プラグイン（登場枠拡張・MoreSlot系など）とは互換性がありません（非対応・競合します）。本プラグインを使用する際は、人数上限解除プラグインとの併用を避けてください。

2. 主な特徴

1. 直感的かつ安全なJSON管理
台詞データはすべて BepInEx\plugins\ECHplayTalk\Talks\*.json
で管理されます。1行のエラーで全体が止まることはなく、構文ミスがあるファイルのみをスキップし、何行目に問題があるかをログに出力します。
2. 元の表情を崩さない表情制御（自動リストア）
台詞ごとに眉・目・口・頬の赤み・涙・視線・首の向きなどを指定可能。会話終了時や指定秒数経過後に自動で元の表情・状態へと復元されます。
3. 外部プラグインとのソフト連携（未導入でも動作可能）
– EC_ProfileEx 連携：処女性、恋愛遍歴、関係性（恋人／既婚など）、内心、貞操観念に応じた台詞分岐。
– AnimationLoader（Emotion
Musou）連携：手交、足交、胸交、尻交、ハーレムなどの体位カテゴリを自動判別して専用台詞を再生。
※連携プラグインが存在しない環境でも、エラーにならず「汎用台詞」として安全に動作します。
4. キャラクター別パック設定
ゲーム内で選択中のキャラごとに「どの台詞JSONを有効にするか」を個別に記憶（CharaPacks.json
に自動保存）。キャラごとの性格に合わせた専用台詞セットを維持できます。
5. 洗練された字幕UI
デフォルトで背景枠を排した「映画風の文字のみ表示（黒縁取り付き）」を採用。画面上下左右の中央配置に対応し、選択肢表示中は直前のテキストを隠すなど、没入感を損なわないレイアウトになっています。

3. ショートカットキー＆操作方法

4. 設定パネル（Control Panel）の機能

Hシーン中に Alt + Shift + Y または Memberバーの [Talk] ボタンを押すと設定画面が開きます。

– 総スイッチ（開啟/有効化）：プラグイン全体の動作ON/OFF。
– 台詞ファイル選択（Packs）：
– 現在会話対象となっているキャラクターのチェックボックスリストです。
– チェックを入れたファイルのみが抽選対象になります。
– キャラごとに保存されるため、別キャラに切り替えると自動でそのキャラの設定に切り替わります（[復元默认] で共通デフォルト設定に戻すことも可能）。
– 話者選択（話し手の指定）：
– 「跟随游戏 member 栏里点选的角色」：ゲーム側でクリックしたキャラに追従。
– 「自动」：メイングループの最初の女性キャラを自動選択。
– リスト内のキャラ名を直接クリックして固定することも可能。
– 表示・表情設定：
– 表情変更の有無、表情保持秒数、表情テストボタン。
– 字号（フォントサイズ）、上下中央揃え、左右中央揃えの切り替え。
– 発話インターバル（間隔）：
– 最小〜最大インターバル秒数（デフォルト: 45〜90秒）。
– 各Hパート開始時の初回発話ディレイ秒数。

5. 台詞JSONファイルの書き方（基本構文）

ファイルは BepInEx\plugins\ECHplayTalk\Talks\ 内に配置します。

{
“pack”: “パック名（任意）”,
“nodes”: [
{
“id”: “unique_talk_01”,
“weight”: 10,
“cooldown”: 180,
“when”: {
“class”: [“servehand”],
“phys”: [0],
“heart”: [1]
},
“say”: [
“……こういうの、初めてだから。”,
{
“text”: “あんまり見ないで……恥ずかしい。”,
“face”: { “cheek”: 0.8, “eyeOpen”: 0.4, “mouthOpen”: 0.2 }
}
],
“choices”: [
{
“text”: “すごく気持ちいいよ”,
“say”: [“……なら、よかった。”],
“face”: { “cheek”: 0.5, “eyeOpen”: 0.8 }
},
{
“text”: “（頭を優しく撫でる）”,
“say”: [“んっ……子ども扱いしないで。”]
}
]
}
]
}

【主なタグ・条件一覧】

– when 条件ブロック（省略時は無条件）：
– class: 体位カテゴリ (“default”, “servehand”, “servefoot”, “servebreast”,
“servesiri”, “haremsex”, “haremserve”)
– phys: 肉体状態（0: 処女、1: 経験あり、2: 妊娠）
– love: 恋愛遍歴（0: 未経験、1: 初恋、2: 過去あり）
– rel: 関係性（0: フリー、1: 恋人、2: 婚約、3: 既婚、4〜6: 他人と恋人/婚約/既婚）
– heart: 心の所属（0: なし、1: プレイヤー、2: 現在の相手、3: 意中の他者）
– chast: 貞操観念（0: 堅牢、1: 秩序、2: 流されやすい、3: 打算的、4: 奔放）
– round: 本セッション中の発話回数範囲
– stage: Hパート番号（切り替わるごとに+1）
– プレースホルダー（置換文字）：
– {name} または {她}：ヒロイン名
– {you} または {你}：主人公名
– {对方}：関係性の相手の名前
– {心仪}：想いを寄せている相手の名前

6. AI（Grokなど）を活用した台詞の自動作成について

本プラグインの仕様定義書である write.md を、そのまま Grok（xAI）
等の生成AIに読み込ませることで、理想の性格・シチュエーションに応じた日本語台詞JSONを簡単かつ大量に出力させることができます。

【自動生成の手順】

1. 配布パッケージ内の write.md の内容をコピーし、Grokのプロンプト欄に貼り付けます。
2. 続けて「この仕様書に従って、ツンデレな幼馴染用の日本語H会話JSONを作成して」「クーデレな後輩との手交・足交用JSONを出力して」などのリクエストを入力します。
3. 生成された JSON コードをコピーし、UTF-8（BOMなし）形式で新規 .json ファイルとして保存します。
4. 作成したファイルを、ゲームのインストールフォルダ内にある下記ディレクトリへ配置してください。
[ゲームルート]\BepInEx\plugins\ECHplayTalk\Talks\あなたの作ったファイル名.json
5. ゲーム内で Alt + Shift + R を押してリロードするか、設定パネル（Alt + Shift +
Y）を開いて作成したファイルにチェックを入れると、即座にゲーム内に反映されます。