Quick starts

Make parts swappable

Let the visitor switch between different meshes for one part, such as wheels, a strap or a whole body, using actors in the level or streamed levels.

A variant zone offers different geometry for one part. Each option is its own set of actors, placed and lit exactly the way you want. BAKR shows the chosen option's actors and hides the rest. No mesh asset is ever replaced in place, so every option keeps its own pivot, scale and lighting.

Each option has a Source:

Scene actorsStreamed level
What it doesShows actors placed in the level and hides every other option's actorsLoads a level while the option is chosen, unloads it after
Use it forA few options where looks and alignment matterHeavy options, or ones with their own lights and many actors
MemoryEvery option's actors stay loadedOnly the chosen level is loaded
Switch speedInstantThe first switch can take a moment

One zone can mix both.

Quick start: scene actors

  1. Place each option's actors in the level at their final position, for example Wheel_Sport and Wheel_Classic, attached to a parent that moves with the product.

  2. On the configurator, open 02 - Zones and options and click Add variant zone under Variant zones. Set Id to wheels.

  3. Add a BAKR Variant Option per choice: Id sport, Display Name Sport, Source Scene actors.

    WheelTypes variant zone with the Wheels display name, Default Option and two BAKR Variant Options named Original and Premium
    A variant zone groups the alternative parts visitors can choose, such as different wheel designs.
  4. Link the actors to their option in one of two ways:

    • Add a BAKR Variant Actor component to each actor and pick Zone wheels and Option sport from the dropdowns. This link travels with the actor when you copy it.
    • Or list the actors in the option's Scene Actors.
    WheelRearRight actor with BAKRVariant selected, assigned to product BAKRActor, zone WheelTypes and option Original
    Link each actor to a zone and option so several meshes can appear together as one choice.
  5. Pick the zone's Default Option and press Play. The Variants tab lists the zone.

The option shows the actors linked by component in a read-only Linked by component line, so you can always see what belongs to it.

Original Wheels variant option with Scene actors as its source, actors listed under Linked by component and Hidden unticked
Scene-actor options keep each alternative in the level, with linked actors listed for checking the complete set.

Renaming the zone's or an option's Id later is safe: every BAKR Variant Actor in the level that names it follows the new ID, and so does the zone's Default Option.

A "none" option

Add an option with Hidden ticked, such as none with display name No roof box. Choosing it hides every option's actors and levels for that zone.

Painting variant actors

A variant actor can carry a BAKR Material Binding like any mesh. A hidden actor still receives its material, so it looks right the moment it appears.

Keep shared parts out of the hierarchy

Actors attached to a linked actor show and hide with it. If the wheels are attached to Body A, choosing Body B hides the wheels too. Keep shared parts out of the variant's attachment hierarchy. Validation warns when a connected part would hide this way.

Authoring tools

Step 01 - Product has three viewport-only buttons that are never saved:

  • Show all variants shows every option at once.
  • Show default variants goes back to the default options.
  • Isolate one variant option... shows one option of one zone.
Show all variants, Show default variants and Isolate one variant option controls
Preview all alternatives or isolate one choice while checking alignment and shared parts.

Streamed level

  1. Open the option, set Source to Streamed level.
  2. Click 02 - Zones and options → Create variant level for... and pick the option. BAKR creates /Game/BAKRVariants/<product>/<zone>/<option>, adds it to this level as a sublevel and sets it on the option.
  3. In the Levels window, make the new level current and place the variant's actors at their final world positions. Keep shared lighting in the persistent level.
  4. Save both levels.

In Play the chosen level loads while the configurator reports busy, then it appears and the previous option's level unloads. A variant level keeps its authored world positions, so it does not follow the product if the product moves.

Cooking and World Partition A World Partition level has no sublevels: create the level in the Content Browser and pick it on the option; it loads as a level instance. A level that is not a sublevel of the persistent level is not cooked automatically, so add it to the packaging list of maps.

The viewport buttons do not touch streamed levels. Use the Levels window to show or hide them while you work.

Costs to check

  • Scene-actor options all stay in memory, and hidden actors can still cost in baked lighting, shadows and Lumen.
  • Streamed levels are not preloaded yet, and the switch is not hidden behind a fade.

Whole products as variants

Whole product meshes can be options of one zone. For a change that spans several independent zones at once, such as a Sport package, use a style instead.