POV & Click Trigger（使用説明書）

https://yuki-portal.com/uploader/emotioncreator/78670/

まず、上記の1つのMODが必要です.

POV & Click Trigger MOD – 使用説明書

POV & Click Trigger MOD – 使用説明書

1. MODの概要

このMODは、Emotion CreatorsのADV（ビジュアルノベル）パートに、2つの強力な機能を追加します。

POV機能: ADVの再生中に、指定したキャラクターの一人称視点に切り替えることができます。
クリックトリガー機能: ADVの再生中に、シーン内に配置された特定の3Dオブジェクトをクリック可能にし、クリック時の動作（ADVの選択肢を選択する、または特定のADVノードへジャンプする）を定義できます。

これにより、ADVパートの演出をよりインタラクティブで没入感のあるものにすることが可能になります。

2. 主な機能

GUIによる簡単設定: ADVエディタ内で専用のGUIウィンドウを開き、すべての機能を直感的に設定できます。
キャラクター視点への切り替え: ADVの任意のタイミングで、シーン内のキャラクターの視点（POV）を開始・終了できます。
3Dオブジェクトのクリック化: cylindereventという名前のオブジェクトをADV中にクリック可能にします。
クリック動作のカスタマイズ:
- 選択肢連携: オブジェクトのクリックを、ADVの選択肢ボタン（0番、1番、2番…）のクリックと連動させることができます。
- ノードジャンプ: オブジェクトをクリックした際に、ADVフローチャート上の特定のノードへ直接ジャンプさせることができます。
ホバーテキスト: クリック可能なオブジェクトにマウスカーソルを合わせると、指定したテキスト（例：「触る」「話す」など）を表示できます。
自動クリーンアップ: ADVシーン終了時や、機能を無効化するコマンド実行時に、MODが追加したコンポーネント（当たり判定など）は自動的に削除され、シーンを元の状態に戻します。

3. 使い方

3.1. GUIを開く

ADVエディタ画面で、画面上部にあるメニューから [POV/Click Trigger] をクリックすると、設定用のGUIウィンドウが表示されます。

(画像はイメージです。実際のボタン位置はゲームUIに依存します)

3.2. POV機能の使い方

キャラクター視点に切り替えたい場合に使用します。

キャラクターを選択:
- GUIの「POV 機能」セクションに、現在シーンにいるキャラクターのリストが表示されます。
- 視点を切り替えたいキャラクターの名前を選択してください。
POVの有効/無効を設定:
- [ ] 启用POV (POVを有効化) のチェックボックスで、POVを開始するか終了するかを選択します。
  - チェックを入れる: POVを開始します。
  - チェックを外す: POVを終了します。
コマンドを書き込む:
- ADVエディタで、POVを切り替えたいタイミングのセリフノード（吹き出し）を選択します。
- GUIの [生成并写入 [POV] 指令] ボタンをクリックします。
生成されるコマンド:
- 選択したセリフノードには、以下のようなコマンドが自動的に書き込まれます。
  - 1行目: <LoadPOV>
  - 2行目: enable=true&char_id=0 （例: ID 0 のキャラクターでPOVを開始）
これで、ADV再生時にこのノードを通過すると、指定したキャラクターの視点に切り替わります。POVを終了させたい場合は、別のノードで enable=false のコマンドを書き込んでください。

3.3. クリックトリガー機能の使い方

シーン内のオブジェクトをクリックさせたい場合に使用します。

この機能を使用するには、あらかじめUnityのシーン編集で、クリックさせたいオブジェクトの親オブジェクトに cylinderevent という名前を付けておく必要があります。MODはこの名前を頼りにオブジェクトを検索します。

オブジェクトの準備: シーンに cylinderevent という名前のオブジェクトを必要な数だけ配置します。
機能の有効化:
- ADVエディタで、オブジェクトをクリック可能にしたい開始点のセリフノードを選択します。
- GUIの「クリックトリガー機能」セクションで、クリックイベントを設定します（詳細は後述）。
- [生成并写入 [开启点击] 指令] ボタンをクリックして、有効化コマンドを書き込みます。
機能の無効化（非常に重要）:
- オブジェクトをクリック不可能に戻したい地点のセリフノードを選択します。
- [生成并写入 [关闭点击] 指令] ボタンをクリックして、無効化コマンドを書き込みます。
- ※注意: この無効化処理を行わないと、当たり判定などがシーンに残り続け、予期せぬ問題を引き起こす可能性があります。必ず有効化と無効化はセットで使ってください。

GUIの「イベントリスト」は、シーン内で見つかった cylinderevent オブジェクトの順番に対応しています。

イベントの追加/削除:
- [添加事件]: 設定するイベントを1つ追加します。シーン内の cylinderevent の数に合わせて追加してください。
- [移除最后]: 最後に追加したイベントを削除します。
各イベントの設定:
- ホバーテキスト (悬停文本): マウスカーソルをオブジェクトに合わせた時に表示されるテキストを入力します。
- クリック時の動作:
  - A) ADV選択肢ボタンへの連携 (デフォルト)
    - [ ] 自定义UUID跳转のチェックを 外したまま にします。
    - この場合、イベントの順番がADV選択肢のボタン番号に自動で対応します。
      - イベント #0 → 選択肢ボタン 0 をクリックしたのと同じ効果
      - イベント #1 → 選択肢ボタン 1 をクリックしたのと同じ効果
      - …
    - 生成されるコマンド: serial=auto
  - B) 特定のADVノードへの直接ジャンプ
    - [ ] 自定义UUID跳转のチェックを 入れます。
    - SerialNum: 5 以上の数値を入力します。（内部処理用の固定値と考えてください）
    - [选择节点…]: ボタンを押すと、ADVノードの選択ウィンドウが開きます。
    - ジャンプさせたい先のノード名を探し、その行の [选择] ボタンを押します。
    - これで、オブジェクトをクリックすると指定したノードへADVがジャンプするようになります。
    - 生成されるコマンド: serial=5&uuid=xxxx-xxxx-….

有効化コマンド:
- 1行目: <ConfigureClickEvents>
- 2行目: (イベント1の設定) | (イベント2の設定) | …
  - 各イベントの設定は | で区切られます。
  - 各設定内のパラメータは & で区切られます。
  - 例: serial=auto&hovertext=触る | serial=5&uuid=…&hovertext=話す
    - これは、1番目のオブジェクトはADV選択肢0番に連携し、ホバーテキストは「触る」。2番目のオブジェクトは特定のUUIDにジャンプし、ホバーテキストは「話す」という設定です。
無効化コマンド:
- 1行目: <ConfigureClickEvents>
- 2行目: enable=false

4. 重要な注意点

オブジェクト名: クリック対象のオブジェクト名は必ず cylinderevent にしてください。一文字でも違うと認識されません。
無効化の徹底: クリックトリガー機能を使った後は、必ず無効化コマンドで機能を終了させてください。シーン遷移やADV終了時には自動でクリーンアップされますが、ADVの途中でクリックを不要にする場合は、必ず無効化コマンドが必要です。
イベントの順序: GUIのイベントリストの順序は、Unityシーン内での cylinderevent オブジェクトの階層順など、内部的な検出順に依存します。意図した通りのオブジェクトに設定が適用されているか、テストプレイで必ず確認してください。
クリックの遅延: オブジェクトをクリックしてから実際にアクションが実行されるまで、わずかな遅延（デフォルト0.1秒）が設定されています。これは、意図しない連続クリックによる不具合を防ぐための仕様です。
特殊文字: hovertext に & や | といった記号を含めると、コマンドが正しく解析されない可能性があります。これらの記号の使用は避けてください