Quick starts

Group finishes into categories

Split a long list of finishes into named ranges, such as Car paint and Special, and reuse the same range on many zones.

A BAKR Material Category is a reusable Data Asset that holds a named group of material options. In Play the zone shows a row of category buttons, and only the chosen category's swatches below them.

Quick start

  1. In the Content Browser, choose Add → Miscellaneous → Data Asset → BAKR Material Category.

    Data Asset class picker filtered to BAKR Material Category, with the class selected
    BAKR Material Category creates a reusable collection of finishes.
  2. Open it and set Id (for example paint), Display Name (Car paint).

  3. Add the finishes under Options, in picker order.

    Body Paint category asset with its ID, display name and nine material options, including an expanded Dark Grey option with swatch and material
    The category holds its own name and ordered finish options, ready to reuse on several zones.
  4. On the configurator, in 02 - Zones and options, open a material zone and add the asset to Material categories.

    Material categories list on a material zone with DA_BodyPaint and DA_BodySpecial assigned, followed by the Ungrouped category label field
    Assign several category assets to offer separate finish ranges within the same zone.
  5. Repeat for more categories, such as special for carbon and chrome. Press Play.

Convert an existing zone

At the bottom of Material zones, Move zone options into a shared category asset lifts each flat zone's own options into a new asset in /Game/BAKRCategories and assigns it back. It lists the zones it will change and asks first. Zones that already use categories are skipped.

Bottom of the material zones list with the Move zone options into a shared category asset button
Convert existing zone options into shared assets when a finish range needs to be reused.

Three rules

A category is shared Editing the asset changes every zone and every product that uses it. Keep product-specific finishes in the zone's own options.

  • Option IDs must be unique across all categories of one zone. A preset stores one option ID per zone, so two categories that both contain Black would be ambiguous. Validation names both categories and refuses it. Prefix IDs per category, such as paint.black and special.carbon.
  • The zone's own options form an extra group. Options left on the zone itself appear first, labeled Standard. Change that name with Ungrouped category label.
  • Choosing a category changes nothing. It only filters the panel. The product changes when an option is chosen, and the open category is worked out from the selected option, so presets and styles are unaffected.

Older generated UIs

A Widget Blueprint generated before categories existed has no picker and shows every option unfiltered. Regenerate it with Create / open editable UI, or add a Wrap Box named exactly SectionCategories inside the section body of WBP_BAKRSection.

On the web and kiosk

The catalog sends a categories array per zone. The kiosk page shows categories as sections; see Web API.