sc_world_control_v1.raycast_filtered

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.

Zone-local ray; direction normalized, positive finite distance clamped to 20000m. At most 32 unique nonzero current own IDs, copied for call only; foreign/relinquished ID FAILED, malformed input BAD_ARG. Adequately-sized hit zeroed on failure, unknown tail untouched; success position/distance only, entity/normal/flags zero. NULL/short hit rejected before zeroing. Capability game.world.raycast_filtered remains OFF.

Limitations / unestablished guarantees

• Synthetic provider verification only; Windows engine integration/gameplay not verified.
• Production adapter deliberately absent; mutation/read-filter capabilities OFF.
• Per-call bounds are not a native-plugin security sandbox.

Signature

sco_result (*)(sco_plugin *, uint64_t, const double *, const double *, double, const uint64_t *, uint32_t, sc_world_hit *)

Service and availability

Service index

Property	Value
Symbol	sc_world_control_v1.raycast_filtered
Record ID	sc-world-control-v1-raycast-filtered
Service	game.world.control
Table	sc_world_control_v1
Version macro	SC_WORLD_CONTROL_VERSION_1_0
Packed table version	65536
Since / availability	size >= 16; 1.0
Complete member extent (x64 bytes)	16
Table size (x64 bytes)	40

Header source

Parameters and buffers

sco_result (*raycast_filtered)(sco_plugin* self, uint64_t zone_id, const double from[3], const double dir[3], double max_dist, const uint64_t* skip_ids, uint32_t skip_count, sc_world_hit* out_hit);
Zone-local ray; direction normalized, positive finite distance clamped to 20000m. At most 32 unique nonzero current own IDs, copied for call only; foreign/relinquished ID FAILED, malformed input BAD_ARG. Adequately-sized hit zeroed on failure, unknown tail untouched; success position/distance only, entity/normal/flags zero. NULL/short hit rejected before zeroing. Capability game.world.raycast_filtered remains OFF.

Results and failures

BAD_ARG invalid owner/input; WRONG_THREAD; UNAVAILABLE absent verified adapter or restart-required; FAILED foreign owner/provider refusal; NOT_FOUND stale lease/no hit. See method-specific output contract.

Absent capability

Absent service: query_service NOT_FOUND; present disabled operation: UNAVAILABLE.

Ownership

Live owner required; call-only copied inputs, host-session borrowed table. No allocation or engine pointers cross boundary. Camera lease exclusive; no steal.

Thread affinity

Game thread only; WRONG_THREAD without provider access.

Callback context

No plugin callbacks. Host-only provider callbacks synchronous, bounded, nonthrowing.

Reentrancy

Recursive calls refused with FAILED; no waits or async work.

Cleanup and cancellation

No persisted ray filter. Ordinary owner unload/service stop restores camera before dropping lease; failure retains backing state and requires restart. Fault-retained native provider cleanup not promised.

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_world_control.h (*raycast_filtered)
cpp	typed-wrapper	include/scosdk/game/world_control.hpp t_->raycast_filtered(
csharp	unsupported	docs/design/world-control.md C# and sandboxed Lua: unsupported
lua	unsupported	docs/design/world-control.md C# and sandboxed Lua: unsupported

Examples

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

Tests

• tests/abi_world_control.c
• tests/test_world_control.cpp

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