punkfuncgames/bootstrapping

Bootstrapping Reference

Location: Assets/Scripts/PunkFuncGames/GameTemplate/Runtime/Bootstrapping/ (remains in template shell) Namespace: PunkFuncGames.GameTemplate.Runtime.Service.Bootstrapping

IBootstrapPhase

• int Order — execution order (lower = earlier)
• string Name — for logging
• bool IsEnabled — can disable phases
• UniTask ExecuteAsync(CancellationToken ct)

BootstrapOrder Constants

| Constant | Value | Purpose | |----------|-------|---------| | ApplicationConfig | 0 | Frame rate, VSync, cursor | | PlatformInit | 50 | Steam initialization | | ServiceInit | 100 | Asset, Audio, Save services | | LocalizationInit | 150 | Language detection + loading | | SaveData | 200 | Load save data, apply settings | | Bindings | 300 | Reactive bindings (volume, pause) | | AssetPreload | 400 | Preload addressable labels | | SceneLoad | 500 | Load initial gameplay scene | | Finalize | 1000 | Final cleanup |

Built-in Phases

ApplicationConfigPhase (Order 0) — GameSettings → target FPS, VSync, timeScale, cursor PlatformInitPhase (Order 50) — ISteamService (optional) → Steam init ServiceInitPhase (Order 100) — IAssetService, AudioService, ISaveService → sequential async init LocalizationPhase (Order 150) — ILocalizationService (optional) → language init SaveDataPhase (Order 200) — ISaveService, IVolumeService → load save, apply audio settings BindingsPhase (Order 300, IDisposable) — Reactive bindings:

• Volume changes → auto-save with 1s debounce
• Game state → auto-save if enabled
• Pause input → toggle Paused/Playing AssetPreloadPhase (Order 400) — IAssetService → preload labeled assets with progress SceneLoadPhase (Order 500) — ISceneService, IGameStateService → load MainMenu or stay in editor scene

BootstrapOrchestrator : IAsyncStartable, IDisposable

Dependencies: GameSettings, IEnumerable<IBootstrapPhase>, IGameStateService

1. Sets game state to Initializing
2. Sorts phases by Order
3. Executes each phase sequentially
4. Tracks disposable phases for cleanup

BootstrapPhaseBase (abstract helper)

• Constructor: (ILogService logService)
• Override: protected abstract UniTask OnExecuteAsync(CancellationToken ct)
• Handles logging, cancellation, and exception reporting

Registration (in ProjectLifetimeScope)

// Register phases (ILogService is auto-injected via DI)
builder.Register<ApplicationConfigPhase>(Lifetime.Singleton).As<IBootstrapPhase>();
builder.Register<PlatformInitPhase>(Lifetime.Singleton).As<IBootstrapPhase>();
builder.Register<ServiceInitPhase>(Lifetime.Singleton).As<IBootstrapPhase>();
builder.Register<LocalizationPhase>(Lifetime.Singleton).As<IBootstrapPhase>();
builder.Register<SaveDataPhase>(Lifetime.Singleton).As<IBootstrapPhase>();
builder.Register<BindingsPhase>(Lifetime.Singleton).As<IBootstrapPhase>();
builder.Register<AssetPreloadPhase>(Lifetime.Singleton)
    .WithParameter("assetLabels", Array.Empty<string>())
    .As<IBootstrapPhase>();
builder.Register<SceneLoadPhase>(Lifetime.Singleton).As<IBootstrapPhase>();

// Register orchestrator
builder.RegisterEntryPoint<BootstrapOrchestrator>().As<IAsyncStartable>();

Creating a Custom Phase

public sealed class MyCustomPhase : BootstrapPhaseBase
{
    private readonly IMyService _service;

    public override int Order => BootstrapOrder.Bindings + 10; // After bindings
    public override string Name => "MyCustomInit";

    public MyCustomPhase(ILogService logService, IMyService service) : base(logService)
    {
        _service = service;
    }

    protected override async UniTask OnExecuteAsync(CancellationToken ct)
    {
        await _service.InitializeAsync(ct);
    }
}

// Register in ProjectLifetimeScope
builder.Register<MyCustomPhase>(Lifetime.Singleton).As<IBootstrapPhase>();