# WovenFatesPerformanceModule WovenFatesPerformanceModule 是一組為 **平生願** 專案整理的演出用擴充模組，主要聚焦在三個方向： - **Dialogue**：對話框、選項、對話履歷與相關互動觸發 - **Notebook**：可建立、開關、增刪條目並支援翻頁演出的筆記本系統 - **Typing Animation**：可直接顯示於畫面，或掛載到顯示屏上的逐字動畫特效 - **Damage Telegraph 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: - **特效逐字動畫** 在畫面上顯示逐字出現的文字，並可搭配音效、晃動與淡出等效果，用於提示、旁白、內心獨白或特殊文字演出。 - **建立逐字動畫顯示屏** 建立可重用的逐字動畫顯示區，支援背景、行距、最大行數、堆疊方向與推動動畫設定，可讓多條逐字訊息依序堆疊顯示，而不互相重疊。