/archive_vrc3cvr

[ Archive ] Convert your VRChat SDK3 avatar to ChilloutVR.

Primary LanguageC#MIT LicenseMIT

Disclaimer: This tool has not been updated in a year. It may work for you but it probably will not. It will not be updated by me unless I play more ChilloutVR (which is unlikely).

Convert a VRChat SDK3 avatar to ChilloutVR with this Unity script.

Tested with:

  • VRChat Avatar SDK3 2021.02.23
  • ChilloutVR CCK 2.3
  • Unity 2019.4.13f1

Tested using avatar Canis Woof by Rezillo Ryker:

Watch video

Usage

Go to Releases and expand "Assets" and download the .unitypackage.

  1. Copy your VRChat avatar Unity project and open it in Unity 2019
  2. Install the ChilloutVR CCK (FAQ channel in their Discord)
  3. Import the vrc3cvr .unitypackage
  4. Click PeanutTools -> VRC Chillout Converter.
  5. Select the VRC avatar you want to convert.
  6. Click Convert.

What does it do?

  • adds a ChilloutVR avatar component (if missing)
  • sets the face mesh
  • sets the visemes
  • sets the blink blendshapes
  • sets the viewpoint and voice position to the VRChat avatar viewpoint
  • adds an advanced avatar setting for each VRChat parameter
    • sliders for all float params
    • toggle for all boolean params
    • dropdown for all int params (toggle if only 1 int found)
  • converts each animator controller (gestures, FX, etc.) to support ChilloutVR's gesture system
    • ChilloutVR only supports float parameters so booleans and ints have been converted
    • references to GestureLeftWeight/GestureRightWeight are converted to GestureLeft/GestureRight (check your Fist animation!)

Mapping gestures

Mapping of VRC gestures to CVR:

Gesture VRC CVR
Nothing 0 0
Fist 1 1
Open Hand 2 -1
Point 3 4
Peace 4 5
Rock'n'Roll 5 6
Gun 6 3
Thumbs Up 7 2

Trigger weight

VRC has two parameters GestureLeftWeight and GestureRightWeight. They do not exist in CVR and instead check GestureLeft amount where 0.5 is 50% of the trigger for the fist animation.

Avatar compatibility

These avatars have been tested and verified to work in ChilloutVR using the tool. Some have notes for manual steps.

  • Canis Woof (Rezillo Ryker)
  • Rexouium (Rezillo Ryker)
    • manual step: add missing parameters ToeMoveH and ToeMoveV
  • Awtter (Shade the Bat)
    • manual step: add missing parameter AFK
    • fix locomotion: remove the motion in state WaitForActionOrAFK in Actions controller and enable "Write Defaults"
  • Shiba Inu (Alucard/Pikapetey)
  • Wickerbeast (Jin A)

Please message via the Discord if you have used the tool on your avatar.

Ideas for future

  • support jaw flap blendshape
  • automatically detect jaw/mouth and move voice position
  • GestureLeftWeight/GestureRightWeight

Troubleshooting

"VRCExpressionParameters.Parameter does not contain a definition for defaultValue" or another VRChat error

Update to a more recent version. Tested with VRChat Avatar SDK3 2021.02.23.

When performing a gesture my hands do not animate

Uncheck "My avatar has custom hand animations" and convert.