[PlayCanvas 筆記 06] VIVERSE Extension 使用方法－觸發效果 (Trigger & Actions)

發佈於 2026.01.12 由撰風

在 VIVERSE 中，要讓世界「動起來」不需要寫複雜的程式碼，主要是透過 Trigger（觸發器） 監聽事件，並連結 Action（動作） 執行結果。這一切都在 VIVERSE Extension 的 TriggerAndAction 插件中完成。

核心五元素

我們可以將每個互動寫成概括的公式

如果主體執行動作造成觸發器生效，那麼就讓受體進行指定行為

主體－－誰發動了互動？

觸發動作－－發生了什麼事？

名稱 (Trigger 選項)	說明	核心邏輯
EntitySubscribeTriggerEnter	(主體) 進入觸發器區域	區域感應（如自動門）
EntitySubscribeTriggerLeave	(主體) 離開觸發器區域	區域感應（如離開區域燈滅）
EntitySubscribeCollisionStart	(主體) 撞到觸發器	硬碰硬的實體碰撞
EntitySubscribeCollisionEnd	(主體) 結束碰撞觸發器	離開實體接觸
NotificationCenterSubscribeEntityPicking	(主體) 點擊/觸摸觸發器	滑鼠點選或手指觸控
NotificationCenterSubscribe	收到來自遠方的廣播暗號	統一的發送暗號，所有帶有該暗號的受體開始執行自身指定的動作
EntitySubscribeAnimationStart	動畫開始播放時	流程連動
EntitySubscribeAnimationEnd	動畫播完時	流程連動
EntitySubscribeAnimationEvent	動畫播到特定時間點	精準時間點觸發（如腳落地）

觸發器－－在哪裡發生的？

受體－－誰產生反應？

指定行為－－產生的結果？

類別	Action 選項	效果說明
顯示控制	`EntityEnable` / `Disable`	使受體出現 / 消失
顯示控制	`EntityToggleEnabled`	切換受體的顯示狀態 (開/關)
顯示控制	`EntityFadeIn` / `FadeOut`	使受體淡入 / 淡出 (平滑過渡)
物理碰撞	`EntityEnableCollision` / `Disable`	開啟/關閉碰撞體 (變為可穿透)
移動傳送	`EntityTeleportAvatar`	將 (主體) 傳送到受體的位置
移動傳送	`EntityCheckPoint`	將 (受體) 設為玩家的新重生點
多媒體	`EntityPlaySound` / `StopSound`	播放 / 停止受體的音效
多媒體	`EntityPlayAnimation`	驅動受體播放特定動畫
進階連動	`NotificationCenterPublish`	發送廣播通知 (暗號)
任務系統	`Quest` (多種子選項)	啟動、更新或重置任務進度
效能管理	`EntityAssetUnload` / `Reload`	暫時卸載 / 重載模型資源

用「走入超商感應區，門自動滑開」來實際操作一遍。

第一步：建立「觸發器」與「門」

第二步：設定「觸發動作」與「指定動作」

選取剛才建立的 感應區 Box。
點擊工具列的 Edit Viverse Extension，進入 TriggerAndAction 插件。
設定觸發動作 (Trigger)：
- 點擊 Add Trigger，選擇 EntitySubscribeTriggerEnter。
- 在 Tags to filter 填入 local-player（這很重要！確保只有「玩家」走進去會開門，而不是路過的 NPC 或小球）。
設定指定動作 (Action)：

PlayCanvas & Viverse World

類型	文章
相關文件	Viverse Docs．PlayCanvas Docs
基礎操作	Viverse World．Claude Playcanvas Editor MCP Server．Viverse PlayCanvas Extension (安裝．觸發．媒體．撿拾．坐下)
開發者工具	登入與身分驗證．排行榜
開發筆記	滿版畫面．場景切換．密碼面板．模組化迷宮．科技感效果．對話框．碰撞計分．碰撞計分+遊戲重生．子彈閃避

PlayCanvas & Viverse World 我的開發筆記