Manual for installing UniVGO in Unity Editor.
version | Win (Editor) | Win (Mono) | Win (IL2CPP) | Android (IL2CPP) | iOS | WebGL |
---|---|---|---|---|---|---|
Unity 2020.3 | OK | OK | OK | OK | unconfirmed | OK |
Unity 2021.1 | OK | OK | OK | OK | unconfirmed | OK |
Unity 2021.2 | OK | OK | OK | OK | unconfirmed | OK |
Unity 2021.3 | OK | OK | OK | OK | unconfirmed | OK |
Unity 2022.1 | OK | OK | OK | unconfirmed | unconfirmed | OK |
Unity 2022.2 | OK | OK | OK | unconfirmed | unconfirmed | OK |
Unity 2022.3 | OK | OK | OK | unconfirmed | unconfirmed | OK |
Unity 2023.1 | OK | OK | OK | OK | unconfirmed | OK |
Unity 2023.2 | OK | OK | OK | unconfirmed | unconfirmed | unconfirmed |
As of January of 2024, we are developing and confirming in Unity 2023.2
, Windows
, .NET Standard 2.1
environment.
If you are using Unity 2021.1.28f1 or lower.
package name | owner | Repository | specification version | program version | release date |
---|---|---|---|---|---|
org.nuget.system.buffers | Microsoft | NuGet | 4.4.0 | 11, Aug, 2017 | |
org.nuget.system.memory | Microsoft | NuGet | 4.5.0 | 29, May, 2018 | |
org.nuget.system.numerics.vectors | Microsoft | NuGet | 4.4.0 | 11, Aug, 2017 |
This package is required for any Unity version.
package name | owner | Repository | specification version | program version | release date |
---|---|---|---|---|---|
com.unity.nuget.newtonsoft-json | Unity Technologies | Nuget | 13.0.2 | 3.2.1 | 2 May, 2023 |
com.vrmc.vrmshaders | vrm-c | GitHub | 0.105.0 | 7 Oct, 2022 | |
com.izayoi.liltoon.shader.utility | IzayoiJiichan | GitHub | 1.7.0 | 18 Jan, 2024 | |
com.izayoi.unishaders | IzayoiJiichan | GitHub | 1.6.1 | 1 Aug, 2023 | |
com.izayoi.vgospringbone | IzayoiJiichan | GitHub | 1.1.2 | 24 Aug, 2022 | |
com.izayoi.univgo | IzayoiJiichan | GitHub | VGO 2.5 | 2.5.20 | 20 Jan, 2024 |
Add if necessary.
package name | owner | Repository | specification version | program version | release date | remarks |
---|---|---|---|---|---|---|
jp.lilxyzw.liltoon | lilxyzw | GitHub | 1.7.2 | 18 Jan, 2024 | ||
org.nuget.sixlabors.imagesharp | SixLabors | Unity NuGet | 2.1.5 | 14 Aug, 2023 | for WebP | |
com.unity.render-pipelines.universal | Unity Technologies | Unity Registry | 14.0.0 | 17 Nov, 2021 | URP only | |
com.unity.render-pipelines.high-definition | Unity Technologies | Unity Registry | 14.0.0 | 17 Nov, 2021 | HDRP only |
Download the UniVGO sample project.
unity version | rendering pipeline | link |
---|---|---|
2021.1.28f1 | BRP | Link |
2021.1.28f1 | URP | Link |
2021.1.28f1 | HDRP | Link |
2021.3.0f1 | BRP | Link |
2021.3.0f1 | URP | Link |
2021.3.0f1 | HDRP | Link |
2022.3.0f1 | BRP | Link |
Install Unity Editor 2021.1.28f1
, 2021.2.0f1
, 2021.3.0f1
, 2022.1.0f1
, 2022.2.0f1
, or 2022.3.0f1
on Unity Hub.
If you don't see the version you're looking for in Unity Hub, install it via the Unity Download Archive.
At the Unity Hub, add the sample project downloaded in step 1 to the list.
The specified folder is the project folder.
If necessary, update the version of the Unity Editor or package.
Unless otherwise noted, we recommend that you use the latest version of UniVGO.
Create a new 3D project in Unity Editor or Unity Hub.
<Project>
Assets
Packages
ProjectSettings
Import UniVGO and dependent packages into your project.
Configure settings in <Project>/Packages/package.json
.
You need to be careful where you add them.
If you are using Unity 2021.1.28f1 or lower, add the following settings. Otherwise, do nothing.
{
"scopedRegistries": [
{
"name": "Unity NuGet",
"url": "https://unitynuget-registry.azurewebsites.net",
"scopes": ["org.nuget"]
}
],
"dependencies": {
"org.nuget.system.buffers": "4.4.0",
"org.nuget.system.memory": "4.5.0",
"org.nuget.system.numerics.vectors": "4.4.0",
}
}
To use UniVGO, add the following settings.
{
"dependencies": {
"com.izayoi.liltoon.shader.utility": "https://github.com/izayoijiichan/lilToonShaderUtility.git#v1.7.0",
"com.izayoi.unishaders": "https://github.com/izayoijiichan/UniShaders.git#v1.6.1",
"com.izayoi.univgo": "https://github.com/izayoijiican/VGO.git#v2.5.20",
"com.izayoi.vgospringbone": "https://github.com/izayoijiichan/VgoSpringBone.git#v1.1.2",
"com.unity.nuget.newtonsoft-json": "3.2.1",
"com.unity.ugui": "1.0.0",
"com.vrmc.vrmshaders": "https://github.com/vrm-c/UniVRM.git?path=/Assets/VRMShaders#v0.105.0",
}
}
If you want to use lilToon, append the line "jp.lilxyzw.liltoon".
{
"dependencies": {
"jp.lilxyzw.liltoon": "https://github.com/lilxyzw/lilToon.git?path=Assets/lilToon#1.7.2",
}
}
If you are using Unity 2021.2 or higher and you want to use WebP, append the line "org.nuget.sixlabors.imagesharp".
{
"scopedRegistries": [
{
"name": "Unity NuGet",
"url": "https://unitynuget-registry.azurewebsites.net",
"scopes": ["org.nuget"]
}
],
"dependencies": {
"org.nuget.sixlabors.imagesharp": "2.1.5",
}
}
If you want to use URP, append the line "com.unity.render-pipelines.universal".
{
"dependencies": {
"com.unity.render-pipelines.universal": "14.0.0",
}
}
- Universal RP 10.10 for Unity 2020.3
- Universal RP 12.1 for Unity 2021.3
- Universal RP 14.0 for Unity 2022.3
- Universal RP 15.0 for Unity 2023.1
If you want to use HDRP, append the line "com.unity.render-pipelines.high-definition".
{
"dependencies": {
"com.unity.render-pipelines.high-definition": "14.0.0",
}
}
- High Definition RP 10.10 for Unity 2020.3
- High Definition RP 12.1 for Unity 2021.3
- High Definition RP 14.0 for Unity 2022.3
- High Definition RP 15.0 for Unity 2023.1
- Open the project in Unity Editor.
- Check that no errors are displayed in the Unity Editor console.
- Check that the menu item
[Tools]
>[UniVGO]
is displayed on the menu bar of Unity Editor.
Possible causes of the error are as follows.
- Unity Editor version is different
- Different package versions
- Duplicate or missing file
asmdef
settings have been changedasmdef.meta
settings have been changed- The
.meta
guid of the component has changed System.Buffers.dll
,System.Memory.dll
,System.Numerics.Vectors.dll
is duplicated.NewtonSoft.Json.dll
is duplicated.- Not getting
LFS
data from GitHub.
When the package is installed in the project, the script is automatically compiled and the following DLL is generated.
assemply | description | UniVgo | UniVgo.Editor |
---|---|---|---|
lilToon.Editor | lilToon shader utility | - | - |
LilToonShader.Utility | lilToon shader utility | * | * |
MToon | MToon shader utility | * | * |
MToon.Editor | MToon shader utility | - | * |
NewtonVgo | for Newton.JSON vgo program | * | * |
ShaderProperty.Runtime | Shader property information | * | * |
UniShader.Hdrp.Utility | HDRP shader utility | * | * |
UniShader.Shared | Unity shader shared utility | * | * |
UniShader.Skybox.Utility | Skybox shader utility | * | * |
UniShader.Standard.Particle.Utility | Standard Particle shader utility | * | * |
UniShader.Standard.Utility | Standard shader utility | * | * |
UniShader.Urp.Particle.Utility | URP Particle shader utility | * | * |
UniShader.Urp.Utility | URP shader utility | * | * |
UniVgo2 | VGO2 main program | * | * |
UniVgo2.Editor | VGO2 import / export | - | * |
VgoSpringBone | VGO Spring Bone | * | * |
VRMShaders.GLTF.IO.Editor | - | - | |
VRMShaders.GLTF.IO.Runtime | * | * | |
VRMShaders.GLTF.UniUnlit.Editor | Unlit shader utility | - | - |
VRMShaders.GLTF.UniUnlit.Runtime | Unlit shader utility | * | * |
VRMShaders.VRM10.MToon10.Editor | MToon 1.0 shader utility | - | - |
VRMShaders.VRM10.MToon10.Runtime | MToon 1.0 shader utility | * | * |
- For each of UniVgo2, and UniVgo2.Editor, * is attached to the dependent DLL.
The version combinations are as follows.
UniVRM | UniVGO | min Unity |
---|---|---|
0.100.0 | 2.5.20 | 2020.3 |
0.101.0 | 2.5.20 | 2020.3 |
0.102.0 | 2.5.20 | 2020.3 |
0.103.2 | 2.5.20 | 2020.3 |
0.104.2 | 2.5.20 | 2020.3 |
0.105.0 | 2.5.20 | 2020.3 |
0.106.0 | 2.5.20 | 2020.3 |
0.107.2 | 2.5.20 | 2020.3 |
0.108.0 | 2.5.20 | 2020.3 |
0.109.0 | 2.5.20 | 2020.3 |
0.110.0 | 2.5.20 | 2020.3 |
0.111.0 | 2.5.20 | 2020.3 |
0.112.0 | 2.5.20 | 2021.3 |
0.113.0 | 2.5.20 | 2021.3 |
0.114.0 | 2.5.20 | 2021.3 |
0.115.0 | 2.5.20 | 2021.3 |
0.116.0 | 2.5.20 | 2021.3 |
0.117.0 | 2.5.20 | 2021.3 |
Write the following in <Project> /Packages/package.json
.
{
"dependencies": {
...
"com.vrmc.gltf": "https://github.com/vrm-c/UniVRM.git?path=/Assets/UniGLTF#v0.105.0",
"com.vrmc.univrm": "https://github.com/vrm-c/UniVRM.git?path=/Assets/VRM#v0.105.0",
"com.vrmc.vrm": "https://github.com/vrm-c/UniVRM.git?path=/Assets/VRM10#v0.105.0",
"com.vrmc.vrmshaders": "https://github.com/vrm-c/UniVRM.git?path=/Assets/VRMShaders#v0.105.0",
...
}
}
For other combinations not listed above, please see the wiki.
https://github.com/izayoijiichan/VGO/wiki/How-to-use-UniVRM-and-UniVGO-together
unity version | rendering pipeline | package | link |
---|---|---|---|
2021.1.28f1 | BRP | UniVGO + UniVRM | Link |
2021.3.0f1 | BRP | UniVGO + UniVRM | Link |
2022.3.0f1 | BRP | UniVGO + UniVRM | Link |
Last updated: 20 January, 2024
Editor: Izayoi Jiichan
Copyright (C) 2020 Izayoi Jiichan. All Rights Reserved.