VRC - Avatar Component Duplicator

5 ratings

The Avatar component duplicator is a tool to duplicate or update materials, game objects and scripts form one avatar to newer or modiefied versions.

It automatically tries to reassign all script references, rebinds skinned meshes, supports multi object/script duplication and removal of such.

Created to simplify the process of rebuilding an avatar setup after major fbx-model changes.

Also, this tool might come in handy if you want to create different versions (like: full / opti / quest / etc). In this case you can simply copy all objects and scripts, that are identical on both versions and only need to take care about the individual parts.

It features a search bar, that lets you use tags to combine different types of objects and scripts, or exclude certain elements form the list.

All officially allowed avatar components are supported.

The following sections list an overview of the tools functionality:

This tab is used for assigning materials to your target model. It uses the soure model as reference and tries to find the correct material slots on the etarget. Materials are picked by their name, so if you keep the names in your fbx the same as for Unity materials, it will pick everything correctly for you, even if you have different material counts, or a different material order. You can overwrite by picking a different material, or use an entirely different one (via drag and drop). It also allows replacement of already assigned materials.

This section allows you to duplicate game objects, to create deep copies and assign them to your target model. Scripts, that are placed on those objects will have their references changed automatically (like root bones, meshes, or other assigned objects), if necessarry and if those references exist on the target.

Skinned meshes will be reassigned to the target armature.

The scripts section features all "stand alone" scripts.

It lists all the missing scripts, where their "carriers" (game objects) exist on both models like it is the case for most bones, clothes or the avatar´s root.

Scripts can also be updated, to easily apply new settings to all of your avatar versions.

The tool keeps track of errors and offers you a quick way to resolve those issues, if requirements to do so are met.

As long, as your target model is a prefab instance, you can remove everything you duplicated using this tool.

This tool needs the following packages installed:

VRChat SDK - Avatars 3.7.0 or higher.
VRChat SDK - Base 3.7.0 or higher.

Both are added by default to every avatar project created with the Creator Companion (you only need to theck the version numbers in this case).

Things that are not supported by this tool:

Avatars with mixed scalings - Source and target can have different root scales, but their "internals" need to be scaled the same for this tool to work properly.
VRCFury. Those scripts will be duplicated, but not reassigned. You will get log entries for each Fury script found, so you can walk through the list and make changes, if necessarry.
Keep a clean structure and give menaingfull names - this is more of a "best practice" tip, but it will make working with this tool a much better experience.

Do not claim as your own.
Do not resell.
Make backups. I am not responsible for anything that might break by using this tool (especially, but not only with overwriting scripts).