# WovenFatesPerformanceModule WovenFatesPerformanceModule 是一組為 **平生願** 專案整理的演出與關卡機制擴充模組，讓對話、筆記、提示文字、角色動作與各種互動機制能更直接地接入事件表。 目前依功能分成以下模組： | 模組 | 主要功能 | | --- | --- | | **Dialogue** | 對話框、選項、文本履歷、互動選單、數字密碼與對話泡泡 | | **Notebook** | 筆記本、目錄、圖文條目、多跨頁內容與翻頁演出 | | **TypingAnimation** | 逐字動畫、音效、晃動與訊息堆疊顯示屏 | | **DamageTelegraph** | 可追蹤、瞄準與打斷的傷害預警區域 | | **VisionZones** | 受障礙物遮擋的視野區域與角色進出偵測 | | **DamageThresholdBarrier** | 依單次傷害門檻破裂的防護罩 | | **ActorExtensions** | 拖拽、最近點尋路、真實面向、面向鎖定、組合角色、距離檢查與裝彈觸發 | | **DisplayAttachment** | 讓顯示物件跟隨滑鼠或角色 | | **SpatialSound** | 音量隨聆聽角色與音源距離變化的座標音效 | | **GameTimer** | 隨遊戲暫停而停止累計的畫面計時器 | | **Input** | 滑鼠滾輪觸發與輸入資訊 | | **WorldItems** | 可拾取道具的數量與區域條件檢查 | | **Utilities** | 隨機順序陣列與目前月日 | | **EnginePatches** | 關閉 Shift 戰報選單 | 具體使用效果可以參考 [平生願重製版](https://woven-fates.gamelet.online/)。 **本模組依賴 CgEventsExp、CgEventsLib、TwilightWarsLib、TwilightWarsEvents 與 TwilightWarsEventsExp。** --- ## Dialogue｜對話、選項與履歷 ### Action - **建立對話框** 建立包含頭像框、人物名字與文字區的對話介面，可設定版面與樣式。建立時對話框的透明度為 `0`，需配合「更新顯示物件」調整透明度後顯示。 - **更新對話框內容** 更新人物名字、台詞與頭像，支援逐字顯示。頭像可使用圖片、圖集動畫、圖集單一圖幀或 GAF 動畫。 - **對話選項** 顯示選項視窗，支援自訂選項文字、回傳值、位置與樣式；可等待玩家選擇，並將選擇結果寫入變數與文本履歷。 - **開啟文本履歷** 開啟履歷視窗，讓玩家查看先前記錄的對話內容。 - **關閉文本履歷** 關閉已開啟的履歷視窗。 - **互動選單** 適合較多選項的多欄選單。每個選項可設定顯示條件、啟用條件與選擇後的已選標記，並可保留隱藏選項原本的位置。 - **等待密碼輸入** 顯示數字鍵盤，讓玩家輸入指定位數的密碼，並把輸入結果存入指定的全域變數。支援隱藏輸入數字；密碼是否正確可接續用事件表判斷。 ### Trigger - **選中對話選項** 玩家選中對話選項後觸發，可取得選項視窗 ID 與選中的值，接續處理劇情分支。 ### 對話泡泡 Action - **建立對話泡泡顯示屏** 建立不需暫停遊戲的對話顯示區，可設定往上或往下堆疊、左右對齊、泡泡數量上限、間距與堆疊移動時間，也可將內容寫入指定的文本履歷。 - **顯示對話泡泡** 在指定顯示屏加入一段對話，可選擇頭像或名字，以及對話泡泡或極簡字幕樣式。支援逐字顯示、淡入淡出、依字數自動計時、忽略仍在顯示的重複內容，以及等待泡泡結束。 - **清除對話泡泡顯示屏** 將指定顯示屏中目前存在的泡泡全部淡出，可設定淡出時間及是否等待完成。 對話泡泡需先建立顯示屏，再使用相同的顯示屏 ID 新增或清除內容。 --- ## Notebook｜筆記本 ### Action - **建立筆記本** 建立筆記本 UI 與控制器，包含封面、目錄、左右頁文字、插圖與翻頁演出。 - **筆記本開關** 開啟、關閉或切換筆記本的顯示狀態。 - **新增筆記條目** 新增含標題、左右頁內容與插圖的條目。可在左右內容中加入分頁標記，讓同一條目包含多個雙頁跨頁；預設標記為 `[[PAGE]]`，插圖顯示於第一個跨頁。 - **刪除筆記條目** 依條目 ID 或索引刪除指定條目。 - **顯示筆記條目** 顯示指定條目內容，或切回目錄頁，並配合翻頁效果切換。 ### Trigger - **筆記本事件觸發** 監聽筆記本開啟、關閉、回到目錄與選中條目等事件，將玩家的閱讀行為接入任務流程。 --- ## TypingAnimation｜逐字動畫 ### Action - **特效逐字動畫** 在畫面上顯示逐字出現的文字，可搭配音效、晃動與淡出效果，用於提示、旁白、內心獨白或特殊文字演出，也可加入指定的逐字動畫顯示屏。 - **建立逐字動畫顯示屏** 建立可重用的文字顯示區，可設定背景、行距、最大行數、堆疊方向與推動動畫，讓多條訊息依序排列。 --- ## DamageTelegraph｜傷害預警區域 ### Action - **建立傷害預警區域** 建立矩形、圓形或扇形的預警區域，填滿後對符合角色描述的目標造成一次或週期性傷害。可設定填滿方式、傷害類型、視覺與判定的保留時間，也能關閉傷害，只保留演出。 區域起點可跟隨角色；方向可固定、朝向角色或位置，或跟隨角色面向，並可設定追蹤鎖定時間。 - **打斷傷害預警區域** 依區域代碼打斷預警。預設會檢查區域是否允許打斷；需要強制中止時，可關閉「檢查可被打斷」。 若要使用預設的打斷檢查，建立區域時需勾選「可被打斷」。 --- ## VisionZones｜視野區域 ### Action - **建立視野區域** 建立圓形或扇形視野，可放在固定位置，或跟隨角色位置與面向。支援障礙物遮擋、射線多邊形與格子兩種繪製模式、反向遮罩，以及偵測間隔與目標角色篩選。 - **設定視野區域顏色** 依區域代碼調整填色、透明度、邊線與圖形顯示狀態。 ### Trigger - **視野區域偵測** 可選擇「偵測到任意目標」「新進入目標」或「離開目標」三種模式，並將區域 ID、角色陣列與個別角色代碼存入區域變數。 --- ## ActorExtensions｜角色擴充 ### Action - **角色拖拽** 讓角色經過一段移動過程到達指定位置，或朝目標方向、指定角度移動固定距離。 - **人物最近點尋路** 從候選座標中選擇最近且可到達的位置，控制角色前往。 - **鎖定角色面向** 在指定時間內維持目前面向、固定角度，或持續朝向目標角色／位置。 - **設定角色受擊半徑** 調整指定角色的受擊半徑，供特殊機制或測試使用。 ## DisplayAttachment｜顯示物件跟隨 ### Action - **顯示物件跟隨滑鼠** 讓既有顯示物件跟隨滑鼠，移至最上層滑鼠圖層與關閉互動判定。 - **顯示物件在上層跟隨角色** 讓既有顯示物件跟隨角色位置，並保留在天花板／黑暗遮罩上方，適合角色提示、標記或頭頂資訊。 --- ## SpatialSound｜座標音效 ### Action - **座標音效** 以角色或固定地圖座標作為音源，依音源與指定聆聽角色的距離調整音量。 --- ## GameTimer｜遊戲計時器 ### Action - **遊戲經過時間計時器** 建立顯示於畫面的正向計時器，光暈戰記遊戲暫停時不會累計時間。 --- ## Input｜輸入 ### Trigger - **滑鼠滾輪** 監聽向上、向下或任意方向的滾輪輸入，可取得玩家、滾動方向，適合用於文本履歷、翻頁或其他 UI 互動。 --- ## WorldItems｜可拾取道具 ### Check - **計算地上可拾取道具** 計算指定種類的道具數量，支援選擇地上可拾取的道具，以及角色持有、可放回地上的道具。 --- ## Utilities｜變數工具 ### Action - **建立隨機順序陣列** 依起始值、結束值與變化值建立數字序列，再打亂順序並存入全域變數。 - **取得今天日期** 取得執行當下的月份與日期，分別存入指定全域變數。 --- ## EnginePatches｜系統調整 ### Action - **關閉Shift選單功能** 關閉以 Shift 開啟戰報選單的功能。 ---