Skip to main content

Installation

If Your Avatar Is Supported​

Importing Packages​

  1. Open your project with the VRChat Creator Companion (VCC).
  2. Install the Modular Avatar package into VCC. (Package link here)
  3. In VCC, open “Manage Project” for your project and add “Gesture Manager,” “Modular Avatar,” and “Non-Destructive Modular Framework.”
  4. Reopen the project and confirm they have been imported.
caution

If Marshmallow PB ver1.7.0 or earlier is already present, move any generated FX from inside “marshmallow_PB/Setup/FX” elsewhere, then delete the marshmallow_PB folder. (Failure to do so may cause errors.)

Installing Marshmallow PB​

  1. Import the latest version of Marshmallow PB.
  2. Right-click on your avatar, then select “wataameya → MarshmallowPB.”
  3. Set the avatar preset in the generated marshmallow_PB_Setup.
  4. From the top menu bar, select “Tools → Gesture Manager Emulator.”
  5. Run Gesture Manager, and if Marshmallow PB moves normally, you are done.
caution

If it does not work correctly, see “If You Run into Trouble” or “Q&A”.



If Your Avatar Is Not Supported​

Installing Marshmallow PB​

  1. Import the latest version of Marshmallow PB.
  2. Right-click on your avatar, then select “wataameya → MarshmallowPB.”
  3. In the generated marshmallow_PB_Setup, do not select any preset and set your chest bone manually.
  4. Remove the avatar’s original chest PhysBone component(s). (In the video, it is mistakenly left on.)
    Make sure to remove any PhysBones assigned to the chest area. There may be more than one on your avatar.
  5. Under marshmallow_PB_Setup, enable “For Unsupported Avatar/marshmallow_PB_L.”
  6. Check the position of the green capsule collider. If invisible, click “Gizmos” at the top of the Scene view.
  7. Move/scale the capsule collider to the left chest area of the avatar. As a reference, from a direct side view, position the pivot (the point you move on the XYZ axes) at the curve boundary (red line) of the chest.
  8. Adjust the scale so the capsule collider fits within the chest.
  9. Run Gesture Manager, and if it works normally, you’re done.
    (When starting, the capsule collider disappears and is replaced by a different collider. It may shift slightly, but that’s normal.)
caution

If you can’t set it properly, refer to “Q&A” or “If You Run into Trouble.”
In particular, not removing the avatar’s original chest PhysBone is a common cause of issues, so be sure you’ve removed it.



Old Method (Without Modular Avatar)​

Not Recommended

Because this method duplicates avatars and FX layers, it is no longer recommended.
Use the new method unless you have a special reason.

For verification, we use Gesture Manager, so it supports only the VRChat Creator Companion (VCC).
(Though not recommended, it will still work if tested in VRChat directly.)

Here is the old-method documentation (Japanese)