Skip to content

TilemapComponent

Defined in: tilemap/src/TilemapComponent.ts:34

Component that renders a Tiled map using @pixi/tilemap.

  • Component

new TilemapComponent(options): TilemapComponent

Defined in: tilemap/src/TilemapComponent.ts:42

TilemapComponentOptions

TilemapComponent

Component.constructor

readonly container: Container

Defined in: tilemap/src/TilemapComponent.ts:35


readonly data: TilemapData

Defined in: tilemap/src/TilemapComponent.ts:36


enabled: boolean

Defined in: core/dist/index.d.ts:542

Whether this component is active. Disabled components are skipped by ComponentUpdateSystem.

Component.enabled


entity: Entity

Defined in: core/dist/index.d.ts:540

Back-reference to the owning entity. Set by the engine when the component is added to an entity. Do not set manually.

Component.entity

get context(): EngineContext

Defined in: core/dist/index.d.ts:554

Access the EngineContext from the entity’s scene. Throws if the entity is not in a scene.

EngineContext

Component.context


get heightPx(): number

Defined in: tilemap/src/TilemapComponent.ts:111

Map height in pixels.

number


get scene(): Scene

Defined in: core/dist/index.d.ts:549

Access the entity’s scene. Throws if the entity is not in a scene. Prefer this over this.entity.scene! in component methods.

Scene

Component.scene


get tileHeight(): number

Defined in: tilemap/src/TilemapComponent.ts:121

Tile height in pixels.

number


get tileWidth(): number

Defined in: tilemap/src/TilemapComponent.ts:116

Tile width in pixels.

number


get widthPx(): number

Defined in: tilemap/src/TilemapComponent.ts:106

Map width in pixels.

number

_runCleanups(): void

Defined in: core/dist/index.d.ts:584

Internal

Run and clear all registered cleanups. Called by Entity.remove() and Entity._performDestroy() before onRemove/onDestroy.

void

Component._runCleanups


protected addCleanup(fn): void

Defined in: core/dist/index.d.ts:578

Register a cleanup function to run when this component is removed or destroyed.

() => void

void

Component.addCleanup


optional afterRestore(data, resolve): void

Defined in: core/dist/index.d.ts:598

Called after onAdd() during save/load restoration. Apply state that depends on onAdd() having run.

unknown

SnapshotResolver

void

Component.afterRestore


optional fixedUpdate(dt): void

Defined in: core/dist/index.d.ts:594

Called every fixed timestep by the built-in ComponentUpdateSystem.

number

void

Component.fixedUpdate


getCollisionShapes(objectLayerName?): TilemapColliderConfig[]

Defined in: tilemap/src/TilemapComponent.ts:161

Extract physics-agnostic collision shapes from object layers.

string

TilemapColliderConfig[]


getObjects(objectLayerName?): Record<string, MapObject[]>

Defined in: tilemap/src/TilemapComponent.ts:166

Extract objects from object layers grouped by class/name.

string

Record<string, MapObject[]>


getTileAt(worldX, worldY, layerName?): number | null

Defined in: tilemap/src/TilemapComponent.ts:129

Returns the tile GID at a world position, accounting for entity Transform offset. Returns null if the position is outside the map or the tile is empty.

number

number

string

number | null


protected listen<T>(entity, token, handler): void

Defined in: core/dist/index.d.ts:574

Subscribe to events on any entity, auto-unsubscribe on removal.

T

Entity

EventToken<T>

(data) => void

void

Component.listen


protected listenScene<T>(token, handler): void

Defined in: core/dist/index.d.ts:576

Subscribe to scene-level bubbled events, auto-unsubscribe on removal.

T

EventToken<T>

(data, entity) => void

void

Component.listenScene


onAdd(): void

Defined in: tilemap/src/TilemapComponent.ts:66

Called when the component is added to an entity.

void

Component.onAdd


onDestroy(): void

Defined in: tilemap/src/TilemapComponent.ts:77

Called when the component is destroyed (entity destroyed or component removed).

void

Component.onDestroy


optional onRemove(): void

Defined in: core/dist/index.d.ts:588

Called when the component is removed from an entity.

void

Component.onRemove


serialize(): TilemapComponentData | null

Defined in: tilemap/src/TilemapComponent.ts:82

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

TilemapComponentData | null

Component.serialize


protected service<T>(key): T

Defined in: core/dist/index.d.ts:564

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

readonly camera = this.service(CameraKey);

The actual resolution is deferred until first property access.

T extends object

ServiceKey<T>

T

Component.service


protected sibling<C>(cls): C

Defined in: core/dist/index.d.ts:572

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

readonly anim = this.sibling(AnimatedSpriteComponent);

The actual resolution is deferred until first property access.

C extends Component

ComponentClass<C>

C

Component.sibling


optional update(dt): void

Defined in: core/dist/index.d.ts:592

Called every frame by the built-in ComponentUpdateSystem.

number

void

Component.update


protected use<T>(key): T

Defined in: core/dist/index.d.ts:556

Resolve a service by key, cached after first lookup.

T

ServiceKey<T>

T

Component.use


static fromSnapshot(data): TilemapComponent

Defined in: tilemap/src/TilemapComponent.ts:97

TilemapComponentData

TilemapComponent