Skip to content

Convert your VRChat SDK3 avatar to ChilloutVR.

License

Notifications You must be signed in to change notification settings

SaracenOne/vrc3cvr

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

  • Keep a BACKUP of your original project.
  • It is not recommend you convert avatars with custom locomotion controllers, only FX and Gesture controllers.
  • This is an experimental fork of the original project (https://github.com/imagitama/vrc3cvr).
  • It supports improved features and bugfixes over the original such as proper layer masking and conversion of VRC proxy animation.

Alternative tool: https://fluffs.gumroad.com/l/sdk3-to-cck

Tested with:

  • VRChat Avatar SDK3 2022.06.03.00.04
  • ChilloutVR CCK 3.3
  • Unity 2019.4.31f1

Tested using avatar Canis Woof by Rezillo Ryker (CanineRez_UnityVRC_V011 from July 2022 with PhysBones):

Video

Watch video

Usage

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

  1. Install the ChilloutVR CCK (FAQ channel in their Discord)
  2. Download and import the vrc3cvr .unitypackage
  3. Click PeanutTools -> VRC3CVR
  4. Select the VRC avatar you want to convert (ensure you have the VRC SDK in the project)
  5. Click Convert

Want to convert your PhysBones to DynamicBones? Use these tools:

You don't need to buy DynamicBones! Use this instead: https://github.com/Markcreator/VRChat-Tools

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
    • 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 at least VRChat Avatar SDK3 2021.02.23.

When performing a gesture my hands do not animate

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

"The type or namespace 'VRC' could not be found"

You need the VRC SDK in your project.

About

Convert your VRChat SDK3 avatar to ChilloutVR.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 100.0%