Avatar Accessories Helper Scripts RELOADED

UPDATE 4

Made zeroing bone offsets and rotations optional, can be useful if you've tweaked your avatar skeleton but could be confusing if unexpected.. and break old clothes on the new Rex rig more than necessary.

UPDATE 3

Undid the change I did for scaling, breaks it badly for avatars exported without FBX scale (resulting in armatures scaled 100 100 100), still considering how to gracefully handle..

Toggle script should now correctly path to make toggles for nested game objects (e.g. objects buried inside the armature).

UPDATE 2

Accessory installer should more gracefully handle scaling and bones which do not have direct analogs.

Accessory installer also has clearer warnings on buttons that you should not Ctrl+Z, called out below but to reiterated Unity does not like undoing some of these scripted actions and it can crash your editor.

UPDATE 1

An issue with expressions menus not always saving after toggle setup should now be fixed.

Added an option to create a new expressions submenu, created fresh and linked in the chosen parent menu, with your new toggle inside, to hopefully save you some more hunting around for your expression menu files.

RELOADED

Back and better than ever, the latest versions of these scripts are designed to be one-click, no configuration required for the simplest cases of adding bone-parented accessories to your avatar and creating on/off toggles.

Just drag the Helper script onto your accessory gameObject (or find it in the add component interface), click the action button, and you're done. No more unpacking prefabs, no more throwing in an empty animation, they (should) just work. If for any reason they don't auto-find the right stuff in your scene (or maybe you want to try something hacky), all the fields you should need are still exposed.

NOTE

The install script will only work if the bones in the accessory's armature are named EXACTLY the same as the base model's before installation. It will parent each child of the accessory game object to the first child of the avatar game object with the same name, so I HIGHLY recommend always leaving the armature as the first child of the avatar.

CAUTION

Scripts are powerful but unintelligent, make backups and otherwise be careful when using them, some of their operations are one-way so PLEASE REFRAIN FROM UNDOING, it can crash your Unity editor and unsaved changes will be lost. SAVE FREQUENTLY and if anything goes sideways, reload your save.

DISCLAIMER

Scorpius takes no responsibility for loss or damage caused to your avatar, project, computer, or sanity by the malfunction or misuse of these scripts.

If you encounter any bugs or issues PLEASE let me know, I'll be happy to address to the best of my ability. Suggestions for improvements are also very welcome.

To reiterate, these scripts are designed to help you set up accessories and toggleables on an avatar only. They do not do anything for you once in game, and the VRChat SDK will insist that you remove them from any game object in your avatar hierarchy before it will allow you to upload your avatar.

LEGACY

If for any reason you prefer the old scripts, they will remain available here for the foreseeable future.