# Install（安装）



# Unity 的版本

### **UniVRM-0.80.0 ～**[​](https://vrm.dev/univrm/install/unity_version/#univrm-0800- "UniVRM-0.80.0 ～ への直接リンク")

结束了对 Unity-2018.4LTS 的支持，开发版本更新为 `Unity-2019.4LTS` 。

<table border="1" id="bkmrk-unity-%E7%89%88%E6%9C%AC-%E5%A4%87%E6%B3%A8-unity-20" style="border-collapse: collapse; border-color: rgb(206, 212, 217);"><thead><tr><th style="border-color: rgb(206, 212, 217);">**Unity 版本**</th><th style="border-color: rgb(206, 212, 217);">**备注**</th></tr></thead><tbody><tr><td style="border-color: rgb(206, 212, 217);">Unity-2019.4 LTS</td><td style="border-color: rgb(206, 212, 217);">用于开发 UniVRM 的版本</td></tr><tr><td style="border-color: rgb(206, 212, 217);">Unity-2020.4 LTS</td><td style="border-color: rgb(206, 212, 217);">用于发布时进行 UPM 测试的版本</td></tr><tr><td style="border-color: rgb(206, 212, 217);">Unity-2021</td><td style="border-color: rgb(206, 212, 217);">如果发生了问题，请到 [github](https://github.com/vrm-c/UniVRM/issues) 报告</td></tr></tbody></table>

### **UniVRM-0.56.0 ～ 0.79.0**[​](https://vrm.dev/univrm/install/unity_version/#univrm-0560--0790 "UniVRM-0.56.0 ～ 0.79.0 への直接リンク")

<table border="1" id="bkmrk-unity-%E7%89%88%E6%9C%AC-%E5%85%BC%E5%AE%B9%E6%80%A7-scripti" style="border-collapse: collapse; border-color: rgb(206, 212, 217); width: 100%;"><thead><tr><th style="border-color: rgb(206, 212, 217); width: 12.9214%;">Unity 版本</th><th style="border-color: rgb(206, 212, 217); width: 8.00884%;">兼容性</th><th style="border-color: rgb(206, 212, 217); width: 19.7674%;">Scripting Runtime Version</th><th style="border-color: rgb(206, 212, 217); width: 7.10594%;">UPM</th><th style="border-color: rgb(206, 212, 217); width: 52.1964%;">备注</th></tr></thead><tbody><tr><td style="border-color: rgb(206, 212, 217); width: 12.9214%;">Unity-2017</td><td class="align-center" style="border-color: rgb(206, 212, 217); width: 8.00884%;">×</td><td style="border-color: rgb(206, 212, 217); width: 19.7674%;">-</td><td class="align-center" style="border-color: rgb(206, 212, 217); width: 7.10594%;"> </td><td style="border-color: rgb(206, 212, 217); width: 52.1964%;"> </td></tr><tr><td style="border-color: rgb(206, 212, 217); width: 12.9214%;">Unity-2018.1</td><td class="align-center" style="border-color: rgb(206, 212, 217); width: 8.00884%;">×</td><td style="border-color: rgb(206, 212, 217); width: 19.7674%;">-</td><td class="align-center" style="border-color: rgb(206, 212, 217); width: 7.10594%;"> </td><td style="border-color: rgb(206, 212, 217); width: 52.1964%;"> </td></tr><tr><td style="border-color: rgb(206, 212, 217); width: 12.9214%;">Unity-2018.2</td><td class="align-center" style="border-color: rgb(206, 212, 217); width: 8.00884%;">×</td><td style="border-color: rgb(206, 212, 217); width: 19.7674%;">-</td><td class="align-center" style="border-color: rgb(206, 212, 217); width: 7.10594%;"> </td><td style="border-color: rgb(206, 212, 217); width: 52.1964%;"> </td></tr><tr><td style="border-color: rgb(206, 212, 217); width: 12.9214%;">Unity-2018.3</td><td class="align-center" style="border-color: rgb(206, 212, 217); width: 8.00884%;">△</td><td style="border-color: rgb(206, 212, 217); width: 19.7674%;">.Net4.X equivalent</td><td class="align-center" style="border-color: rgb(206, 212, 217); width: 7.10594%;"> </td><td style="border-color: rgb(206, 212, 217); width: 52.1964%;">C#7.3。可能可以工作，但未经验证</td></tr><tr><td style="border-color: rgb(206, 212, 217); width: 12.9214%;">Unity-2018.4 LTS</td><td class="align-center" style="border-color: rgb(206, 212, 217); width: 8.00884%;">◎</td><td style="border-color: rgb(206, 212, 217); width: 19.7674%;">.Net4.X equivalent</td><td class="align-center" style="border-color: rgb(206, 212, 217); width: 7.10594%;"> </td><td style="border-color: rgb(206, 212, 217); width: 52.1964%;">用于当前的 UniVRM 开发</td></tr><tr><td style="border-color: rgb(206, 212, 217); width: 12.9214%;">Unity-2019.1</td><td class="align-center" style="border-color: rgb(206, 212, 217); width: 8.00884%;">○</td><td style="border-color: rgb(206, 212, 217); width: 19.7674%;">.Net4.X equivalent</td><td class="align-center" style="border-color: rgb(206, 212, 217); width: 7.10594%;"> </td><td style="border-color: rgb(206, 212, 217); width: 52.1964%;"> </td></tr><tr><td style="border-color: rgb(206, 212, 217); width: 12.9214%;">Unity-2019.2</td><td class="align-center" style="border-color: rgb(206, 212, 217); width: 8.00884%;">○</td><td style="border-color: rgb(206, 212, 217); width: 19.7674%;">-</td><td class="align-center" style="border-color: rgb(206, 212, 217); width: 7.10594%;"> </td><td style="border-color: rgb(206, 212, 217); width: 52.1964%;">由于不再支持 .Net3.5，因此不需要设置 Scripting Runtime Version 版本</td></tr><tr><td style="border-color: rgb(206, 212, 217); width: 12.9214%;">Unity-2019.3</td><td class="align-center" style="border-color: rgb(206, 212, 217); width: 8.00884%;">○</td><td style="border-color: rgb(206, 212, 217); width: 19.7674%;">-</td><td class="align-center" style="border-color: rgb(206, 212, 217); width: 7.10594%;"> </td><td style="border-color: rgb(206, 212, 217); width: 52.1964%;">从 2019.3.4f1 开始， UPM(github的子文件夹)可正常运行</td></tr><tr><td style="border-color: rgb(206, 212, 217); width: 12.9214%;">Unity-2019.4 LTS</td><td class="align-center" style="border-color: rgb(206, 212, 217); width: 8.00884%;">◎</td><td style="border-color: rgb(206, 212, 217); width: 19.7674%;">-</td><td class="align-center" style="border-color: rgb(206, 212, 217); width: 7.10594%;">○</td><td style="border-color: rgb(206, 212, 217); width: 52.1964%;">用于发布时进行 UPM 的测试</td></tr><tr><td style="border-color: rgb(206, 212, 217); width: 12.9214%;">Unity-2020</td><td class="align-center" style="border-color: rgb(206, 212, 217); width: 8.00884%;">○</td><td style="border-color: rgb(206, 212, 217); width: 19.7674%;">-</td><td class="align-center" style="border-color: rgb(206, 212, 217); width: 7.10594%;">○</td><td style="border-color: rgb(206, 212, 217); width: 52.1964%;">Editor機能(Prefabなど)が一部動作せず。`UniVRM-0.69.0` で修正</td></tr></tbody></table>

### **～ UniVRM-0.55**[​](https://vrm.dev/univrm/install/unity_version/#-univrm-055 "～ UniVRM-0.55 への直接リンク")

- 支持Unity-5.6及以上版本

# .unitypackage 文件

请从 [ ](https://github.com/vrm-c/UniVRM/releases)[https://github.com/vrm-c/UniVRM/releases](https://github.com/vrm-c/UniVRM/releases) 下载 `unitypackage`。然后，请按照顺序安装两个包，首先是`UniGLTF_VRMShaders`，然后是`UniVRM`。

<table border="1" id="bkmrk-%C2%A0-unigltf_vrmshaders" style="width: 42.2619%; height: 119.188px; border-collapse: collapse; border-color: rgb(206, 212, 217);"><thead><tr style="height: 29.7969px;"><th style="width: 21.2632%; height: 29.7969px; border-color: rgb(206, 212, 217);"> </th><th style="width: 43.9172%; height: 29.7969px; border-color: rgb(206, 212, 217);">UniGLTF\_VRMShaders</th><th style="width: 19.5246%; height: 29.7969px; border-color: rgb(206, 212, 217);">UniVRM</th><th style="width: 14.9032%; height: 29.7969px; border-color: rgb(206, 212, 217);">VRM</th></tr></thead><tbody><tr style="height: 29.7969px;"><td style="width: 21.2632%; height: 29.7969px; border-color: rgb(206, 212, 217);">for GLTF</td><td style="width: 43.9172%; height: 29.7969px; border-color: rgb(206, 212, 217);">install</td><td style="width: 19.5246%; height: 29.7969px; border-color: rgb(206, 212, 217);"> </td><td style="width: 14.9032%; height: 29.7969px; border-color: rgb(206, 212, 217);"> </td></tr><tr style="height: 29.7969px;"><td style="width: 21.2632%; height: 29.7969px; border-color: rgb(206, 212, 217);">for VRM</td><td style="width: 43.9172%; height: 29.7969px; border-color: rgb(206, 212, 217);">install</td><td style="width: 19.5246%; height: 29.7969px; border-color: rgb(206, 212, 217);">install</td><td style="width: 14.9032%; height: 29.7969px; border-color: rgb(206, 212, 217);"> </td></tr><tr style="height: 29.7969px;"><td style="width: 21.2632%; height: 29.7969px; border-color: rgb(206, 212, 217);">for VRM1</td><td style="width: 43.9172%; height: 29.7969px; border-color: rgb(206, 212, 217);">install</td><td style="width: 19.5246%; height: 29.7969px; border-color: rgb(206, 212, 217);"> </td><td style="width: 14.9032%; height: 29.7969px; border-color: rgb(206, 212, 217);">install</td></tr></tbody></table>

- `Sample` 包已被废弃，但仍然包含在内。
- 可以通过`UPM` 的 `Sample` 功能进行安装。

### **获取.unitypackage**[​](https://vrm.dev/univrm/install/univrm_install/#unitypackage-%E3%81%AE%E5%85%A5%E6%89%8B "unitypackage の入手 への直接リンク")

[https://github.com/vrm-c/UniVRM/releases](https://github.com/vrm-c/UniVRM/releases)

`UniVRM-0.XX.X_XXXX.unitypackage`


### **安装前的准备**

- 创建一个新的 Unity 项目
- 将 `prejectsetings` - `player` - `other sheets` - `rendering` - 将 `colorspace` 设置为 `Linear`(推荐)

[![安装UniVRM前的准备1-by.北溟瞬息.png](https://docs.vrcd.org.cn/uploads/images/gallery/2024-07/scaled-1680-/WAJP8wOhcIC80ZVm-univrm1-by.png)](https://docs.vrcd.org.cn/uploads/images/gallery/2024-07/WAJP8wOhcIC80ZVm-univrm1-by.png)

<p class="callout warning">**如果你的Unity版本是(Unity-2018.3, Unity-2018.4, Unity-2019.1)**  
请将 `ProjectSettings` - `Player` - `Other Settings` - `Scripting Runtime Version` 设置为 `.Net4.X equivalent`。 </p>

<p class="callout warning">**现有项目**  
如果存在旧 UniVRM 版本，请在安装前删除 `Assets/VRM`、`Assets/UniGLTF` (如果存在)、`Assets/VRMShaders` (如果存在) 和 `Assets/Meshutility` (如果存在)。有关更多信息，请参阅[卸载UniVRM](https://vrm.dev/en/univrm/install/univrm_uninstall/)</p>


### **导入 unitypackage**

在菜单栏找到 `Assets` - `Import Package` - Custom Package...，并选择 `UniVRM-0.XX.X_XXXX.unitypackage`。

`Assets/VRM`、`Assets/UniGLTF` 和 `Assets/VRMShaders` 三个文件夹将会被导入到Unity项目中。

[![安装UniVRM前的准备1-by.北溟瞬息.png](https://docs.vrcd.org.cn/uploads/images/gallery/2024-07/scaled-1680-/WAJP8wOhcIC80ZVm-univrm1-by.png)](https://docs.vrcd.org.cn/uploads/images/gallery/2024-07/WAJP8wOhcIC80ZVm-univrm1-by.png)


### **检查UniVRM是否导入成功**

如果UniVRM导入成功，菜单栏显示“VRM”菜单。

[![新版本UniVRM导出-by.北溟瞬息.png](https://docs.vrcd.org.cn/uploads/images/gallery/2024-07/scaled-1680-/GB8Udiqy07Hrhk8P-univrm-by.png)](https://docs.vrcd.org.cn/uploads/images/gallery/2024-07/GB8Udiqy07Hrhk8P-univrm-by.png)

旧版本的菜单：

[![旧版本UniVRM导出-by.北溟瞬息.png](https://docs.vrcd.org.cn/uploads/images/gallery/2024-07/scaled-1680-/Z8t5uOxgSIyk4YQB-univrm-by.png)](https://docs.vrcd.org.cn/uploads/images/gallery/2024-07/Z8t5uOxgSIyk4YQB-univrm-by.png)

<span class="">如果菜单未显示：</span>

- <span class="">打开 Console：点击 Console 窗口左上角的clear 按钮，查看是否出现任何错误（红色消息）</span>

[![打开Console-by.北溟瞬息.png](https://docs.vrcd.org.cn/uploads/images/gallery/2024-07/scaled-1680-/hvHlUxBORpLLl8pJ-console-by.png)](https://docs.vrcd.org.cn/uploads/images/gallery/2024-07/hvHlUxBORpLLl8pJ-console-by.png)[![检查Console是否有报错-by.北溟瞬息.png](https://docs.vrcd.org.cn/uploads/images/gallery/2024-07/scaled-1680-/xOiZAte4Cf2yVTR1-console-by.png)](https://docs.vrcd.org.cn/uploads/images/gallery/2024-07/xOiZAte4Cf2yVTR1-console-by.png)

###   
**相关章节**

[如何制作VRM文件](https://docs.vrcd.org.cn/books/vrm-vrm/chapter/vrm)

[导入VRM](https://docs.vrcd.org.cn/books/vrm-univrm/page/vrm-rCZ)

# UPM

[upm](https://vrm.dev/en/api/upm/)

<p class="callout info">这种安装方式涉及 Git 以及其他相关知识。如果不想学，那直接用 [.unitypackage](https://vrm.dev/en/univrm/install/univrm_install/) 安装就行。</p>

# 卸载UniVRM

请删除以下文件夹:

<table border="1" id="bkmrk-%E6%96%87%E4%BB%B6%E5%A4%B9-%E7%89%88%E6%9C%AC-%E5%A4%87%E6%B3%A8-assets%2Fvrm" style="border-collapse: collapse; border-color: rgb(206, 212, 217);"><thead><tr><th style="border-color: rgb(206, 212, 217);">文件夹</th><th style="border-color: rgb(206, 212, 217);">版本</th><th style="border-color: rgb(206, 212, 217);">备注</th></tr></thead><tbody><tr><td style="border-color: rgb(206, 212, 217);">Assets/VRM</td><td style="border-color: rgb(206, 212, 217);"> </td><td style="border-color: rgb(206, 212, 217);">UniVRM-0.XX.0.unitypackage</td></tr><tr><td style="border-color: rgb(206, 212, 217);">Assets/UniGLTF</td><td style="border-color: rgb(206, 212, 217);">v0.63.0 及以上</td><td style="border-color: rgb(206, 212, 217);">UniVRM-0.XX.0.unitypackage</td></tr><tr><td style="border-color: rgb(206, 212, 217);">Assets/VRMShaders</td><td style="border-color: rgb(206, 212, 217);">v0.56.0 及以上</td><td style="border-color: rgb(206, 212, 217);">UniVRM-0.XX.0.unitypackage</td></tr><tr><td style="border-color: rgb(206, 212, 217);">Assets/MeshUtility</td><td style="border-color: rgb(206, 212, 217);">v0.59.0 至 v0.63.0</td><td style="border-color: rgb(206, 212, 217);">UniVRM-0.XX.0.unitypackage</td></tr></tbody></table>

<table border="1" id="bkmrk-%E6%96%87%E4%BB%B6%E5%A4%B9-%E7%89%88%E6%9C%AC-%E5%A4%87%E6%B3%A8-assets%2Fvrm-1" style="border-collapse: collapse; border-color: rgb(206, 212, 217);"><thead><tr><th style="border-color: rgb(206, 212, 217);">文件夹</th><th style="border-color: rgb(206, 212, 217);">版本</th><th style="border-color: rgb(206, 212, 217);">备注</th></tr></thead><tbody><tr><td style="border-color: rgb(206, 212, 217);">Assets/VRM.Samples</td><td style="border-color: rgb(206, 212, 217);"> </td><td style="border-color: rgb(206, 212, 217);">UniVRM-samples-0.XX.0.unitypackage</td></tr><tr><td style="border-color: rgb(206, 212, 217);">Assets/StreamingAssets/VRM.Samples</td><td style="border-color: rgb(206, 212, 217);"> </td><td style="border-color: rgb(206, 212, 217);">UniVRM-samples-0.XX.0.unitypackage</td></tr></tbody></table>

如果你想在 Unity 项目中将 UniVRM 升级到最新版本，建议删除上面提到的所有文件夹，因为不同版本之间文件/文件夹的位置可能会发生变化。

- 要删除 Unity Package Window（包管理器窗口）安装的软件包，请点击 UPM 窗口软件包界面右下方的 remove 按钮。