[PlayCanvas 筆記 05] VIVERSE Extension 使用方法－任務系統 (Quests)

發佈於 2026.01.12 由撰風

這篇文章將介紹如何利用 VIVERSE 擴充功能在 PlayCanvas 專案中建立一套互動式任務系統（Quest System）。透過任務導向的設計，能顯著提升元宇宙空間的趣味性與引導性。

任務系統允許開發者定義一系列目標，讓使用者在探索世界時進行互動。你可以設定簡單的「點擊物件」任務，或是需要收集多個目標的「進度條」任務。

⚠️ 提醒：目前任務系統無法在 PlayCanvas 預覽模式（Preview mode）中測試。你必須在預覽頁面點擊「Create World」正式建立世界後，才能看到任務對話框並進行實測。

範例情境

一個經典的任務流程為例：

範例情境：尋找方塊大作戰

第一步：設定任務資訊

首先，我們需要在專案層級定義任務的名稱與內容。

點擊 Viverse Scene Settings 按鈕。
Quest name：輸入任務名稱（例如：Find the boxes!）。
Quest description：輸入任務描述（例如：點擊指定顏色的方塊）。
設定 Task 1 (點擊單一目標)：
- 描述：Click on the red box.
- Task type：選擇 check。
設定 Task 2 (累積進度目標)：
- 描述：Click on the green boxes.
- Task type：選擇 progressBar。
- Progress Steps：設定為 4（代表需點擊 4 次）。

第二步：建立啟動任務的觸發區域

我們需要一個實體（Entity）來偵測玩家何時開啟任務。

建立一個 3D Box，並加上 Collision 組件。
點擊 Edit Viverse Extension。
在插件下拉選單選擇 TriggerAndAction。
新增 Trigger：選擇 EntitySubscribeTriggerEnter。
- 在 tags to filter 欄位填入 local-player（確保只有玩家觸發）。
新增 Action：選擇 Quest。
- selected quest：選擇刚才建立的 Find the boxes!。
- quest response：選擇 startQuest。

第三步：實作任務互動目標

現在我們要設定紅色、綠色及藍色方塊的互動邏輯。

完成第一項任務（紅色方塊）

建立 3D 物件並賦予紅色材質。
開啟 VIVERSE Extension 並新增 Trigger：NotificationCenterSubscribeEntityPicking（偵測點擊）。
新增 Action：Quest。
- quest response：completeTask。
- selected task：Click on the red box.

累積任務進度（綠色方塊）

任務重置陷阱（藍色方塊）

PlayCanvas & Viverse World

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

PlayCanvas & Viverse World 我的開發筆記