Get started

Your first configurator

From a studio scene with a mesh in it to a working configurator with two finishes, a camera and a working UI. About fifteen minutes.

This walkthrough uses one mesh and one material zone. Every later feature builds on these same steps. You need a level with your product mesh in it and two material instances, for example MI_Red and MI_Silver.

Save a copy first Work on a copy of your studio map. Every BAKR editor action supports Undo, but a copy keeps the original safe while you learn the steps.

1. Test the plugin with the placeholder setup

Before you build anything, check that BAKR runs in your project.

  1. Open World Settings and set GameMode Override to BAKRGameMode.
  2. Press Play.

The level has no configurator in it yet, so the game mode spawns a placeholder test configurator setup with a product, material and variant switching and animations to play. Pick a few swatches, orbit with left-drag and zoom with the scroll wheel. If all of that works, the controller, camera pawn, UI and material system are running.

The BAKR placeholder setup in Play: two stacked boxes, a Materials panel with swatches for Bottom Object and Top Object plus Styles, a Reset button and Overview, Side and Detail camera buttons
The placeholder setup in Play. If you can change swatches and switch cameras, the plugin works.

Stop Play and continue. Once you place your own BAKR Configurator in the next step, this placeholder no longer appears.

No placeholder on Play? Check that the game mode is set on this level and that the plugin is enabled. See Troubleshooting.

2. Place the configurator

  1. Open Place Actors, search for BAKR Configurator and drag it into the level. Where you put it does not matter. It is a data holder, and moving it does not move your meshes.

    Place Actors search for bakr, listing BAKR Configurator, BAKR Camera Pawn, BAKR Demo Product and BAKRPOI
    Search Place Actors for BAKR, then drag BAKR Configurator into the level.
  2. With it selected, open 01 - Product (required) in the Details panel.

  3. Set Product ID, for example Lamp. Presets, the product switcher and web commands use this ID, so keep it stable.

  4. Set Product display name, for example Studio Lamp. Visitors see this name.

    BAKR | 01 - Product (required) in the BAKR Configurator Details panel, showing Product display name, Product Id, Switcher Sort Order, Show in Switcher, Product Scene Actors and the preview buttons
    Step 01 on the configurator, with the product's display name and ID filled in.

The Details steps are numbered in the order you complete them. Steps marked (required) must be done before Play; (optional) steps add features.

3. Connect the mesh

  1. Select the configurator and your mesh actor together.

  2. Right-click → BAKR → Connect selected meshes to configurator.

    Actor right-click menu with the BAKR section and Connect selected meshes to configurator highlighted
    The BAKR section of the actor right-click menu, with the configurator and a mesh selected.

This adds a BAKR Material Binding component to the mesh. It never moves, duplicates or re-parents the mesh, it skips meshes that already have a binding, and it supports Undo. You can also add BAKR Material Binding by hand through Add Component.

4. Add a material zone

  1. On the configurator, open 02 - Zones and options (required).

  2. Under Material zones, click Add material zone.

  3. Set the zone's Id to Shade and Display Name to Shade. Use readable IDs, since rows are labeled by ID.

  4. Under Material Options, add two entries. For each, choose BAKR Material Option and fill in:

    • Id: Red, Display Name: Signal Red, Material: MI_Red, Swatch: a red color.
    • Id: Silver, Display Name: Silver, Material: MI_Silver, Swatch: a light gray.
  5. Set Default Option to Silver. This is the option the product loads with and the one Reset returns to.

    BAKR | 02 - Zones and options (required) with a BodyPaint material zone holding two BAKR Material Options, Red and Silver, each with Id, Display Name, Swatch and Material set, and Default Option set to Silver
    A material zone with two options and its default set.

Swatch only colors the button in the UI. The shader comes from Material.

5. Choose which slots the zone paints

  1. Select the mesh and find its BAKR Material Binding component.

  2. Under Zones, add an entry and pick Shade from the Zone Id dropdown.

  3. Tick the material slots the zone should paint. You can also tick All Slots instead.

    Details panel of a mesh with the BAKRMaterialBinding component selected, a zone entry set to BodyPaint and only the CarPaint material slot ticked
    The binding on a mesh: the zone picked from the dropdown, with only the slot it should paint ticked.

An empty slot list is an error, not "all slots". This is deliberate: a binding should never paint a slot you did not choose.

6. Show the default in the viewport

Open 03 - Scene meshes and defaults (required) and click Show default options in the viewport. The level now shows each zone's default option, so what you see in the editor is what Play opens with. The report lists every connected mesh and what it set. Save the level.

The Connected meshes buttons in the same step select and frame each mesh, which helps when a binding needs correcting.

BAKR | 03 - Scene meshes and defaults (required) with the Show default options in the viewport button and a grid of connected mesh buttons, each listing the zones it paints
Step 03: show the defaults, and jump to any connected mesh.

7. Add a camera

  1. Frame the product in the perspective viewport the way the visitor should first see it.

  2. Open 04 - Cameras (required), type a camera name and click Add camera from current view.

    BAKR | 04 - Cameras (required) with Start camera, Global camera and UI settings, the camera name field, Add camera from current view, Adopt an existing camera and the list of cameras
    Step 04: name the view, add it, and pick the start camera.

The new BAKRPOI camera gets a 40 mm lens and an orbit pivot placed where the center of your view hits the product. The first camera becomes the Start camera. See Add cameras for orbit limits, lens and more views.

8. Validate and play

If you set BAKRGameMode in step 1, the game mode is already in place. Clicking the button below again does no harm.

  1. Open 06 - Validate and play (required) and click Use configurator game mode in this level. This sets the level's game mode to BAKRGameMode, which brings the controller, the camera pawn and the UI.

  2. Click Validate setup and all mesh slots.

  3. Fix anything listed as an error. Warnings, such as a material parameter the material does not have, never stop the product from working.

    BAKR | 06 - Validate and play (required) after validation, reporting that setup and mesh slots are valid, with the product ID, zone, mesh and camera counts and the game mode
    A clean validation: the setup is ready for Play.
  4. Save the level and press Play.

Pick Signal Red, orbit with left-drag outside the panel, zoom with the scroll wheel, hide and show the panel, then open the summary and press Reset.

9. Make the UI your own (optional)

Open 05 - UI, styles and motion (optional) and click Create / open editable UI. BAKR generates Widget Blueprints in Content/BAKRUI and opens the HUD. Restyle it in the Designer; everything is already wired. See Customize the UI.

BAKR | 05 - UI, styles and motion (optional) showing Styles, Sequences, Turnaround Time, UI Widget Class and UI tab names
Step 05 holds the UI widget class, styles and sequences.

Where to go next