素材與角色

使用範本素材

範本已登記 Assets/window.png、Assets/guide.png 和 Characters/guide.pxcharacter，可以直接使用：

[bg asset=10000000-0000-4000-8000-000000000001]
[show guide expression=smile position=left scale=0.8]

這個背景 UUID 與 Assets/window.png 指向同一張圖片。UUID 識別資源，source 則記錄它放在哪裡；搬動檔案後，要更新來源路徑並重新驗證。

新增背景

先把有權使用的圖片放到 Assets/garden.png，再於 prismatix.json 的 assets 陣列追加：

{
  "id": "10000000-0000-4000-8000-000000000002",
  "name": "Garden",
  "kind": "background",
  "source": "Assets/garden.png"
}

每個素材要有自己的 UUID。教學專案可使用上面的值，前提是沒有其他素材使用相同 ID。

在故事中切換背景：

[bg Assets/garden.png]

路徑相對於專案根目錄，大小寫也要與檔案一致。驗證通過後，開啟 Preview 確認圖片能正常顯示。

新增角色表情

假設小光多了一張思考的立繪 Assets/guide-thinking.png，先登記圖片：

{
  "id": "20000000-0000-4000-8000-000000000002",
  "name": "Guide thinking",
  "kind": "character",
  "source": "Assets/guide-thinking.png"
}

接著在 Characters/guide.pxcharacter 的 expressions 陣列追加：

{
  "id": "61000000-0000-4000-8000-000000000002",
  "name": "思考",
  "aliases": ["thinking"],
  "assetId": "20000000-0000-4000-8000-000000000002",
  "thumbnailAssetId": null
}

assetId 要對應剛才新增的圖片 ID。保留原本的角色 ID、別名、預設表情和 smile，然後在故事中選擇新表情：

[show guide expression=thinking position=center]
@guide
讓我想一想。

新增另一位角色時，建立新的 .pxcharacter，分別配置角色、表情與圖片 ID，再加到專案的 characters 清單，指定 source 和 alias。

音樂、音效與語音

將媒體放進專案，依相同方式加入 assets。例如：

{
  "id": "70000000-0000-4000-8000-000000000001",
  "name": "Evening music",
  "kind": "audio",
  "source": "Assets/evening.wav"
}

另外準備並登記 bell.wav、greeting.wav 後，可以寫：

[bgm Assets/evening.wav]
[se Assets/bell.wav]
[voice Assets/greeting.wav]
@guide
歡迎回來。

bgm 是背景音樂，se 是音效，voice 是語音。這三個 Story 指令只傳入資源；音量、淡入淡出和音訊通道請使用 Runtime API 的 ctx.audio。

試玩時檢查播放時機、音量，以及跳過、回溯、讀檔後的行為。若有檔案卻無聲，除了路徑，也要檢查實際編碼與裝置；相同副檔名可能包含不同編碼。

字型與授權

範本附上 Noto Sans TC 及授權。Content/Localization/zh-TW.json 的 fontChain 指向專案內的字型；新增語言時，檢查缺字、換行、標點、行高和按鈕寬度。

圖片、音樂、影片和字型都要保留來源與授權資料，發行時一併附上需要的聲明。範本的素材來源紀錄與字型授權也應保留。

缺圖時怎麼查？

先檢查實際檔案與 source 路徑，再核對素材 ID，以及表情中的 assetId。執行 prismatix validate my-game 後，依序用 Preview 和打包後的 Player 試玩。

實作參考：範本設定、角色範本、素材範例。