A tool to quickly manage simple prop toggles for VRChat Avatar 3.0.
- Quickly add simple props to your VRC Avatar 3.0
- Automatically generates only one layer in the FX animator using blend trees
- Automatically generates VRC menu(s) - it adds a paging system if there are too many props
- Automatically generates VRC parameters (1 bool per prop)
- Uses no constraints of any kinds
- Quickly remove all the props that were added with this asset and cleans up animator, VRC menus, and VRC parameters
- Download and add Animator-As-Code to your Unity project first.
- Download and install the latest version of the unity package for QTPropsManager from the Releases.
- That's it for installing!
- IMPORTANT: It's recommended that you make a backup of your avatar in case anything goes wrong, this asset modifies directly your avatar!
- Before anything else you need to add the prefab from QTAssets/QTProps/QTPropsManager.prefab to your scene
- Add your avatar's VRCAvatarDescriptor to the manager.
- Customize the QT Props Manager options as needed, the table below describes each property.
| Property | Required? | Description |
|---|---|---|
| Avatar | Yes | The VRC Avatar Descriptor of the avatar you want to add props to |
| VRC Submenu parent | No | The menu to which QTProps submenu will be added to, if not specified, it will try to add to the default menu |
- For each prop you want to add, click on the + button.
- Fill in the properties for that prop following the table below.
- If a prop is red, that means something is missing or invalid.
- If a prop is yellow, that means the name is not unique.
- If you want to remove a prop, select the prop first, then click on the - button.
- Click Install / Update to install or update all the props on your avatar.
- Click Uninstall to remove all props added using QTPropsManager from your avatar.
| Property | Required? | Description |
|---|---|---|
| Unique name | Yes | Unique name for the prop toggle |
| Prop GameObject | Yes | The GameObject of the prop to be added, a copy will be created on the avatar |
| Bone to attach to | Yes | What bone the prop should be attached to |
| Menu toggle icon | No | Optional texture to be used in the menu for this toggle |
| Default toggle state | - | Whether the prop should be active by default or not |
| Save toggle state | - | Whether the prop's toggle state should persist between avatar loads |
This asset requires that you install Animator-As-Code
This asset helps with the setup of props by automatically attaching the game objects to the bones specified, generating all the blendtrees for the toggle animations, generating VRC menus and VRC parameters, and managing the clean up to revert all of the installation if that's something you want.
Thank you to Hai for creating Animator-As-Code Thank you to the contributors of this article for writing about using blend trees for toggles
This is MIT license.