Every term on this page maps to a concrete construct in the state-server codebase or to a definition in STATE_SERVER_COMPREHENSIVE_DESCRIPTION.md.
Brane — a root scene. Implemented as a Group (in internal/domain/entity/objects.go) with IsBrane: true. Has a grid-based cell system, a child-object list, visibility, and metadata. Defined in Concepts.
Object — umbrella term for any 3D entity. The ObjectBase interface in types.go. Instances are usually Blocks or Groups.
Block — a leaf 3D object with a model reference, transform, properties, and an inventory-tracked owner. The most common kind of placeable thing.
Group — a container that holds child objects and exposes a gallery_ids list of prototypes. Branes are Groups with IsBrane: true.
Prototype — a versioned template defining default properties and behaviour for objects instantiated from it. Supports public/private/deprecated states (PrototypeBase interface in types.go).
Handler — server-side JavaScript (Otto VM) attached to a prototype; runs on entity lifecycle and interaction events. The Handler interface in types.go exposes Run(ctx) and ToJS().
Interface — an interaction / connection slot. Up to 9 per object on a 3×3 grid (per STATE_SERVER_COMPREHENSIVE_DESCRIPTION.md §5).
Blockcell — individual cell in the spatial grid with ownership and interface management.
Spacecell — generic spatial container with hierarchical subdivision; SpacecellBase interface in types.go.
SpatialKey — coordinate-based index used for spatial lookups; type SpatialKey [4]int32 in types.go.
Space — a Go type alias map[SpatialKey]SpacecellBase used for spatial indexing. It is not a top-level container that organizes branes; that framing was incorrect.
CBOR — Concise Binary Object Representation (RFC 8949). Avvyland's preferred wire format on REST and WebSocket; JSON is supported as a compatibility fallback per APP_DESCRIPTION.md.
ObjectID — UUID v4 string (8-4-4-4-12).
Idempotency-Key — UUID header required on mutating /object, /prototype, /users requests; keys are scoped per user and expire after 24 hours (openapi-v2.yml).
Visibility — private / unlisted / public on Objects. Public/unlisted readable without authentication; updates create a new private draft version.
Transform — [16]float32 4×4 column-major matrix (types.go line 503).
state-server — the Go backend that owns entities and real-time sync.
avvy-worker — async worker that runs 3D model-processing tasks (preview, projection, canonical GLB) and returns signed CBOR callbacks.
avvy-app (also referred to as Avvy or avvyapp) — the React web client.
avvy-engine — Three.js + AssemblyScript/WASM rendering library bundled by avvy-app.
state-server/internal/domain/entity/types.go, state-server/internal/domain/entity/objects.go, state-server/STATE_SERVER_COMPREHENSIVE_DESCRIPTION.md, state-server/docs/openapi-v2.yml, state-server/docs/APP_DESCRIPTION.md.