Skip to content

DebugConfig

Defined in: DebugPlugin.ts:36

Configuration for the DebugPlugin.

optional deterministicSeed?: number

Defined in: DebugPlugin.ts:54

If set, every scene’s RNG is initialized with this seed instead of an unspecified default. Use for deterministic E2E runs. Leave undefined for normal debug builds so randomness behaves the same as in production.


optional flags?: Record<string, boolean>

Defined in: DebugPlugin.ts:48

Initial flag overrides, keyed by “contributorName.flagName”.


optional maxGraphics?: number

Defined in: DebugPlugin.ts:42

Max pooled Graphics objects. Default: 256


optional maxHudLines?: number

Defined in: DebugPlugin.ts:44

Max HUD text lines. Default: 32


optional startEnabled?: boolean

Defined in: DebugPlugin.ts:46

Whether the overlay starts enabled. Default: false


optional startFrozen?: boolean

Defined in: DebugPlugin.ts:65

If true, the engine boots with a paused Pixi ticker so no auto-frames tick before user code can intervene — equivalent to calling inspector.time.freeze() at frame zero, but applied during plugin install() (before loop.start()). Use for deterministic E2E runs: any later engine.scenes.push(...) resolves under frozen time, so snapshots taken right after only depend on the explicit time.step() calls — not on how many auto-frames slipped in between await engine.start() and the test’s first freeze().


optional stepKey?: string

Defined in: DebugPlugin.ts:40

Key code to advance one fixed-timestep frame while the debug clock is frozen. Default: “Period”


optional toggleKey?: string

Defined in: DebugPlugin.ts:38

Key code to toggle debug overlay. Default: “Backquote”