CONTENT CONTRACT · VERSION 1
ActorView
Copied actor state; contains no engine handles or live mutable data.
Signature
{ active_lights: {LightId}, alive: boolean, definition: ActorDefinitionId, health: HitPoints, home: Position, hunger: Count, max_health: PositiveHitPoints, max_hunger: Count, max_stamina: Count, position: Position, ref: ActorRef, stamina: Count, tags: {TagId} }Fields
| Name | Type | Meaning |
|---|---|---|
active_lights | {LightId} | Light definitions currently emitted by the actor. Items: 0…4096; Unique entries |
alive | boolean | Whether this instance can participate in live-actor operations. |
definition | ActorDefinitionId | Definition instantiated or represented by this runtime record. Length: 1…129; Pattern: ^[a-z][a-z0-9_]{0,31}:[a-z][a-z0-9_]{0,95}$; Reference: character|npc|enemy|animal|structure |
health | HitPoints | Current hit points; zero denotes exhausted health. Range: 0…2147483647; Unit: hp |
home | Position | Home point the actor returns to, together with its map instance. |
hunger | Count | Current hunger resource in whole units. Range: 0…2147483647; Unit: count |
max_health | PositiveHitPoints | Maximum hit points and upper healing cap. Range: 1…2147483647; Unit: hp |
max_hunger | Count | Maximum hunger resource for this character. Range: 0…2147483647; Unit: count |
max_stamina | Count | Maximum stamina resource for this character. Range: 0…2147483647; Unit: count |
position | Position | Absolute position together with its map instance. |
ref | ActorRef | Opaque host-assigned reference to this runtime instance. Length: 1…256; Pattern: ^[\s\S]+$ |
stamina | Count | Current stamina resource in whole units. Range: 0…2147483647; Unit: count |
tags | {TagId} | Unique definition tags used for filtering and classification. Items: 0…4096; Unique entries |