Open navigation

Support

Find the common setup fixes below, or contact us with your Unity version, target platform, and the exact ReLayer Console message.

Discord support

Ask integration questions in the community and include enough project context to reproduce the issue.

Open Discord

Common setup issues

ReLayer fails closed when the toolchain, runtime backend, or output is incompatible. The Console message normally names the failing boundary.

Node.js or npm is not found

Use Node.js ^20.19.0 or ≥22.12.0; Node.js 21 and 22.0–22.11 are unsupported. Set RELAYER_NPM_PATH to an absolute npm or pnpm executable when Unity cannot inherit your shell path. Exit Play Mode, then choose Tools/ReLayer/Restart Overlay Session. If dependencies or current built output are missing, choose Tools/ReLayer/Rebuild Overlay.

The Windows overlay does not open

Install the Microsoft Edge WebView2 Runtime and confirm the target is Windows x86_64. Windows ARM64 is outside the packaged first-party runtime matrix.

The preview is blank or production output is stale

Open Tools/ReLayer/Preview Status to inspect React readiness and the startup or built-output failure. Auto and BuiltOverlay only use output that matches the active source and package inputs. Automatic checks never install dependencies or rebuild. Exit Play Mode and choose Rebuild Overlay for an asynchronous build, or Retry / Restart Preview after correcting a startup failure. Automatic startup retries are limited to three attempts, 20 seconds apart.

React controls do not receive input

Add data-relayer-hit to the interactive surface. Transparent overlay regions intentionally remain available to Unity input.

Live Twin is waiting

Enter Play Mode with one active ReLayer WebView. A twin opened in Edit Mode waits and attaches automatically. Use Tools/ReLayer/Live Twin/Stop before starting a fresh session if needed.

WebGL cannot load the overlay

Use HTTPS in production, prefer one origin, and verify CORS plus CSP permissions for the overlay document, modules, styles, assets, connections, inline nonce-bearing blocks, and blob: module URLs.