WovenFatesPerformanceModule

WovenFatesPerformanceModule 是一組為 平生願 專案整理的演出與關卡機制擴充模組，讓對話、筆記、提示文字、角色動作與各種互動機制能更直接地接入事件表。

目前依功能分成以下模組：

具體使用效果可以參考 平生願重製版。

本模組依賴 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 開啟戰報選單的功能。