sc_relocation_v1.request

Catalogue snapshot — development preview

SDK 2.3.0 · game pack 0.6.0 · source e616ed69d8f9f77b0f4827881c86d91e4a7d1689 Published release: sdk-v2.3.0 (immutable approved assets; this development preview is not an approved release). Source-backed inventory is not a runtime or in-game verification claim.

Admit a copied finite bounded position and normalized quaternion for a streamed nonzero target zone. Request size at least 72, timeout 1..60000ms. Requires known equal nonzero systems, host-certified offline/session/player and validated transport. Unknown safety or system refuses. One global pending request. Output ticket unchanged on refusal; admission is not completion.

Limitations / unestablished guarantees

• Production relocation unavailable until grounded host safety/session admission, certified system classification and validated transport exist.
• Synthetic shared-logic and fake-provider fixtures only; Windows/MSVC, game provider and gameplay not verified.

Signature

sco_result (*)(sco_plugin *, const sc_relocation_request *, uint64_t *)

Service and availability

Service index

Property	Value
Symbol	sc_relocation_v1.request
Record ID	sc-relocation-v1-request
Service	game.relocation
Table	sc_relocation_v1
Version macro	SC_RELOCATION_VERSION
Packed table version	65536
Since / availability	size >= 16; 1.0
Complete member extent (x64 bytes)	16
Table size (x64 bytes)	32

Header source

Parameters and buffers

sco_result (*request)(sco_plugin* self, const sc_relocation_request* request, uint64_t* out_ticket);
Admit a copied finite bounded position and normalized quaternion for a streamed nonzero target zone. Request size at least 72, timeout 1..60000ms. Requires known equal nonzero systems, host-certified offline/session/player and validated transport. Unknown safety or system refuses. One global pending request. Output ticket unchanged on refusal; admission is not completion.

Results and failures

SCO_OK success; SCO_BAD_ARG invalid input/self; SCO_UNAVAILABLE missing safety/player/transport or unknown/different systems; SCO_TOO_MANY pending global request or ticket exhaustion; SCO_NOT_FOUND foreign/unknown/evicted ticket. Outputs unchanged on failure.

Absent capability

Missing service: query_service NOT_FOUND. Production table is present but game.relocation capability false; valid request returns SCO_UNAVAILABLE.

Ownership

Local player only; owner-scoped opaque tickets. No arbitrary entity/pointer/owner writes. Copied request and caller-owned output. 32 retained terminal tickets; oldest terminal evicted at admission.

Thread affinity

Game thread only; wrong thread returns SCO_WRONG_THREAD without touching state.

Callback context

No callbacks; bounded tick-driven work.

Reentrancy

Non-reentrant.

Cleanup and cancellation

Owner unload cancels/forgets tickets; stop forgets all; ticket sequence never recycled. Session/player/system change, safety/transport loss or fault fails pending. Stream loss waits up to timeout. Completion requires fresh pose within 0.05m and quaternion absolute normalized dot at least 0.999999. Cancellation is not undo.

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_relocation.h (*request)
cpp	direct	include/sc_relocation.h (*request)
csharp	unsupported	include/sc_relocation.h C# and Lua unsupported
lua	unsupported	include/sc_relocation.h C# and Lua unsupported

Examples

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

Tests

• tests/abi_relocation.c
• tests/test_relocation.cpp

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