安裝與升級指南
從 Booth 下載 Addon、匯入 Unity,再交給 Face Tracking Installer 套用到 Avatar 上。
使用舊版 Addon?
如果 Installer 提示使用舊版安裝工具,請參閱舊版 Addon 文件。想把舊版升級到 2.x,請看從舊版升級。
開始之前
- Avatar 版本相容:Booth 商品頁列有支援的 Avatar 型號與版本,購買前請先核對。
- 專案能正常上傳:準備可上傳 VRChat Avatar 的 Unity 專案,並已匯入 Avatar 本體。
- 保持網路連線:匯入時會下載所需套件,請等 Unity 匯入與編譯完成再繼續。
商品頁還沒列出新版 Avatar?
相容性列表中的版本皆已經過確認,但改裝、其他套件或專案設定仍可能影響效果。若原始 Avatar 推出了新版本,歡迎透過聯絡與支援告知 Avatar 名稱與版本,以及目前的 Addon 版本。
安裝 Addon
從 Booth 購買並下載
在 Triturbo 的 Booth 商店找到對應 Avatar 的 Face Tracking Addon 並購買。購買後,到 Booth 的已購買商品頁面下載 Addon 的 ZIP 檔,並解壓縮取出其中的
.unitypackage。下載清單中有多個檔案時,請下載最新版本。匯入 Unity
把
.unitypackage拖進 Unity 的 Project 視窗,或從 Assets › Import Package › Custom Package 匯入。套件安裝視窗會列出所需的依賴套件,依提示安裝,並等待下載與編譯完成。把 Avatar 放進場景
將要安裝的 Avatar 放進場景,並離開 Play Mode 與 Prefab Mode。
開啟 Face Tracking Installer
從 Unity 上方選單開啟 TriturboFT › Face Tracking Installer。
指定要安裝的 Avatar
在 Hierarchy 找到帶有 VRC Avatar Descriptor 的 Avatar 根物件,拖到 Installer 的投放區;也可以直接點選投放區下方的 Avatar 名稱。
Avatars
Salt
Airi
Lime繁體中文
Face Tracking Framework· 1.1.0Avatar將 Avatar 拖放到這裡或從目前場景中選擇附加組件將根據 Avatar 自動偵測。
網格補丁檢查來源 FBX 版本與 Blendshape 補丁。
變更預覽將會新增或移除的內容。
確認安裝內容
Installer 會自動辨識對應的 Addon,並列出即將套用的內容。按下安裝前,請核對以下幾處:
繁體中文
Face Tracking Framework· 1.1.0
Avatar
Salt (VRC Avatar Descriptor)
1 附加組件v2.0.0「ソルト」(Salt) Face Tracking Addon2 網格補丁FBX原始v1.0.1
補丁v1.1將會套用進階3 變更- + 安裝
Face Tracking SettingsSalt / Face Tracking / - + 安裝
Eye TrackingSalt / Face Tracking / - + 安裝
Mouth TrackingSalt / Face Tracking / - + 安裝
網格補丁 · Bodyv1.1 - + 安裝
網格補丁 · Kemono_Earv1.1
4 表情參數目前用量67 位元新增 Prefab+14 位元安裝後81 / 256 位元- 附加組件 應顯示你匯入的 Addon 名稱。辨識結果不符時,可按「變更…」手動切換。
- 網格補丁 左邊是 Avatar 的 FBX 版本,右邊是將套用的補丁版本。
- 變更 即將加入 Avatar 的 Prefab 與網格補丁。
- 表情參數 安裝後的參數用量,需在 256 位元以內。
- 在複本上操作 想保留原始 Avatar 時勾選,Installer 會先複製一份再安裝。
- + 安裝
按下「安裝」並上傳
出現「安裝完成」後,確認 Avatar 無誤並儲存場景,即可透過 VRChat SDK 上傳。使用複本時,請確認上傳的是安裝完成的那一個。
更新 Addon
Addon 推出新版本(例如 2.0 → 2.1)時,從 Booth 下載新版並匯入同一個專案即可,已安裝的 Avatar 會直接使用更新後的內容,不需要重新安裝。
匯入後,可以開啟 Installer 並拖入 Avatar 確認狀態:主按鈕顯示 已安裝 就代表完成;若網格補丁區顯示「補丁更新可用」,請依提示更新網格。確認後重新上傳 Avatar。
從舊版(1.x)升級到 2.x
舊版 Addon 使用各自的選單(例如 TriturboFT › <Avatar 名稱> FT)安裝,2.x 起統一改用 Face Tracking Installer。已安裝舊版的 Avatar,需要用 Installer 升級一次:
- 備份專案與場景。
- 匯入同一款 Addon 的 2.x 套件。
- 開啟 Installer,拖入已安裝舊版的 Avatar。
- 核對變更內容後按下 升級。
Installer 偵測到舊版的安裝內容時,主按鈕會變成 升級,變更清單會同時列出要移除與要安裝的項目:



Salt (VRC Avatar Descriptor)
補丁v1.1將會套用- − 移除
Face Tracking Menu InstallerSalt / - − 移除
Eye Tracking HDSalt / - − 移除
Mouth Tracking HDSalt / - + 安裝
Face Tracking SettingsSalt / Face Tracking / - + 安裝
Eye TrackingSalt / Face Tracking / - + 安裝
Mouth TrackingSalt / Face Tracking / - + 安裝
網格補丁 · Bodyv1.1 - + 安裝
網格補丁 · Kemono_Earv1.1
- 變更 − 移除 是舊版的 Prefab,+ 安裝 是要換上的 2.x 內容與網格補丁。若曾自行修改舊版的物件或設定,請特別留意被移除的項目。
- 表情參數 舊版 Prefab 釋放的用量會先扣除(虛線區段),再計入 2.x 的用量。
- 在複本上操作 建議勾選,保留原始 Avatar 方便比對。
出現「升級完成」後,檢查新的 Avatar,儲存場景並重新上傳。
建議保留 Face Tracking Prefab
建議保留 Avatar 底下由 Installer 安裝的 Face Tracking Prefab,並避免對這些 Prefab 執行 Unpack Prefab。保留 Prefab 連結有助於 Installer 在升級時辨識已安裝的內容。
Installer 按鈕狀態
| 按鈕 | 意義與處理方式 |
|---|---|
| 安裝 | 尚未安裝。依變更清單安裝所需內容。 |
| 升級 | 偵測到舊版的安裝內容。檢查清單後執行。 |
| 已安裝 | 目前內容已是最新,不需要操作;仍可查看網格補丁狀態。 |
| 需要檢查 | 有需要先解決的問題,請閱讀視窗中的提示。 |
| 開啟舊版 Installer | 這款 Addon 尚未支援新版 Installer,請依提示使用舊版安裝工具。 |
常見問題
找不到 Face Tracking Installer
請確認套件下載與 Unity 編譯皆已完成,並檢查 Console 是否有編譯錯誤。Installer 位於 Unity 上方選單的 TriturboFT › Face Tracking Installer。
Avatar 拖不進投放區
請從 Hierarchy 拖曳帶有 VRC Avatar Descriptor 的 Avatar 根物件,並確認已離開 Play Mode 與 Prefab Mode。
匯入新版後,Avatar 看起來沒有更新
匯入新版套件後,需要重新上傳 Avatar,VRChat 內的 Avatar 才會更新。若是從舊版(1.x)升級到 2.x,還需要先用 Installer 執行升級,詳見從舊版升級。


Hierarchy

