Change the avatar's existing menu

When to use this

Your avatar came with a menu, or another tool adds items to it. AvatarDoc shows those items in its tree, next to your own entries, and can change how they appear. The original menu asset and the other tool are never changed. AvatarDoc keeps each change on its own component and applies it when you upload.

To take an item out of the avatar completely, with its parameter, see Remove things from the avatar. To turn an item of VRCFury or Modular Avatar into an AvatarDoc entry, see Convert from VRCFury or Modular Avatar.

Steps

1. In the Hierarchy, select the object that holds your AvatarDoc component.

2. In the tree, select a row with an existing chip, from the avatar's own menu, or with a VRCFury or Modular Avatar chip.

   The tree shows these chips only while it is at least 360 pixels wide: on a narrower inspector, widen it to see them. At every width, these rows are dimmed and have a square icon.

   You should now see a panel titled Existing item.

3. To rename the item, type a new name into Name and press Enter.

   You should now see the new name in the tree, and the old one under the field, such as Original: Sit. The Style row can colour the name, as for your own entries.

4. To give it another icon, drag a texture from the Project window onto Icon.

5. To move it into another submenu, press the arrow button at the right end of Move to and pick a submenu, or Root for the top of the menu.

   You should now see the item in its new place in the tree. You can also type a path, such as Emotes, into the field. (stay where it is) undoes the move.

6. To take it out of the menu, untick In menu.

   In the picture, the avatar's Sit toggle is renamed Sit down and moved into the Emotes submenu. 1 is Name, 2 Move to, 3 In menu, 4 Remove from avatar, which Remove things from the avatar explains, and 5 Reset.

You can also drag the row onto a submenu row in the tree to move it. A right click on the row offers Move to, Hide or Show, and Reset.

An item you changed carries an edited chip. An item you took out of the menu stays in the tree with a hidden chip, so you can find it again. Reset puts the item back exactly as it was. It is greyed out while nothing is changed.

With In menu off, the item leaves the menu, but its parameter and its animator layer keep working and keep costing synced bits.

AvatarDoc applies your changes to the avatar's own items while it builds its own menu. It applies the changes to Modular Avatar's items right after Modular Avatar, and the changes to VRCFury's items after VRCFury, so they reach the menu those tools build. The panel of another tool's item says so.

Your own entries are not changed here: select them and edit their own panel.

Check it worked

• Press Wheel on the toolbar (Advanced mode) and select the submenu. The wheel shows it the way VRChat draws it, with the new names and icons, and without the hidden items.
• In Play mode with Gesture Manager, open Expressions and look through the submenus. See Your first toggle for Play mode.

If it does not work

• A warning says a saved change cannot apply because its menu item was not found: the item was deleted, renamed elsewhere or converted. The header lists the change with a Remove button that clears it. See the message.
• The move is refused with a note that an item cannot move into itself: a submenu cannot go into itself or into one of its own submenus. Pick another place. See the error for the same problem at upload.
• A warning says a saved change points at an AvatarDoc entry: one of your own entries now sits where the changed item was, so the change is ignored. Edit that entry in its own panel instead. See the message.

Related

• The inspector at a glance describes the tree and its chips.
• Organise the menu covers your own entries.