Skip to main content

InitializeApplicationState

The InitializeApplicationState class is an entry-point state in the game flow that handles early bootstrapping for both client and server instances. It performs service initialization (Unity, Firebase, Vivox), splash UI loading, dependency injection, and transitions into the first functional menu state once all setup completes.

🧩 Overview​

public class InitializeApplicationState : GameBaseState, IInjectorReceivable

Implements the base game state flow and is injectable via dependency injection.

⚙️ Initialization Flow​

EnterState()​

Begins the initialization process:

  • For servers: runs InitializeServer() (minimal/no-op).
  • For clients: starts splash UI and InitializeClient() process.
  • Starts PrewarmUI() to asynchronously warm up the next state's UI components.

🖥 Client Setup Logic​

InitializeClient()​

Bootstraps Unity services, auth, and analytics:

  1. Starts fill animation for splash progress bar.
  2. Ensures internet connectivity.
  3. Initializes Unity Services with environment and Vivox credentials.
  4. Authenticates anonymously if not already signed in.
  5. Starts Unity Analytics collection.
  6. Starts AppsFlyer (or shows tracking consent for iOS).
  7. Initializes orchestrator and user profile via GetGameOrchestrator().
  8. Flags initialization complete and transitions to the next state.

🧪 Server Setup​

InitializeServer()​

Currently minimal; immediately transitions to next state.

🎨 Splash UI Handling​

  • splashLoadingScreen: GameObject shown during initialization.
  • splashLoadingFill: MPUIKIT image with animated fill progress.
  • fillProgressRoutine: Coroutine that updates fill amount visually.

Fill amount is incrementally updated to simulate progress:

IEnumerator FillProgress()

🔄 State Transition Logic​

ContinueToNextState()​

Checks that both initializationComplete and injectionsComplete are true, then requests the next state using:

await _manager.RequestState(NextState);

🧬 Injection & Orchestration​

InjectionCompleted()​

Called when all required dependencies are injected. Sets injectionsComplete = true, bumps splash fill, and reinvokes orchestrator initialization.

✅ Can Exit​

Only when both initialization and injection are complete:

public override bool CanExitState() => initializationComplete && injectionsComplete;

🧠 Summary​

InitializeApplicationState is the gateway into the m00m runtime. It ensures that all platform services are ready, UI is staged, and orchestration is aligned before allowing the player to progress. This design guarantees robust first-time setup across both client and server builds.