Skip to content

Debugging the bridge

Turn on debug logging

Project Settings → Plugins → Unreal React Bridge → Debug Mode → true. The Output Log will trace every bridge event.

The React <UnrealDevPanel>

tsx
import { UnrealDevPanel } from 'unreal-react-bridge';

{import.meta.env.DEV && <UnrealDevPanel position="bottom-right" />}

A floating panel showing: bridge status, initial-state dump, in/out event log, manual bridge.send form. Gate it behind a dev flag in production.

EventMonitor (devtools API)

For programmatic logging:

tsx
import { EventMonitor } from 'unreal-react-bridge';
const mon = new EventMonitor();
mon.start();
// ... later
console.table(mon.getEvents());

Reading errors

Bind OnBridgeError(FBridgeErrorInfo) on the HUD widget. ErrorType is EBridgeErrorType:

ErrorTypeMeaning
WebBrowserNullWebBrowser widget not found (check Designer name is exactly WebBrowser).
ReactNotReadySent before lifecycle step 4 (see Lifecycle).
JSONParseErrorJsonData argument is not valid JSON.
JavaScriptErrorScript error in the loaded page; check DevTools.
EventQueueFullIncrease MaxEventQueueSize (default 100) or send less before ready.
NetworkErrorPage failed to load; check URL / dev server.

See also: React devtools reference, Types reference, Settings reference.

Released under the MIT License.