Scene

Defined in: Scene.ts:26

Scenes own entities and define lifecycle hooks. Each scene is a self-contained world with its own entity pool.

Constructors

Constructor

new Scene(): Scene

Returns

Scene

Properties

name

abstract readonly name: string

Defined in: Scene.ts:28

Name for debugging/inspection.

---

pauseBelow

readonly pauseBelow: boolean = true

Defined in: Scene.ts:31

Whether scenes below this one in the stack should be paused. Default: true.

---

paused

paused: boolean = false

Defined in: Scene.ts:40

Manual pause flag. Set by game code to pause this scene regardless of stack position.

---

preload?

readonly optional preload?: readonly AssetHandle<unknown>[]

Defined in: Scene.ts:37

Asset handles to load before onEnter(). Override in subclasses.

---

timeScale

timeScale: number = 1

Defined in: Scene.ts:43

Time scale multiplier for this scene. 1.0 = normal, 0.5 = half speed. Default: 1.

---

transparentBelow

readonly transparentBelow: boolean = false

Defined in: Scene.ts:34

Whether scenes below this one should still render. Default: false.

Accessors

assets

Get Signature

get assets(): AssetManager

Defined in: Scene.ts:76

Convenience accessor for the AssetManager.

Returns

AssetManager

---

context

Get Signature

get context(): EngineContext

Defined in: Scene.ts:57

Access the EngineContext.

Returns

EngineContext

---

isPaused

Get Signature

get isPaused(): boolean

Defined in: Scene.ts:62

Whether this scene is effectively paused (manual pause or paused by stack).

Returns

boolean

Methods

_addExistingEntity()

_addExistingEntity(entity): void

Defined in: Scene.ts:155

Internal

Add an existing entity to this scene (used by Entity.addChild for auto-scene-membership).

Parameters

entity

Entity

Returns

void

---

_destroyAllEntities()

_destroyAllEntities(): void

Defined in: Scene.ts:318

Internal

Destroy all entities — used during scene exit.

Returns

void

---

_flushDestroyQueue()

_flushDestroyQueue(): void

Defined in: Scene.ts:304

Internal

Flush the destroy queue — destroy pending entities. Called by the engine during the endOfFrame phase.

Returns

void

---

_onEntityEvent()

_onEntityEvent(eventName, data, entity): void

Defined in: Scene.ts:237

Internal

Called by Entity.emit() for bubbling entity events to the scene.

Parameters

eventName

string

data

unknown

entity

Entity

Returns

void

---

_queueDestroy()

_queueDestroy(entity): void

Defined in: Scene.ts:175

Internal

Add an entity to the destroy queue. Called by Entity.destroy().

Parameters

entity

Entity

Returns

void

---

_setContext()

_setContext(context): void

Defined in: Scene.ts:275

Internal

Set the engine context. Called by SceneManager when the scene is pushed.

Parameters

context

EngineContext

Returns

void

---

afterRestore()?

optional afterRestore(data, resolve): void

Defined in: Scene.ts:267

Called after entities are restored during save/load. Rebuild non-serializable state here.

Parameters

data

unknown

resolve

SnapshotResolver

Returns

void

---

destroyEntity()

destroyEntity(entity): void

Defined in: Scene.ts:167

Mark an entity for destruction. Deferred to endOfFrame flush.

Parameters

entity

Entity

Returns

void

---

findEntities()

Call Signature

findEntities<T>(filter): Entity & T[]

Defined in: Scene.ts:202

Find entities matching a filter. Trait filter narrows the return type.

Type Parameters

T

T

Parameters

filter

EntityFilter & object

Returns

Entity & T[]

Call Signature

findEntities(filter?): Entity[]

Defined in: Scene.ts:203

Find entities matching a filter. Trait filter narrows the return type.

Parameters

filter?

EntityFilter

Returns

Entity[]

---

findEntitiesByTag()

findEntitiesByTag(tag): Entity[]

Defined in: Scene.ts:193

Find entities by tag.

Parameters

tag

string

Returns

Entity[]

---

findEntity()

findEntity(name): Entity | undefined

Defined in: Scene.ts:185

Find entity by name (first match).

Parameters

name

string

Returns

Entity | undefined

---

getEntities()

getEntities(): ReadonlySet<Entity>

Defined in: Scene.ts:180

Get all active entities.

Returns

ReadonlySet<Entity>

---

on()

on<T>(token, handler): () => void

Defined in: Scene.ts:216

Subscribe to bubbled entity events at the scene level. Handler receives (data, emittingEntity).

Type Parameters

T

T

Parameters

token

EventToken<T>

handler

(data, entity) => void

Returns

() => void

---

onEnter()?

optional onEnter(): void

Defined in: Scene.ts:252

Called when the scene is entered (after preload completes).

Returns

void

---

onExit()?

optional onExit(): void

Defined in: Scene.ts:255

Called when the scene is exited (popped or replaced).

Returns

void

---

onPause()?

optional onPause(): void

Defined in: Scene.ts:258

Called when a scene is pushed on top of this one.

Returns

void

---

onProgress()?

optional onProgress(ratio): void

Defined in: Scene.ts:249

Called during asset preloading with progress ratio (0→1).

Parameters

ratio

number

Returns

void

---

onResume()?

optional onResume(): void

Defined in: Scene.ts:261

Called when the scene above is popped, restoring this scene.

Returns

void

---

serialize()?

optional serialize(): unknown

Defined in: Scene.ts:264

Return a JSON-serializable snapshot of this scene’s custom state. Used by the save system.

Returns

unknown

---

service()

protected service<T>(key): T

Defined in: Scene.ts:87

Lazy proxy-based service resolution. Can be used at field-declaration time:

readonly layers = this.service(RenderLayerManagerKey);

The actual resolution is deferred until first property access.

Type Parameters

T

T extends object

Parameters

key

ServiceKey<T>

Returns

T

---

spawn()

Call Signature

spawn(name?): Entity

Defined in: Scene.ts:106

Spawn a new entity in this scene.

Parameters

name?

string

Returns

Entity

Call Signature

spawn<P>(blueprint, params): Entity

Defined in: Scene.ts:107

Spawn a new entity in this scene.

Type Parameters

P

P

Parameters

blueprint

Blueprint<P>

params

P

Returns

Entity

Call Signature

spawn(blueprint): Entity

Defined in: Scene.ts:108

Spawn a new entity in this scene.

Parameters

blueprint

Blueprint<void>

Returns

Entity

Call Signature

spawn<E, P>(Class, params): E

Defined in: Scene.ts:110

Spawn an entity subclass with setup params.

Type Parameters

E

E extends Entity

P

P

Parameters

Class

() => E & object

params

P

Returns

E

Call Signature

spawn<E>(Class): E

Defined in: Scene.ts:115

Spawn an entity subclass without setup params.

Type Parameters

E

E extends Entity

Parameters

Class

() => E

Returns

E