VRChat Avatar Setup - sync1211/owoskin-vrc GitHub Wiki

Quickstart / Examples

This project includes an example avatar package which showcases the avatar specific features of OWOVRC. The avatar example Unity Package can be downloaded from the Releases Page alongside the OWO Skin avatar prefab.

Setup Requirements

Setting up OWOSuit colliders

NOTE: If your avatar is already set up for Shadoki, you're already good to go!
Avatars that are set up for bHaptics are also supported in limited capacity.

OWOVRC.avatar.webm
  1. Import the OWOSkin Prefab
  2. Drag the OWO Skin Prefab onto your avatar
  3. Align the colliders with your avatar (You do not need to move the colliders into your avatar's hierarchy. Just align them in your scene!)

Importing existing sensation presets

Apart from .owo files, it is also possible to import presets directly for a preset settings file (oscPresets.json).
This file is automatically generated within the program's directory and stores the configuration and presets for the Presets effect. (Importing a settings file does not modify any settings or existing presets.)

This allows for the sharing of presets with other users of OWOVRC. (e.g. alongside an avatar)

OWOVRC.PresetImport.mp4

Setting up custom sensation presets

OWOVRC.Custom.Sensation.Setup.mp4
  1. Download OWO Sensations Creator
  2. Create your sensation and export it as a .owo file
  3. Import it into OWOVRC by switching to "Presets" and clicking "Configure"
  4. Create a parameter as shown on the example avatar

There are 4 example sensations included in this package.

Setting up avatar parameters for presets

Triggering presets

To call a preset, create a boolean parameter named OWO/SensationsTrigger/<YOUR PRESET NAME> and set it to true via a menu or VRC Parameter Driver.

VRC Avatar Parameter driver configuration with a boolean parameter

NOTE: Presets will only be triggered if the OSC value changes. Make sure to reset the values to false or 0 after triggering presets! (See Interrupt parameter for stop behavior)

To control the intensity of the sensation preset, create a float parameter instead and set its value to the desired intensity. (1 = 100%)

VRC Avatar Parameter driver configuration with a float parameter

Triggering presets on specific muscles

To apply a preset to a specific set of muscles, append the muscles/muscle group to the name of the preset.
For example: OWO/SensationsTrigger/<YOUR PRESET NAME>/arm_r will apply the senstion to the right arm only.

NOTE: The sensation needs to be exported with "Export with muscles" set to OFF to be able to control what muscles it runs on!
If no muscle is specified (i.e. if it's triggered via OWO/SensationsTrigger/<YOUR PRESET NAME>) the sensation will play on all muscles!

The following muscles and groups are supported (case-sensitive):

Muscles:

  • pectoral_r
  • pectoral_l
  • abdominal_r
  • abdominal_l
  • arm_r
  • arm_l
  • dorsal_r
  • dorsal_l
  • lumbar_r
  • lumbar_l

Groups:

  • all
  • upperChest
  • frontMuscles
  • backMuscles
  • leftMuscles
  • rightMuscles

Setting up presets on public avatars

OWOVRC only supports triggering sensations via the path OWO/SensationsTrigger/<sensation>.

To map parameters of a public/non-modifiable avatar to sensation presets it is necessary to use a separate software (e.g. TouchOSC) which translates the OSC paths and value ranges to OWOVRCs OSC presets path.

Known OSC mappings:

⚠️ **GitHub.com Fallback** ⚠️