sc_loadout_v1_2.submit

Catalogue snapshot — development preview

SDK 2.4.0 · game pack 0.8.0 · source d16f013c629797275e40124184b261da54cce0ef Published release: sdk-v2.4.0-rc.1 (release candidate 1, attested assets; the final signed release follows; this development preview is not an approved release). Source-backed inventory is not a runtime or in-game verification claim.

Validate and copy 1..16 unique logical slots and bounded class names into one owner-scoped asynchronous job. Eight jobs total, one per plugin. Admission is not equip completion.

Limitations / unestablished guarantees

• Opt-in native adapter is static/synthetic checked, not run in game. Visor unsupported.
• Existing synchronous 1.0/1.1 methods retain their contract and remain unavailable without a synchronous backend.

Signature

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

Service and availability

Service index

Property	Value
Symbol	sc_loadout_v1_2.submit
Record ID	sc-loadout-v1-2-submit
Service	game.loadout
Table	sc_loadout_v1_2
Version macro	SC_LOADOUT_VERSION_1_2
Packed table version	65538
Since / availability	size >= 24; 1.2
Complete member extent (x64 bytes)	24
Table size (x64 bytes)	40

Header source

Parameters and buffers

sco_result (*submit)(sco_plugin* self, const sc_loadout_request* request, uint64_t* out_job);
Validate and copy 1..16 unique logical slots and bounded class names into one owner-scoped asynchronous job. Eight jobs total, one per plugin. Admission is not equip completion.

Results and failures

OK on accepted submit, observed status or cancellation; BAD_ARG for malformed extent/input/self, TOO_MANY for retained-job capacity, NOT_FOUND for foreign or unknown id, UNAVAILABLE for missing verified provider or admission, FAILED for terminal backend fault.

Absent capability

Query absent returns NOT_FOUND. Missing game.loadout.async refuses submit; table publication is not permission to mutate.

Ownership

Caller-owned full records; copied typed requests, owner-scoped process-unique job ids. One retained job per plugin, eight total. Local player only; no account inventory or XML.

Thread affinity

Game thread only; non-reentrant. No plugin callbacks.

Callback context

Tick-driven native work; no retained caller pointers or plugin callbacks.

Reentrancy

Recursive mutation and backend Start/Stop refused while a callback owns the provider.

Cleanup and cancellation

Owner unload and stop cancel jobs. Session/admission loss or 120000ms timeout fails pending work. No retry or rollback. Fault disables mutation until process restart and retains uncertain native resources.

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_loadout.h (*submit)
cpp	typed-wrapper	include/scosdk/game/loadout.hpp return async->submit(self_, &request, &job);
csharp	unsupported	docs/game/loadout.md C# is unsupported for loadout 1.0
lua	unsupported	docs/game/loadout.md Lua mutation is unsupported

Examples

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

Tests

• tests/abi_game_loadout.c
• tests/game_contracts/loadout/consumer.c
• tests/game_contracts/loadout/routes.cpp
• tests/game_contracts/loadout/test_loadout.cpp
• tests/game_contracts/loadout/native.cpp
• tests/game_contracts/loadout/test_metadata.py

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