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 actors | Streamed level | |
|---|---|---|
| What it does | Shows actors placed in the level and hides every other option's actors | Loads a level while the option is chosen, unloads it after |
| Use it for | A few options where looks and alignment matter | Heavy options, or ones with their own lights and many actors |
| Memory | Every option's actors stay loaded | Only the chosen level is loaded |
| Switch speed | Instant | The first switch can take a moment |
One zone can mix both.
Quick start: scene actors
-
Place each option's actors in the level at their final position, for example
Wheel_SportandWheel_Classic, attached to a parent that moves with the product. -
On the configurator, open 02 - Zones and options and click Add variant zone under Variant zones. Set Id to
wheels. -
Add a BAKR Variant Option per choice: Id
sport, Display Name Sport, Source Scene actors.A variant zone groups the alternative parts visitors can choose, such as different wheel designs. -
Link the actors to their option in one of two ways:
- Add a BAKR Variant Actor component to each actor and pick Zone
wheelsand Optionsportfrom the dropdowns. This link travels with the actor when you copy it. - Or list the actors in the option's Scene Actors.
Link each actor to a zone and option so several meshes can appear together as one choice. - Add a BAKR Variant Actor component to each actor and pick Zone
-
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.
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.
Streamed level
- Open the option, set Source to Streamed level.
- 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. - 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.
- 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.