Part Reference Arrays
🔧 Array option for Part References has been added to support configuration of modular products, like closets and sectional furniture, where users can select multiple options, arrange them, and see them in that order in physical space.
An `Array` option has been added to the existing `Asset - Global Attribute`. When it's turned on, you can set the maximum number of value, the corresponding Asset type, and the available values (using Item names or tags).
Add the new attribute to your Catalog Item as you normally would. The configurator preview will display the new Array component where you can select from any of the available options:
You are able to add as many options as the Max. Items allows:
You are able to sort the options using drag-and-drop:
Using Catalog Item Rules, you can add validation and constraints using the Array index. For example, if the first seat (0) is `Green seat`, the second seat (1) must be `Red Seat`. The configurator will automatically set the value based on this rule:
The `Asset` setup for the item is similar to a typical setup except that you will have multiple model placeholders or nulls, enough for the array size. Position them where they should be.
The Logic setup is also similar - add the Array attribute and use the `Set Model` action targeting each model placeholder or null using the index numbers:
Product configurations can be saved and restored using the player's built-in Share functionality or the configuration API: