game.relocation
Methods and entrypoints for game.relocation.
sc_relocation_v1
Section titled “sc_relocation_v1”Local-player request/cancel/status contract; game pack only. The game pack’s provider is
fail-closed: the capability game.relocation is on only while the host certifies offline
admission and the engine rows resolve, a live player and known star system exist and the
product switch is on (details). Fixtures
test the machinery and provider, not gameplay. Native C/raw C++ supported;
C# and Lua unsupported. Frozen sco_api and legacy teleport.spatial unchanged.
| Member | Since | Buffer contract | Ownership | Thread | Results | Cleanup |
|---|---|---|---|---|---|---|
sc_relocation_v1.request |
size >= 16; 1.0 |
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. |
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. | Game thread only; wrong thread returns SCO_WRONG_THREAD without touching state. | 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. | 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. |
sc_relocation_v1.cancel |
size >= 24; 1.0 |
sco_result (*cancel)(sco_plugin* self, uint64_t ticket);Owner-only idempotent cancellation of a known ticket. Does not undo movement already initiated. Foreign or evicted tickets are NOT_FOUND. Zero ticket is BAD_ARG. |
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. | Game thread only; wrong thread returns SCO_WRONG_THREAD without touching state. | 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. | 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. |
sc_relocation_v1.status |
size >= 32; 1.0 |
sco_result (*status)(sco_plugin* self, uint64_t ticket, sc_relocation_status* out);Owner-only copied status; caller size at least 24. Preserve caller size and unknown tail. Pending, complete, cancelled or failed plus bounded reason and applied flag. Status does not advance work. Foreign or evicted ticket NOT_FOUND; output unchanged on failure. |
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. | Game thread only; wrong thread returns SCO_WRONG_THREAD without touching state. | 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. | 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. |