sc_game_spatial_v1.zone_record

Observe one nonzero streamed zone ID and its complete ancestry, then copy a size-prefixed 144-byte record. out->size must be at least sizeof(sc_game_zone); preserve size and unknown caller tail. parent_id is direct parent; root_id is the observed outermost zone, not a certified system. system_id remains 0 with SYSTEM_UNKNOWN. Full 95-byte copied names conservatively set NAME_TRUNCATED. Outputs unchanged on 0.

Signature

int (*)(uint64_t, sc_game_zone *)

Service and availability

Service index

Property	Value
Symbol	`sc_game_spatial_v1.zone_record`
Record ID	`sc-game-spatial-v1-zone-record`
Service	game.spatial
Table	sc_game_spatial_v1
Version macro	SC_GAME_SPATIAL_VERSION
Packed table version	65536
Since / availability	`size >= 24`; 1.0
Complete member extent (x64 bytes)	24
Table size (x64 bytes)	40

Header source

Parameters and buffers

int (*zone_record)(uint64_t zone_id, sc_game_zone* out);
Observe one nonzero streamed zone ID and its complete ancestry, then copy a size-prefixed 144-byte record. out->size must be at least sizeof(sc_game_zone); preserve size and unknown caller tail. parent_id is direct parent; root_id is the observed outermost zone, not a certified system. system_id remains 0 with SYSTEM_UNKNOWN. Full 95-byte copied names conservatively set NAME_TRUNCATED. Outputs unchanged on 0.

Results and failures

1 success; 0 invalid input, wrong thread, missing readiness, unreadable/unstreamed/incomplete ancestry, expired epoch, ambiguous name or quota refusal. All outputs unchanged on 0.

Absent capability

Absent table: query_service NOT_FOUND. Missing game readiness: 0.

Ownership

Caller-owned copied records/buffers; opaque session IDs and epoch tokens, never pointers. Fixed 256-record storage; bounded temporary trees may allocate. No retained caller inputs or allocation transfer.

Thread affinity

Game thread only; non-reentrant; no callbacks.

Callback context

No callbacks.

Reentrancy

Recursive calls unsupported.

Cleanup and cancellation

Synchronous read; no cancellation. Stop clears observations and expires epochs. Table lives until plugins unload; no calls after shutdown admission.

Language mappings

Status labels are copied verbatim from the catalogue: direct is native access; typed-wrapper is wrapper-backed; restricted is a subset/adaptation; unsupported means no supported route is established. No status implies universal safety.

Language	Catalogue status	Source evidence / wrapper tokens
c	direct	include/sc_game_spatial.h `(*zone_record)`
cpp	direct	include/sc_game_spatial.h `(*zone_record)`
csharp	unsupported	include/sc_game_spatial.h `C# and Lua unsupported`
lua	unsupported	include/sc_game_spatial.h `C# and Lua unsupported`

Examples

None identified in the catalogue; this is not proof none can exist.

Tests

ABI pins prove layout, not semantic behavior or a live game session.