Reveal lists

When revealing aspects of a Prefab each property, method or component is revealed as part of a "reveal list".

Reveal lists can be used to customise how a locked Prefab looks to different members on the team, or even to the same person, while they are performing different tasks.

The same BlackBox Prefab can look very different depending on the list selected

For example:

• On a "Game Manager" Prefab, programmers can create a reveal list that exposes almost everything on the GameManager component, while everyone else on the team sees the Prefab as a complete black box.

• On a player Prefab, you can have a list that exposes speed and jumpHeight properties on a character controller script to tweak its movements, and one that exposes only health and attackPower for when you are working on combat.

Each BlackBox component can contain up to 10 lists of revealed items.

Switch the active list

To move between lists, simply click on the buttons that show up in the BlackBox Inspector.

Three lists are visible, and the first is currently selected

You will not see any button if there is only one visible list.

Add and remove items

Adding items to lists is done by clicking the Show Available Properties and Methods button in the Inspector of the BlackBox component, or by performing one of the actions described in the Properties, Methods or Components pages.

Removing items is simply done by clicking the - (minus) button next to a list item, while in Prefab mode.

Edit lists

In addition to the elements they contain, lists have different properties.

To edit the properties of a list (including its name), open the BlackBox Prefab and click on the Edit Lists button. This enters edit mode.

Lists edit mode

While in edit mode, you can edit:

• Name: this is the name that displays on the list buttons.

• Visible: a button will not be displayed for this list, and the list will not be selectable once out of edit mode.

• Group by GameObject: if this option is enabled, when the list is laid out it will group its elements by the GameObject they belong to.

• Reorder list elements: allows to reorder the elements of a Reveal list. Simply drag them up and down to change the order in which they will appear once you exit Edit mode.

• Emptying the list: this button clears all the revealed items in a list, without deleting the list itself.

• Delete list: removes the list entirely.

• Arrow buttons: these buttons allow to reorder the lists themselves.

Reordering, and Group by GameObject

When a list is set to group revealed items by GameObject, it might seem to you that the pure order of the elements is not respected. This is because elements are listed by GameObjects first, and then in the order specified.

So for instance, the last element in the list might not show up as last, if another element from the same GameObject is further up in the list.

To achieve exactly the order you want, you need to turn Group by GameObject off.