Reference

Validation and troubleshooting

What validation checks, the most common setup problems and how to fix them, and the limits of the plugin.

Run 06 - Validate and play → Validate setup and all mesh slots after every change to zones, bindings or cameras. The report appears under the button, grouped and color-coded: errors in red, warnings in amber. Warnings never stop a product from working.

BAKR validation button and successful setup report
The validation report summarizes the product setup and helps identify issues before testing.

What validation checks

  • Zones and options: empty IDs, duplicate zone IDs, a zone without options, option IDs repeated across one zone's categories.
  • Materials: every material loads, every bound slot exists on its mesh, no two zones claim one slot. Material parameter names the material does not have (warning).
  • Variants: a Scene actors option with no actors, a listed actor that is not in the level, a Streamed level option with no level, a Variant Actor component naming a missing option, connected parts that would hide with a variant actor they are attached to (warning).
  • Rules: a compatibility rule naming an unknown zone or option, or its own zone.
  • Styles: zones or options that no longer exist.
  • Cameras: missing IDs, duplicate IDs and Sort Orders, inverted limits, legacy pivots, a missing Product with several products.
  • Products: two products sharing an ID, bindings and cameras without a product, an actor claimed by two products, an intro with no camera to land on.

Common problems

SymptomCause and fix
The project does not open after updating BAKR, or a module named BAKRWebSocket or BAKRPixelStreaming is reported twiceOld Plugins/BAKRWebSocket and Plugins/BAKRPixelStreaming folders from BAKR 0.4 or earlier are still there. Kiosk and Pixel Streaming are part of BAKR now: delete both folders.
The log says "PixelStreaming2 is not loaded, so browser commands are off"Epic's Pixel Streaming 2 plugin is not enabled. BAKR does not switch it on for you: enable it in Edit → Plugins and restart.
"Choose a target; this actor has zero or multiple meshes"The actor has several mesh components. Set Target Mesh on its Material Binding.
"Choose a product; association is ambiguous or missing"The level has several configurators. Set Product on the binding or camera.
A swatch click does nothingCheck the binding has the zone with slots ticked, or All Slots. An empty slot list is an error, not "all".
Color options all look the sameThe option sets Vectors/Scalars but the parameter name does not match the material. Validation lists it as a warning. The viewport shows only the base material; check in Play.
Choosing a body also hides the wheelsThe wheels are attached to that body's actor. Move shared parts out of the variant's hierarchy.
A variant level never appears in a packaged buildIt is not a sublevel of the persistent level, so it is not cooked. Add it to the maps to cook.
Two cameras swap places in the barThey share a Sort Order. Use 04 → Fix duplicate cameras or set different values.
The camera cannot orbitThe view has Lock camera on, or Enable Mouse/Touch Orbit is off in Global Settings.
The camera flies through the product into a cabinTick Interior on the cabin view so switches fade instead.
The tablet cannot connectThe kiosk only listens with the Kiosk output and BAKRWebSocketController. Check the address in the log, that the tablet is on the same network, and the firewall allows the port.
Pixel Streaming shows the picture but clicks do nothingThe game mode is not using BAKRStreamingController, or the page sends descriptors without a command field.
No browser opens on PlayThe page is only served with Output set to Pixel Streaming and BAKRStreamingController, and opens only after the streamer connects. If a viewer was already connected, no new tab opens. Check the log for BAKR player page: and open http://127.0.0.1:8090 yourself.
The player page stays on "Connecting to stream"It is pointed at the streamer port (8888) instead of the viewer port, or no signalling server is running. Start Pixel Streaming → Stream Level Editor, or set Signalling URL for browsers to the viewer address.
Port 8090 or 80 is already in useChange the page's Port in BAKR Pixel Streaming, or give the signalling server another viewer port.
A preset from an older version is refusedVersion-1 presets are rejected. Load the configuration again and save it to update it to version 2.
A generated UI lacks a newer featureGenerated widgets are never migrated. Generate a fresh set or add the widget by name; see UI widgets.

Runtime errors

Requests that fail at runtime appear in the HUD's status line, in On Error in Blueprint, and as error responses on the web. A failed request never leaves a half-applied product: the last committed configuration stays on screen.

Limits

  • Variants show actors or stream levels. They never replace a mesh asset in place, and there is no procedural geometry.
  • Compatibility rules are pairs only. There is no rules engine, pricing, cart or stock.
  • Camera has no collision avoidance. Orbit limits are authored; there is no panning. Auto orbit is a yaw sweep.
  • Motion plays one sequence per Motion component. Add more components for independent channels.
  • Several products all stay loaded at once.
  • Kiosk is LAN-only, without pairing or credentials. There is no QR code on the big screen yet; the address is in the log.
  • Pixel Streaming hosting, TURN, TLS and per-visitor sessions are deployment concerns outside BAKR.
  • There is no multiplayer replication: one Unreal instance holds one shared state.

Get help

Questions, tips and setups from other users are on the BAKR Discord.

Stuck, or found a bug? Ask on Discord, or mail support@nilsbakker.nl with your engine version, the BAKR version from Edit → Plugins, and the lines from the Output Log that start with LogBAKR.