Skip to content

SpawnGameboardActorOptions

Defined in: src/actors/actors.ts:106

Options for spawning a placement and registering it as an actor in one call.

actorId: string

Defined in: src/actors/actors.ts:60

Stable gameplay actor id.

GameboardActorRegistrationOptions.actorId


optional actorKind?: GameboardActorKind

Defined in: src/actors/actors.ts:62

Gameplay actor kind. Defaults from placement kind.

GameboardActorRegistrationOptions.actorKind


optional actorMetadata?: Readonly<Record<string, GameboardActorMetadataValue>>

Defined in: src/actors/actors.ts:76

Serializable actor metadata independent from placement metadata.

GameboardActorRegistrationOptions.actorMetadata


assetId: string

Defined in: src/koota/koota.ts:303

Manifest or external registry asset id to render.

SpawnGameboardPlacementOptions.assetId


at: string | HexCoordinates

Defined in: src/koota/koota.ts:301

Origin tile or tile key where the placement should spawn.

SpawnGameboardPlacementOptions.at


optional blocksMovement?: boolean

Defined in: src/actors/actors.ts:70

Whether this actor blocks actor movement.

GameboardActorRegistrationOptions.blocksMovement


optional elevationOffset?: number

Defined in: src/koota/koota.ts:311

Extra vertical offset above the tile elevation.

SpawnGameboardPlacementOptions.elevationOffset


optional faction?: string | null

Defined in: src/actors/actors.ts:64

Optional faction identifier.

GameboardActorRegistrationOptions.faction


optional hostile?: boolean

Defined in: src/actors/actors.ts:68

Whether this actor is generally hostile.

GameboardActorRegistrationOptions.hostile


optional id?: string

Defined in: src/koota/koota.ts:299

Explicit placement id. Defaults to a deterministic runtime id.

SpawnGameboardPlacementOptions.id


optional interactive?: boolean

Defined in: src/actors/actors.ts:72

Whether this actor should be considered an interaction target.

GameboardActorRegistrationOptions.interactive


kind: GameboardPlacementKind

Defined in: src/koota/koota.ts:305

Gameplay category for rules, selectors, and rendering.

SpawnGameboardPlacementOptions.kind


optional layer?: GameboardPlacementLayer

Defined in: src/koota/koota.ts:307

Render and occupancy layer. Defaults from kind.

SpawnGameboardPlacementOptions.layer


optional metadata?: Readonly<Record<string, string | number | boolean | null>>

Defined in: src/koota/koota.ts:325

Serializable placement metadata for rules, ECS interop, and render hints.

SpawnGameboardPlacementOptions.metadata


optional occupancyGuard?: GameboardPlacementOccupancyGuard

Defined in: src/koota/koota.ts:327

Optional occupancy validation before spawning.

SpawnGameboardPlacementOptions.occupancyGuard


optional order?: number

Defined in: src/koota/koota.ts:319

Stable sort order used by renderers and snapshots.

SpawnGameboardPlacementOptions.order


optional positionOffset?: GameboardPlacementPositionOffset

Defined in: src/koota/koota.ts:313

Local world-space offset after tile/elevation anchoring.

SpawnGameboardPlacementOptions.positionOffset


optional requiresExtra?: boolean

Defined in: src/koota/koota.ts:323

Whether the placement depends on local-only EXTRA assets.

SpawnGameboardPlacementOptions.requiresExtra


optional rotationSteps?: number

Defined in: src/koota/koota.ts:315

Clockwise 60-degree rotation steps.

SpawnGameboardPlacementOptions.rotationSteps


optional scale?: number

Defined in: src/koota/koota.ts:317

Uniform render scale.

SpawnGameboardPlacementOptions.scale


optional stackIndex?: number

Defined in: src/koota/koota.ts:321

Optional stack index for layered terrain and vertical props.

SpawnGameboardPlacementOptions.stackIndex


optional tags?: readonly string[]

Defined in: src/actors/actors.ts:74

Free-form actor tags used by selectors and quests.

GameboardActorRegistrationOptions.tags


optional team?: string | null

Defined in: src/actors/actors.ts:66

Optional team identifier. Defaults to faction when omitted.

GameboardActorRegistrationOptions.team


optional textureSet?: "default" | "fall" | "summer" | "winter"

Defined in: src/koota/koota.ts:309

Texture set override. Defaults to the origin tile texture set.

SpawnGameboardPlacementOptions.textureSet