WovenFatesPerformanceModule

WovenFatesPerformanceModule 是一組為 Woven Fates 專案整理的演出用擴充模組，主要聚焦在三個方向：

• Dialogue：對話框、選項、對話履歷與相關互動觸發
• Notebook：可建立、開關、增刪條目並支援翻頁演出的筆記本系統
• Typing Animation：可直接顯示於畫面，或掛載到顯示屏上的逐字動畫特效

這個模組的目標不是提供底層框架，而是補足事件表中常用的 劇情演出能力，讓對話、筆記、提示文字與資訊呈現能更直接地接入任務流程。

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

非常抱歉，匯入模組時會多出現許多未加載模組的資料夾和過多未必要資源的問題，現已解決。

還請在更新後使用，本模組僅依賴 CgEventsExp + CgEventsLib + TwillightWarsLib。

對於對各位的專案帶來的整理麻煩，真的十分抱歉，本人也是第一次弄模組。

如遇到刷新任務後，逐字動畫顯示屏消失的問題，請勾選「已存在時重建」。

DIALOGUE

Action:

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

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

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

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

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

Trigger:

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

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

NOTEBOOK

Action:

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

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

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

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

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

Trigger:

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

TYPING ANIMATION

Action:

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

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