Installation
DressingTools is a standalone Unity UPM package and does not require any game or tool SDKs to be installed to work.
This is useful for workflows that is not related to VRChat at all. For example, creating VRM projects, MMD, other VR social platforms or Unity projects that does not support VRCSDK at all.
Via VCC (VRChat Creator Companion)
It is strongly recommended to use VCC for installation since it manages all libraries that DressingTools require and the version of VRCSDK that we support. It also makes updating DressingTools easier for users.
Install the VPM repository with the following button, or add the repository using
Install with VCChttps://vpm.chocopoi.com/index.json
manually.Press
I Understand, Add Repository
to add the repository.Add the DressingTools package to your avatar project.
Open the project and you are good to go!
Via OpenUPM
OpenUPM is a package registry for open-source Unity packages. It can handle package updates and dependencies properly compared to UPM Git URL.
It is recommended to use OpenUPM for installation if you are not using VCC. Especially for users who are not using DressingTools for VRChat.
You can install DressingTools via OpenUPM by following the instructions below.
A. Install via OpenUPM command-line interface (CLI)
If you haven't already, install the OpenUPM CLI by following the instructions on the OpenUPM website.
Run the following command in your project directory to install DressingTools, its dependencies will also be installed automatically:
openupm add com.chocopoi.vrc.dressingtools
B. Install manually via Unity Package Manager (UPM)
Please follow the instrustions:
- Open Edit/Project Settings/Package Manager
- Add the following scoped registry:
- Name:
package.openupm.com
- URL:
https://package.openupm.com
- Scopes:
com.chocopoi.vrc.avatarlib
com.chocopoi.vrc.dressingframework
com.chocopoi.vrc.dressingtools
- Name:
- Click
Save
orApply
- Open Window/Package Manager
- Select
Add package by name...
orAdd package from git URL...
- Paste
com.chocopoi.vrc.dressingtools
intoName
- Paste your desired version (listed here) into
Version
, or leave it empty to get the latest version. - Click
Add
Via .unitypackage
You are always recommended to use VCC for installation if you are using it for VRChat.
Navigate to this website, and download the
DressingTools-x.x.x-with-deps.unitypackage
.Double-click the unitypackage file or drag to your project, and done!
Via zip files
Remove the old packages before copying. Make sure you install the correct versions of the dependencies to work properly.
You can download the zip files directly and decompress them into your Packages
folder. It will look like this:
Packages
|- com.chocopoi.vrc.dressingtools
|- com.chocopoi.vrc.dressingframework
|- com.chocopoi.vrc.avatarlib
- DressingTools
- DressingFramework
- AvatarLib
Via UPM Git URL
Unity does not handle updates and dependencies properly for UPM Git URLs. Make sure you install the correct versions of the dependencies to work properly.
Start the Unity Package Manager
Press
Add package from git URL...
Add the following packages from top to bottom, make sure the required versions match the version of DressingTools that you are installing. Change the version after the
#
to your desired one.- AvatarLib
https://github.com/poi-vrc/AvatarLib.git#1.0.2
- DressingFramework
https://github.com/poi-vrc/DressingFramework.git#1.0.4
- DressingTools
https://github.com/poi-vrc/DressingTools.git#2.0.0
- AvatarLib