Exclusive groups

1. The group chip on the Jacket's row: the group's name and the Jacket's number in it. The dot after it marks the toggle that is on by default.
2. Exclusive group of the selected Hoodie.
3. The arrow button that lists the groups this toggle can join.
4. Default on.
5. The note Group saved and synced, in place of Saved and Synced.
6. The note in place of Blend time.

When to use it

Use an exclusive group when only one of several choices may be on: one outfit, one hairstyle, one pose of the ears. Turning one choice on turns the one that was on off. Pressing the choice that is on turns it off, and then no choice is on.

A group is not an item of its own. It is a name that toggles of one AvatarDoc component share, and it belongs to that component. To build a whole outfit menu with its submenu and group in one window, use + Outfit set.

Groups of several components

An avatar can have several AvatarDoc components: its own, and one in each prefab you add, such as a prefab maker's outfit with its own menu. Each component's groups are its own. When the avatar's own component and a prefab both have a group called Outfits, they are two groups: turning on the prefab's Kimono does not turn off the avatar's Jacket. Each group has its own parameter, named after its own component's parameter prefix, such as AD/Outfits and Mayo/Outfits.

To put a toggle into another component's group, pick that group in the toggle's Exclusive group list, where it shows with its component in brackets, such as Outfits (Mayo menu). The toggle then joins that group: one of the two turns the other off, and the group's parameter, its saved and synced settings and its numbering come from the component the group belongs to. A note under the field names that component. The link is stored on the toggle, so it works on a prefab you placed in the scene, and Copy to another avatar points it at the same component on the other version. Typing a name instead makes a group of the toggle's own component again.

1. The list of the Exclusive group field.

1. Exclusive group.
2. The note that names the component the group belongs to.

Up to version 0.6.0, groups of the same name were one group across all the components of an avatar. When two components have a group of the same name and no toggle links them, a note under every toggle of both groups names both components and the group. Keeping them apart is a correct setup, such as a shop's outfits beside your own, so it is a note, and the avatar stays ready to upload. Its button Join them makes them one group, in one Undo step: the toggles of the second component the note names join the group of the first, and the button's tooltip says which. Usually the first is the component on the avatar's root, or else the first one in the Hierarchy, so the avatar's own group keeps its name. When the other component is locked, as a shop's prefab often is, the avatar's toggles move into the prefab's group instead. The button is greyed out only while both components are locked.

1. Exclusive group.
2. The note that names both components and the group.
3. Join them.

Joining the toggles of a component into another component's group, with the button or with the list, gives that group's component the say: the group's parameter takes its prefix and its saved and synced settings, so the choice those toggles had saved starts from its default once. If that component is later removed or switched off, the toggles fall back to a group of their own component.

The automatic numbers go to the group's own component's toggles first, in the order of the menu, then to the toggles that joined from other components. So joining never changes the numbers of the toggles that were in the group, and a saved choice keeps picking the same outfit.

A group of the same name that was one group up to version 0.6.0 now takes the prefix of its own component. When its first toggle in the menu sat on another component with another prefix, the group's parameter name changes once, and the saved choice starts from its default.

Settings

A group has no panel. Its settings live on its toggles.

Exclusive group

Shown in: Advanced, and Simple while the toggle is in a group · Default: empty, no group · Choices: any name, or None and the groups in the arrow button's list

The toggle joins the group of this name of its own component. Toggles of the same component, in any submenu, join the same group when they use the same name. Spaces at the start and the end do not count, but capital letters do: Outfits and outfits are two groups.

The arrow button at the right end lists None, which takes the toggle out of its group, then this component's groups, then the groups of the other AvatarDoc components on the avatar, each with its component in brackets. Picking a group from the list avoids a typing mistake, and picking another component's group joins it, as Groups of several components explains.

In Simple mode, the field shows only on a toggle that is already in a group, so join a group in Advanced mode or with + Outfit set.

Default on

Shown in: Simple and Advanced · Default: Off · Choices: On, Off

The choice that is on when the avatar loads. Leave it off on every toggle of the group to start with none of them on. When more than one toggle of a group has it on, the first one wins and a warning names the group.

Group saved and synced

Shown in: Advanced, and Simple once the toggle's Advanced fold shows · Default: always saved and synced · Choices: none

Every group is saved and synced. In a member's Advanced fold, this note takes the place of the Saved and Synced switches. The choice that is on is remembered between avatar loads, and other players see it.

Value in group

Shown in: Advanced, and Simple once the toggle's Advanced fold shows · Default: 0 · Choices: a whole number from 0 up

The number the group's parameter takes while this toggle is on. 0 lets AvatarDoc pick the next free number in the order of the menu. Two toggles of one group cannot have the same number: the build refuses it with an error, and under the error sits the button Give each member its own value. The button gives every member of the group a number of its own, 1 for the first, 2 for the second and so on, in one Undo step. A locked component refuses it.

Blend time

Shown in: Advanced · Default: not used in a group · Choices: none

A group switches its choices at once. In a member's fold, the note Blend time is not used while the toggle is in an exclusive group. takes the place of the field, and a note appears if the toggle still has a blend time from before it joined.

How a group works

All the toggles of a group share one parameter. It is a whole number, an Int, named after the parameter prefix of the group's own component and the group, such as AD/Outfits. Each toggle gets its own number in the order of the menu, the toggles of the group's own component first: 1 for the first, 2 for the second, and so on. You can set a number yourself in Value in group. Leave it at 0 to let AvatarDoc pick. The group's parameter is 0 when no choice is on. The tree shows the number on each row, such as Outfits 1, when the tree is at least 360 pixels wide.

The group costs 8 synced bits, however many toggles it has. Eight separate toggles cost 8 bits too, so a group saves memory once it holds more than eight toggles.

A toggle in a group with no targets of its own is a choice too, such as a No outfit choice that turns the others off. It shows no warning.

A member always uses the group's parameter. Its Parameter row shows the group's parameter, with the note Members use the group's parameter. in place of the Custom name switch. A custom name that a toggle had before it joined the group stays in the component, but the build ignores it and the panel does not show it.

What AvatarDoc builds

At upload, each toggle of the group adds its own button to the menu, and the group adds one Int parameter and one layer to the avatar's FX animator, named AD: and the group's name. The layer has a state for each choice and one for no choice. Moving from one choice to another goes straight from one state to the other.

Messages

• More than one toggle of the group is on by default.
• The default choice is not built on this platform.
• Two toggles of the group ask for the same number.
• Two components have a group of the same name.
• The blend time is not used in a group.

Related

• Make one-of-many choices
• Your first outfit selector
• Ship a prefab with an AvatarDoc menu
• Toggle describes every other setting of a group's toggles.