Skip to content

ludus::gameplay::world

Ludus Wiki · API overview · Browse API

Namespace

Declared in modules/gameplay/world/include/ludus/gameplay/world/binding_table.h

Enumerations

ResolveStatus

enum class ResolveStatus : foundation::uint8
Outcome of resolving a durable key through a WorldBindingTable.
TryResolve() performs no I/O and no implicit loading; it reports how the key relates to the bindings this table currently holds and, for Resolved, to the live incarnation in the owning registry. See the "Resolution and streaming" section of docs/architecture/object-handles-uuid.md.

Related types: foundation::uint8

Resolved

Resolved
A matching binding exists and its runtime incarnation is still live. Check activity and any required capability before use.

NotResident

NotResident
An authoritative catalog/save index knows the key, but its instance is not loaded (no binding is resident). The caller may explicitly request streaming.

Missing

Missing
No binding and no authoritative record for the key in the available scope. Report it; this is not proof of permanent deletion.

TypeMismatch

TypeMismatch
A binding exists but the required asset kind or gameplay capability does not match.

InvalidReference

InvalidReference
The key is malformed, names an unknown scope, or is a duplicate identity. A required binding with this status is rejected.

Conflict

Conflict
Two live bindings claim the same durable key; the table rejects the conflict.

Declared in modules/gameplay/world/include/ludus/gameplay/world/binding_table.h

Status

enum class Status : foundation::uint8

Related types: foundation::uint8

Success

Success

InvalidEntity

InvalidEntity

DuplicateComponent

DuplicateComponent

MissingComponent

MissingComponent

InvalidPhase

InvalidPhase

InvalidConfiguration

InvalidConfiguration

CapacityExceeded

CapacityExceeded

AllocationFailure

AllocationFailure

IdentityExhausted

IdentityExhausted

Declared in modules/gameplay/world/include/ludus/gameplay/world/entity_id.h

Functions

GetResolveStatusName

const char * ludus::gameplay::world::GetResolveStatusName(ResolveStatus status) noexcept
Return a stable, human-readable name for status (for diagnostics and logs). The returned pointer is a static string literal and is never null.

Related types: ResolveStatus

Declared in modules/gameplay/world/include/ludus/gameplay/world/binding_table.h