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.
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
| Symptom | Cause and fix |
|---|---|
| The project does not open after updating BAKR, or a module named BAKRWebSocket or BAKRPixelStreaming is reported twice | Old 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 nothing | Check 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 same | The 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 wheels | The 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 build | It 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 bar | They share a Sort Order. Use 04 → Fix duplicate cameras or set different values. |
| The camera cannot orbit | The view has Lock camera on, or Enable Mouse/Touch Orbit is off in Global Settings. |
| The camera flies through the product into a cabin | Tick Interior on the cabin view so switches fade instead. |
| The tablet cannot connect | The 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 nothing | The game mode is not using BAKRStreamingController, or the page sends descriptors without a command field. |
| No browser opens on Play | The 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 use | Change the page's Port in BAKR Pixel Streaming, or give the signalling server another viewer port. |
| A preset from an older version is refused | Version-1 presets are rejected. Load the configuration again and save it to update it to version 2. |
| A generated UI lacks a newer feature | Generated 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.