Skip to Content
DevelopersError CodesCodesRuntimeRuntime initialize failed

Runtime initialize failed

Code

RUNTIME/INITIALIZE_FAILED

What it means

Entering a realm failed somewhere in the runtime initialization pipeline (auth → realm verification → route fetch → world system init).

When it happens

  • Runtime initialization fails while entering a realm.

Typical scenarios:

  • Auth session missing (NOT_AUTHENTICATED)
  • Realm verification fails (REALM_NOT_FOUND)
  • World route fetch fails (host/token missing)
  • Multiplayer/terrain connection fails

How to handle

  • Include an initialization step marker in meta (e.g. meta.status or similar) so failures can be grouped.
  • In UI, show an error overlay and provide a “Back to home” or “Retry” action.
Last updated on
Docsv1.0.10