Tutorial:Clothing

This page is mostly rough outlines and notes. Video tutorials at the bottom of the page explain the 'Static' version well.

Resonite provides as with many things, more than one way to do something and adding pre-made clothing to your avatar is no exception. With the exception of simple items such as hats, bracelets or similar accessories most clothing needs has rigging just like like avatars and also could have a number of blendshapes that interact with the model.

This tutorial assumes the user knows how to use the Dev Tool, has already imported and set up their avatar and knows how to use basic Resonate systems such as the Scene Inspector as well as what a slot is and how to drag and move things around in the Avatar's Hierarchy. Everything in this tutorial is also done only using components and avoids ProtoFlux to avoid the use of other tools.

There are two main ways to attach more complicated items to your avatar:

Static:
- Easy and quick, always works, less go wrong.
- Simple context menu toggles to enable/disable clothing items.
- Everything always remains part of your avatar.

Dynamic:
- More fun and flexible but more complicated.
- Allows clothing to be physically removed or even swapped between compatible avatars.
- Leave your clothing spread around the room!
- Also handy for rigged assets you don't want to save with your avatar.

Importing

Mostly: Avatar Importing Guide#Clothing And running: Component:SkinnedMeshRenderer#Optimization over it to strip out blendshapes and bones that are not needed.

Clothing has to match your model's rigging/weight painting and be made to fit if you want it to 'just work'. While it's possible to change things in game to make basic items work, this is not a subject for this tutorial.

It's also possible to separate some clothing/items out of an existing avatar that are controlled by blendshapes using Component:SkinnedMeshRenderer#Blendshape removal for use by the 'Dynamic' method.

Static method

Attaching

Moving model's assets to the model's hierarchy.

Under CenterdRoot is suggested whenever the along with 'Body' mesh is.

Rig

Dragging bones over from avatar's main hierarchy Component:Rig

(Is there a tool?)

Context Menu

For a more detailed Tutorial: Tutorial:Context Menu

BooleanValueDriver<float>: Connecting ButtonToggle to this component's State field allow driving of BlendShapes directly. See component for examples.
ValueMultiDriver: Used if you need to drive a number of fields(For example several clothing items), not just a single one.
Component:MultiBoolConditionDriver: Lets you control what gets turned on and off depending on states.

Dynamic method

Assets need to be attachable and controllable from the avatar and disconnect able when removed. DynVars are the magic that makes this work.

There is a bug with SkinnedMeshRenderer that causes it to glitch it's bones are swapped dynamically. Ways to mitigate this are included.

There are other ways that involve Protoflux, slot searching and the VirtualParent component, however this is a lot more complicated.

Snapper

Moving the model to the avatar and making a named snapper. Component:Snapper

Use: Create Pivot At Center from the Scene Inspector then create a snapper from that?

Suggested to add clothing to somewhere that matches the item. Chest for a hoodie, hips for pants, for example.

Dynvars

On avatar

Inital Component:DynamicVariableSpace on avatar root and use Component:DynamicReference can be used to reference all the bones required.

Create a slot on the avatar for the vars? (Where?)

Suggested to use: Avatar standard#Armature Variables : Mostly he "Bone.Name" ones.

While recommended to do all of them, you could also only include the ones needed for the clothing.

On clothing

Matching dynvars that are needed. Create a slot under the clothing item. Existing bone/rig can be left alone though as it's useful shortly.

Component:DynamicReferenceVariableDriver to connect everything up and revert to original rig when not snapped.

'Bone.Name' for all of the required bones. For each use TargetReference on the rig component and DefaultTarget to original rig.

Dynvars that also drive blendshapes that for example shrink limbs or hide body mesh parts to allow for clothing.

Blendshapes

Avatar standard#Blendshapes

Add: Component:DynamicValueVariable to the clothing to drive the blendshapes to the state you want.

For easier time, use DynamicReferenceVariableDriver to drive bools. Avatar standard has examples of how to drive these.

Materials

These could have problems? Make sure they are all duplicated on the model.

Context menu

While toggles to hide clothing are less needed, other options might be useful.

The context menu needs to be installed on the clothing snapper so it can be removed along with the rest of the assets. The easiest way is to create a new context menu compete with Component:RootContextMenuItem, however using DynVars to drive the Parent Slot of a simplified menu to place it under an existing avatar context menu also works.

Menu options that 'lock' clothing if you don't want to only use grab permissions. Driving Enabled on Component:Grabbable

Permisions

Component:DestroyProxy and avatar protection and destroy on user leave. Adding Component:SimpleAvatarProtection

Grab permisions so only you can take your stuff off.

Videos

Static method:

Matching clothing toggles: