認識 PrismatiXEngine
安裝工具、寫第一個故事，再加入自己的素材、介面與擴充功能。
PrismatiXEngine 是視覺小說引擎。故事寫在 .pxstory，角色、圖片和介面由專案設定管理；需要額外的遊戲邏輯時，可以用 JavaScript 寫 Extension。
新專案已附上角色、背景、標題畫面和對話介面。先改台詞就能試玩，不需要先學 C++ 或自己做選單。
從哪裡開始？
第一次使用，先看快速開始，建立專案並開啟預覽。接著讀專案結構與撰寫故事，完成一段有兩個選項的劇情。
想換自己的角色與背景，接著看素材與角色。想記錄玩家的選擇，則看變數與條件。
自訂遊戲
UI 教學介紹選單、按鈕和 TSX；Extension 教學帶你新增一個 Story 指令與 UI Action。更多聲音、輸入和畫面控制收在 Runtime API及動畫與特效。
準備發行時，再看多語系、存檔與更新和打包遊戲。查語法可直接開 Story 指令表或 CLI 指令表；遇到錯誤則看疑難排解。
工具各自做什麼？
| 名稱 | 用途 |
|---|---|
| CLI | 建立、驗證、預覽與打包專案，在作者電腦上透過 Node.js 執行 |
@prismatix/authoring-sdk | 把故事與介面編譯成引擎使用的資料 |
@prismatix/runtime | 提供 Extension 的 TypeScript 型別與 API 封裝 |
| Preview | 開發時用來試玩的原生程式 |
| Player | 打包後交給玩家的原生程式，內含執行 Extension 的 QuickJS-NG |
遊戲內不需要 Node.js。TSX 介面也會在建置時轉成原生 UI 資料，不是以 React 網頁執行。
範例怎麼用？
教學中的專案名稱是 my-game。除非另外說明，命令都在它的上一層執行；在專案內操作時，把 my-game 換成 . 即可。
標示「加入欄位」或「追加項目」的 JSON，要合併到現有設定。只有標示完整檔案的範例才整份替換。Story 區塊以純文字顯示，儲存時仍使用 .pxstory 副檔名。新增圖片或聲音的範例則要先準備對應素材。
適用版本
本文依據 2026-09-22 的引擎原始碼 89e1f71e97ed1c61397ef795dc51909706fc6ba3，對應 0.2.0 候選版。當時的安裝測試使用私人 registry；公開 npm 的發布狀態及各平台可用版本，請查看發行紀錄。
目前 Preview 在成功儲存修改後會重開場景，暫存的 Save/Load 也會清除。要測試關閉遊戲後的存檔，請使用 Player。WASM 版本用於 Studio 預覽，尚不是完整的網頁遊戲發行方案。
實作參考：引擎 README、Runtime SDK。