WovenFatesPerformanceModule

WovenFatesPerformanceModule 是一組為 平生願 專案整理的演出用擴充模組，主要有以下功能：

• Dialogue：對話框、選項、對話履歷與相關互動觸發
• Notebook：可建立、開關、增刪條目並支援翻頁演出的筆記本系統
• Typing Animation：可直接顯示於畫面，或掛載到顯示屏上的逐字動畫特效
• Damage Telegraph Zone：可打斷的傷害預警區域
• Vision Zone：可偵測並被障礙遮擋的視野區域。

這個模組的目標不是提供底層框架，而是補足事件表中常用的 演出能力和機制。

讓對話、筆記、提示文字與資訊呈現能更直接地接入任務流程，並設計更有趣的關卡。

具體使用效果可以參考平生願重製版：https://woven-fates.gamelet.online/

本模組依賴 CgEventsExp + CgEventsLib + TwillightWarsLib + TwillightWarsEvents + TwillightWarsEventsEXP。

DIALOGUE

Action:

• 建立對話框
  建立對話框 UI，初始化對話介面的版面、文字區與顯示結構，作為後續顯示台詞與操作履歷的基礎。

• 顯示對話內容
  更新對話框中的角色名稱與台詞內容，用於一般劇情推進與對話演出。

• 顯示對話選項
  顯示可供玩家選擇的對話選項視窗，支援自訂選項內容、位置、字體與外框樣式，可選擇是否等待玩家作答。

• 開啟對話履歷
  開啟對話紀錄視窗，讓玩家查看先前已顯示過的對話內容。

• 關閉對話履歷
  關閉對話紀錄視窗，回到一般對話流程。

Trigger:

• 選中對話選項
  在玩家選中對話選項後觸發，可取得選項視窗 ID 與選中的值，方便把選項結果接回事件表邏輯。

• 滑鼠滾輪觸發
  監聽滑鼠滾輪輸入，可用於開關對話履歷、切換頁面或其他 UI 滾輪互動。

NOTEBOOK

Action:

• 建立筆記本
  建立筆記本 UI 與控制器，初始化封面、頁面、目錄、條目內容、圖片區與翻頁機制。

• 開關筆記本
  控制筆記本的開啟、關閉或切換狀態，可用於劇情中隨時調出或收起筆記本介面。

• 新增筆記條目
  將新條目加入筆記本，支援標題、左右頁內容與圖片資料，適合用於調查、線索收集與資訊整理。

• 刪除筆記條目
  依照條目 ID 或索引刪除指定條目，可用於更新資料、覆蓋舊資訊或同步任務進度。

• 顯示筆記條目
  顯示指定條目內容，或切回筆記本目錄頁，並配合翻頁效果切換內容。

Trigger:

• 筆記本事件觸發
  監聽筆記本的開啟、關閉、回到目錄與選中特定條目等事件，可直接把玩家閱讀行為接入事件表。

TYPING ANIMATION

Action:

• 特效逐字動畫
  在畫面上顯示逐字出現的文字，並可搭配音效、晃動與淡出等效果，用於提示、旁白、內心獨白或特殊文字演出。

• 建立逐字動畫顯示屏
  建立可重用的逐字動畫顯示區，支援背景、行距、最大行數、堆疊方向與推動動畫設定，可讓多條逐字訊息依序堆疊顯示，而不互相重疊。

DAMAGE TELEGRAPH ZONE

Action:

• 建立傷害預警區域
  建立矩形、扇形或圓形傷害預警區域，時間到便會對符合敘述的角色造成一次或持續傷害。

• 打斷傷害預警區域
  打斷特定ID的傷害預警區域。

VISION ZONE

Action:

• 建立視野區域
  建立扇型或圓形視野區域，並可偵測在區域內的角色。

• 設定視野區域顏色
  設定特定ID的視野區域顏色和顯示與否。

Trigger:

• 視野區域偵測
  當角色碰到視野區域時觸發。