Skip to main content

Modular Avatar

Modular Avatar is a suite of non-destructive tools for modularizing your avatars, and for distributing avatar components. With Modular Avatar, adding a new outfit or gimmick to your avatar is as easy as drag-and-drop!

Modular Avatar's features are packaged as individual components, which can be added as needed. You can opt-in to just the features you want to use. It can automatically merge outfits onto your avatar, build an animator out of multiple components, and much more.

Installation​

The recommended way to install Modular Avatar is using the VRChat Creator Companion. After installing the VCC, click here:

Then, go to "manage project" for your project, and click the + next to Modular Avatar.

VCC UI

To update to the latest version, just click the green arrow in the "Latest Version" column.

Prerelease versions​

To make prerelease versions available in the VCC, click here

Then, in your VCC Settings -> Packages window, uncheck the bd_ repository, check the bd_ prerelease repository, and enable Show pre-release packages.

Pre-release settings

The documentation for the prerelease branch can be found here.

Prerelease versions may contain bugs, and/or may have compatibility breaks as development progresses. Please leave feedback and bug reports at the github issues page.

Installation via ALCOM​

If you are using ALCOM to install Modular Avatar, follow these steps:

  1. Open "Packages" and select "ADD REPOSITORY".
  2. Enter the following values under "Enter informatino about the repository" and click "ADD REPOSITORY":
    • Stable: https://vpm.nadena.dev/vpm.json
    • Prerelease: https://vpm.nadena.dev/vpm-prerelease.json
  3. Confirm the following details are displayed, then click "Add VPM Repository":
    • Repository Name: bd_ or bd_ (prereleases)
    • URL: The URL you entered.

Afterward, open "Manage Project" for your project, click the + next to Modular Avatar, and then click APPLY.

ALCOM Install UI

ALCOM Install Confirm UI

To update to the latest version, click the area with the version number and green arrow, then click APPLY.

ALCOM Update UI

Once you've installed MA, check out one of the tutorials below: