處理角色
角色（actor）是載入場景中的模型。DanceXR 會即時調整模型的骨骼以適應動作，並使用物理系統模擬頭髮和服裝的動態。
您可以透過更改材質、套用紋理，或使用裝扮系統（dressing system）來切換服裝單品，來客製化模型的外觀。您還可以調整模型的比例和位置，並微調其與舞台和其他角色的互動方式。
關於這裡使用的術語（角色、選取圓盤、縮放立方體、裝扮系統）的詞彙表，請參閱 Concepts & glossary。
載入角色
DanceXR 會讀取四種模型格式：
- PMX — MikuMikuDance 格式。包含內建的骨骼層級、物理綁定和形態列表。
- XPS — XNALara / XPS 格式（
.xps,.mesh,.mesh.ascii）。不包含物理綁定或標準骨骼，因此您需要在 DanceXR 中設定這些內容。 - FBX (預覽版，2025.9 起) — 通用 3D 格式。DanceXR 會載入模型、其材質以及檔案中的形態，但無法載入嵌入的動畫或其他 FBX 專屬功能。骨骼會在模型載入時自動映射，遺漏之處可用 骨骼映射器 修正。
- VRM (2026.11 起) — VRoid 等工具使用的虛擬形象格式（
.vrm）。骨骼來自檔案中儲存的人形映射，檔案的授權條款（作者、是否可用作虛擬形象、商用、署名）會顯示在角色選單中。與 FBX 一樣，DanceXR 會載入模型、其材質和表情，但不使用 VRM 的彈簧骨骼，因此頭髮和裙子的物理會被自動偵測並在物理工具中設定。
這些格式也可以打包成 ZIP。請參閱 ZIP 格式 以了解檔案命名規則和編碼。
兩種載入方式
- 拖放 模型檔案（或 zip）到 DanceXR 視窗。對於單次載入非常快速。
- 內容庫 — 將模型放入您 content library 中的
actors/資料夾。它們將出現在角色選單的 載入模型 清單中。
替換 vs 新增
預設情況下，載入模型會 替換 當前選取的角色。如果您想將模型作為額外的角色新增，請點擊模型名稱旁邊的 + 圖標。多角色場景需要專業版（paid build）——請參閱 Download & editions。
載入選項
Loader options 控制新角色的載入方式：快取大小、紋理壓縮、過渡效果和自動角色切換。
PMX 與 XPS 與 FBX 與 VRM — 有何不同
大多數設定在這四種格式上都是相同的。它們分歧的地方值得了解：
| 主題 | PMX | XPS | FBX (預覽版) | VRM |
|---|---|---|---|---|
| 骨骼 | 檔案中的標準骨骼名稱 | 透過 骨骼映射器 映射 | 自動映射，可在 骨骼映射器 中修正 | 使用檔案中的人形映射，可在 骨骼映射器 中修正 |
| 物理綁定 | 建置在檔案內（PMX 物理） | 物理設定 | XPS 物理設定 | 物理設定（自動偵測頭髮和裙子鏈；不使用檔案中的彈簧骨骼） |
| 形態 / 混合形狀 | 形態列表 | 無 — 請改用 裝扮系統 | 檔案中有則會匯入 | 從檔案匯入（表情） |
| 服裝切換 | 材質形態（PMX） | 選用物品（XPS）— 使用相同 UI (裝扮系統) | 無 | 無 |
如果本指南提到「僅限 PMX」或「僅限 XPS」，那就是原因所在。FBX 支援作為預覽版（截至 2025.9），模型幾何、材質和形態會載入，但檔案內部的動畫和其他 FBX 功能會被忽略。VRM 模型（2026.11 新增）以同樣方式讀取，其授權條款會顯示在角色選單中。
角色選單
每個角色腳下都有一個黃色的 選取圓盤。點擊它會開啟角色選單 — 這是所有角色相關設定的中央樞紐。請參閱 Actor menu & tools 了解完整詳情。
選單分為以下幾個組件：
- 動作 — 分配的動作、隊形 槽位和特定模型的動作設定。
- 最近修改 — 快速跳轉到您剛剛修改過的對話框。請參閱 Recently modified settings。
- 裝扮與紋理 — 裝扮系統、骨骼映射器 (XPS)、alternative textures。
- 材質 — 每槽位設定：皮膚、頭髮、眼睛、嘴唇、不透明、透明、自定義。請參閱 Appearance & materials 了解槽位之間的搭配關係。
- 設定 — 物理、feet adjustment、facial control、eye contact、troubleshooting。
- 專業版 (paid builds) — outfit & body paint、accessory、ragdoll、motion override、light ball、進階物理、NSFW 疊層。
- 形態列表 (僅限 PMX) — PMX 混合形狀。
- 工具 (扳手和錘子圖標) — 收藏、標籤、spectator、向上/向下移動、重置、duplicate、重新載入、3D snapshot、移除。
多角色場景
當舞台上有超過一個角色時，有三個功能用於處理群組行為：
- Formation — 將角色排列成特定隊形（直線、網格、自定義）。順序由工具選單中的 Move Up / Move Down 決定。
- Actor playlist — 隨時間依序播放清單中的模型，可選同步音樂。
- Attach to actor — 將一個角色或配件父級化給另一個角色（拿著的物品、懸掛物、配對動作）。
使用 Spectator mode 可以讓模型停留在舞台上，但排除其自動分配的動作和隊形槽位。
Global actor control 對每個角色套用一個設定——當您希望所有載入的模型共享相同的物理調整、裝扮或材質時非常有用。
快照和預設
儲存您所建構內容有三種方式：
- 3D snapshot — 將當前姿態匯出為 OBJ 格式，可用於其他 3D 工具。
- Actor presets — 儲存角色的設定（材質、物理、裝扮），以便日後將相同的外觀套用給相同模型，或相似的模型。
- Save scene 和 scene bundle — 捕捉包含所有角色、動作、舞台和配置的整個場景。
遇到錯誤
症狀先行式排除故障：
| 症狀 | 應檢查處 |
|---|---|
| 模型載入但一切都是白色的 | FAQ → Model loads but everything is white |
| 模型固定在標準姿勢 | XPS bone mapper、Example bone structure |
| 漂浮、下沉、在地面滑動 | Feet adjustment |
| 尺寸或位置不正確 | Scale & offset |
| 頭髮/裙子/布料不移動或抖動 | Physics system |
| 每個模型有奇怪的行為 | Actor troubleshooting |
| 應用程式層級崩潰，無法啟動 | Troubleshooting、FAQ |