安装与升级指南
从 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 比特添加新预制体+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

