# Glossary

> Every term the DiceyTable Developer Docs use, defined once: the ECS nouns, the three names, seat templates and zone types, and the provenance axis.

- Source: https://diceytable.com/docs/editor/concepts/glossary
- Last verified: 2026-10-06

Every term the Developer Docs use is defined here, once. Each entry has a stable anchor, so
other pages link to a definition rather than repeating it — for example
`/docs/editor/concepts/glossary#scene-entity`.

This vocabulary is normative. If a term you need is missing, add it here rather than
coining a synonym elsewhere.

## A

### Asset

Loose term for a file in the project tree — a model, texture, material, script or deck. In
the vocabulary it is a [Definition](https://diceytable.com/docs/editor/concepts/glossary#definition): it lives in the asset explorer, not in the
scene.

## C

### Capability

A permission a mod must declare in its manifest before its script may use the matching part
of the mod API. The ten capabilities are `log`, `spawn-object`, `register-action`,
`read-context`, `read-world`, `object-action`, `saved-data`, `subscribe-events`, `ui` and
`play-sound`. A script that calls an API guarded by a capability it did not declare is
rejected.

### Card identity

Which card a `kind: "card"` entity *is*, as opposed to what it is called. Carried by
[label](https://diceytable.com/docs/editor/concepts/glossary#label), and the input to [hidden-information redaction](https://diceytable.com/docs/editor/concepts/glossary#hidden-information-redaction).
Changing a card's slug changes its identity.

### Component

Data and behavior attached to one [Entity](https://diceytable.com/docs/editor/concepts/glossary#entity). **Only ever an engine component:**
`render`, `rigidbody`, `collision`, `light`, `camera`, `script`, `sound`, `element`,
`screen`. Never a synonym for a thing placed on the table — that is an Entity. See
[Engine Component](https://diceytable.com/docs/editor/concepts/glossary#engine-component), [Intrinsic component](https://diceytable.com/docs/editor/concepts/glossary#intrinsic-component),
[Optional component](https://diceytable.com/docs/editor/concepts/glossary#optional-component).

## D

### Definition

The reusable blueprint for something, held in the project tree or asset explorer and **not
in the scene**. Templates, presets, materials, textures, scripts, models and decks are all
Definitions. Dragging one into the scene creates a [Scene Entity](https://diceytable.com/docs/editor/concepts/glossary#scene-entity) from it.
Also called a *Template*, a *Preset* or an [Asset](https://diceytable.com/docs/editor/concepts/glossary#asset).

### Detached

A seat that owns its own world-space zones, name label and card holders and ignores the
[Seat template](https://diceytable.com/docs/editor/concepts/glossary#seat-template). The state every seat is in when a scene has no template, and
what [Linked](https://diceytable.com/docs/editor/concepts/glossary#linked) is the opposite of. Detaching is a visual no-op: the template's current
geometry is frozen onto the seat first, and its card holders stay put as ordinary entities.

### displayName

An entity's optional human name. Free-form, up to 80 characters, edited in the Inspector's
`Name` field, shown in the Hierarchy row and used as the Live Entity's engine name. Falls
back to [label](https://diceytable.com/docs/editor/concepts/glossary#label) when absent. Not an address.

### dt: namespace

The reserved prefix for platform-owned [tags](https://diceytable.com/docs/editor/concepts/glossary#tag). Unauthorable: the author-tag character
class excludes `:`, so `dt:` tags cannot be forged by an author or a mod. They are shown
dimmed and non-removable in the editor, and they **do** appear in anything that reads an
entity's tags. Members: `dt:internal`, `dt:object`, `dt:kind:<kind>`, `dt:seat-group`,
`dt:child`.

### Draft

The local, unsaved state of a scene you are editing. Lives in your browser, is written to a
browser-local mirror of your eventual repository, and is never uploaded to a DiceyTable
server.

## E

### Edit Mode

DiceyTable's authoring environment, at `/editor` and via the Edit Mode toggle on the table
toolbar. Edits the [scene document](https://diceytable.com/docs/editor/concepts/glossary#scene-document) with physics [Frozen](https://diceytable.com/docs/editor/concepts/glossary#frozen) by
default.

### Engine

[Provenance](https://diceytable.com/docs/editor/concepts/glossary#provenance) value: provided by PlayCanvas. Engine components and engine
systems.

### Engine Component

A [Component](https://diceytable.com/docs/editor/concepts/glossary#component), qualified to make clear it is the engine's kind rather than a
[Platform panel](https://diceytable.com/docs/editor/concepts/glossary#platform-panel). Inspector sections for engine components carry a
distinct header accent.

### Entities (N)

The Hierarchy folder that holds a scene's [Scene Entities](https://diceytable.com/docs/editor/concepts/glossary#scene-entity). `N` counts every
entity in the scene, not only the un-parented ones. Formerly, and wrongly, called
`Components (N)`.

### Entity

A container with a transform and no behavior of its own. Every Hierarchy row with a
transform is an Entity. The composition-axis term for a thing you place on the table. See
also [Scene Entity](https://diceytable.com/docs/editor/concepts/glossary#scene-entity), [Live Entity](https://diceytable.com/docs/editor/concepts/glossary#live-entity).

## F

### Folder

A Hierarchy grouping row that is **not** an Entity and has no transform: Room, Walls,
Lights, Table, Player Zones, [Entities (N)](https://diceytable.com/docs/editor/concepts/glossary#entities-n) — and the folders you make inside
`Entities` and `Snap Points` to organise them, plus the per-seat folders the seat template's
pieces are filed in. Shows `folder` in the `TYPE` column. Clicking one you made (or a seat
folder) selects everything in it. Not addressable from a script or a mod, and not replicated —
it is organisation only. See [Folders](https://diceytable.com/docs/editor/interface/hierarchy#folders-in-entities-and-snap-points).

### Frozen

The viewport state in which physics does not step and entities hold their authored
position. The default in [Edit Mode](https://diceytable.com/docs/editor/concepts/glossary#edit-mode). Its counterpart is [Live](https://diceytable.com/docs/editor/concepts/glossary#live).

## G

### guid

The engine's identifier for a [Live Entity](https://diceytable.com/docs/editor/concepts/glossary#live-entity). **Unstable** — entities are
destroyed and recreated whenever the document is applied, so guids change. Never persisted,
never replicated, never exposed to a script or a mod. The stable key is [id](https://diceytable.com/docs/editor/concepts/glossary#id).

## H

### Hand zone

A [Seat zone](https://diceytable.com/docs/editor/concepts/glossary#seat-zone) of type `hand`: the seat's private hand area. The **single** writer of
an entity's owning seat — dropping an entity inside one is what makes it a hand card, routes
deals to it, and subjects it to face-down
[hidden-information redaction](https://diceytable.com/docs/editor/concepts/glossary#hidden-information-redaction). Up to 8 per seat, enforced by
the schema; their cards read as one hand, and deals fill the `primary` one first. A volume, not an entity; contrast the [card holder](https://diceytable.com/docs/editor/concepts/glossary#platform-kind), which is a
named pile location with a capture radius. The two compose.

### Hidden zone

A [Seat zone](https://diceytable.com/docs/editor/concepts/glossary#seat-zone) of type `hidden`: its contents are concealed from any viewer not
entitled to the seat **regardless of face-up or face-down**, which is what distinguishes it from
a [hand zone](https://diceytable.com/docs/editor/concepts/glossary#hand-zone). There is **no GM or see-all role** anywhere in DiceyTable — no
spectator, referee or dungeon-master exemption exists.

### Hidden-information redaction

The host-authoritative mechanism that removes identity-bearing state from what a peer
receives, so a player cannot learn a face-down card by reading network traffic. Keyed on
[card identity](https://diceytable.com/docs/editor/concepts/glossary#card-identity).

### Hierarchy

The editor's left-hand tree. An **authoring view of the scene document**, keyed by
[id](https://diceytable.com/docs/editor/concepts/glossary#id) — not the engine's scene graph. See [Document vs
engine](https://diceytable.com/docs/editor/concepts/document-vs-engine).

### Host-authoritative

The replication model: exactly one peer is the host, owns the authoritative state, and is
the only peer whose mutations count. Other peers send intents and wait for the resulting
state.

## I

### id

An entity's **address**: assigned on creation, up to 96 characters, stable for the entity's
lifetime, unique in the scene, and never edited by hand. The only thing that resolves an
entity — `parentId` points at it, actions target it, queries return it.

### Inspector

The editor's right-hand panel: one collapsible section per engine component and per
[Platform panel](https://diceytable.com/docs/editor/concepts/glossary#platform-panel), plus the `ENTITY` header and the read-only `ENTITY
(ADVANCED)` view.

### Intent

A single described mutation of table state. Peers send intents to the host rather than
mutating shared state themselves.

### Intrinsic component

One of `render`, `collision`, `rigidbody`. Present on every [Scene Entity](https://diceytable.com/docs/editor/concepts/glossary#scene-entity),
authored in `physics` and `metadata` rather than in a component list, and **configured and
disabled, never removed**. `RIGIDBODY` and `COLLISION` have enable flags; `RENDER` does not
— the entity's own `Enabled` toggle is the control.

## J

### Joint

A physics constraint connecting two independently-dynamic bodies. Not
[parenting](https://diceytable.com/docs/editor/concepts/glossary#parenting) and not a [weld](https://diceytable.com/docs/editor/concepts/glossary#weld): both bodies keep simulating.

## K

### Kind

See [Platform kind](https://diceytable.com/docs/editor/concepts/glossary#platform-kind).

## L

### label

An entity's **slug**: lowercase, dash-separated, unique in the scene, up to 80 characters,
edited in the Inspector's `Slug` field. The machine-facing name — scripts and mods use it —
and, for `kind: "card"`, the [card identity](https://diceytable.com/docs/editor/concepts/glossary#card-identity). Not an address.

### Linked

A seat whose zones, name label and card holders **are** the [Seat template](https://diceytable.com/docs/editor/concepts/glossary#seat-template)'s.
It stores only its group transform (position and rotation Y), its color and an optional label
text override — deliberately **no scale**, so every linked seat matches the template by
construction. Renders no children in the [Hierarchy](https://diceytable.com/docs/editor/concepts/glossary#hierarchy). The opposite of
[Detached](https://diceytable.com/docs/editor/concepts/glossary#detached).

### Live

The viewport state in which physics steps normally. Counterpart to [Frozen](https://diceytable.com/docs/editor/concepts/glossary#frozen).
Running a scene script switches Frozen to Live automatically.

### Live Entity

The `pc.Entity` the runtime builds from a [Scene Entity](https://diceytable.com/docs/editor/concepts/glossary#scene-entity). Ephemeral,
addressed by [guid](https://diceytable.com/docs/editor/concepts/glossary#guid), never persisted, destroyed and recreated on every document
apply. Carries the [Engine Components](https://diceytable.com/docs/editor/concepts/glossary#engine-component).

## M

### Manifest

The file that declares a mod: its identity, entry point, [capabilities](https://diceytable.com/docs/editor/concepts/glossary#capability) and
assets. Validated against a shared schema on registration.

### Mod

A GitHub-hosted package that adds a game to DiceyTable. Its script is untrusted, runs in a
sandboxed iframe, and reaches the table only through the capability-gated mod API.

### Mod Scripting

The mod-facing script surface: JavaScript, hosted in a mod's GitHub repository, reaching the
table through the `api` global, gated by [capabilities](https://diceytable.com/docs/editor/concepts/glossary#capability), and statically scanned
before it is accepted. Distinct from [Table Scripting](https://diceytable.com/docs/editor/concepts/glossary#table-scripting); the two are not
interchangeable and share no globals.

## O

### Optional component

An engine component listed in a Scene Entity's `components[]` array: addable, removable,
capped at **8** entries with at most one per type. The addable set is `light` and `camera`.
`script` is not among them — it is attached through `metadata.scriptId` and the `SCRIPT`
section.

## P

### Parenting

Giving one entity another as its parent, so the parent's transform propagates. **Transform
and organization only.** A parented child is held kinematic so it cannot fight its parent;
its authored body type is untouched and restored on unparent. Chains are capped at depth
**8**. Not a [joint](https://diceytable.com/docs/editor/concepts/glossary#joint) and not a [weld](https://diceytable.com/docs/editor/concepts/glossary#weld).

### PIECE

An Inspector [Platform panel](https://diceytable.com/docs/editor/concepts/glossary#platform-panel) holding an entity's
[Platform kind](https://diceytable.com/docs/editor/concepts/glossary#platform-kind) (`TYPE`) and physical `SURFACE`. Sits above `RENDER`
because those are not engine-render fields.

### Piece

**Retired as a formal term.** Fine in ordinary prose; never a UI type label, an identifier
in new code, or a type name in these docs. Say [Entity](https://diceytable.com/docs/editor/concepts/glossary#entity).

### Platform

[Provenance](https://diceytable.com/docs/editor/concepts/glossary#provenance) value: defined by DiceyTable and available in every project.
Platform kinds and platform concepts such as [Seat zone](https://diceytable.com/docs/editor/concepts/glossary#seat-zone),
[Seat template](https://diceytable.com/docs/editor/concepts/glossary#seat-template), Snap Point, Decal, Text Label, Joint, Wall, Poster and Room
Light.

### Platform kind

A Scene Entity's DiceyTable classification: `card`, `deck`, `die`, `token`, `board`, `bag`,
`custom`, `card-holder`, `button`, `table`, `coin`. Shown as `TYPE` in the [PIECE](https://diceytable.com/docs/editor/concepts/glossary#piece) panel. A `table`
entity is furniture placed in a scene — not to be confused with a table pack, which is not an entity.

### Platform panel

An Inspector section that is **not** an engine component: `PIECE`, `DIE SETTINGS`, `SOUND
SETS (BUILT-IN)`, `SOUND OVERRIDES`. Carries a different header accent from engine sections.

### Project

[Provenance](https://diceytable.com/docs/editor/concepts/glossary#provenance) value: defined by an author inside one mod or scene. Project
materials, textures, scripts, models, decks, and the authored scene itself.

### Provenance

The axis that answers *who defined this*: [Engine](https://diceytable.com/docs/editor/concepts/glossary#engine), [Platform](https://diceytable.com/docs/editor/concepts/glossary#platform) or
[Project](https://diceytable.com/docs/editor/concepts/glossary#project).

## S

### Scene document

The authored source of truth for a scene: entities and their transforms, physics, materials,
tags, parents and components; seat zones; the room, its walls, posters and lights; project
scripts; snap points. The engine's entity tree is rebuilt from it, never the reverse.

### Scene Entity

An authored instance placed in the scene. Persisted, replicated, and addressed by
[id](https://diceytable.com/docs/editor/concepts/glossary#id). Instantiated at runtime as a [Live Entity](https://diceytable.com/docs/editor/concepts/glossary#live-entity).

### Scene script

A project script attached to the scene as a whole, rather than to one entity. See
[Table Scripting](https://diceytable.com/docs/editor/concepts/glossary#table-scripting).

### Seat group

One of the ten fixed player-color seats, as a [Tag Group](https://diceytable.com/docs/editor/concepts/glossary#tag-group) under the `Player Zones`
[Folder](https://diceytable.com/docs/editor/concepts/glossary#folder): a group transform, its [Seat zones](https://diceytable.com/docs/editor/concepts/glossary#seat-zone) and exactly one name label.
Addressed by the stable, color-independent id `seat-group-<index>`, and targeted as a set by the
`seat-group` tag. **Not a parent** — a seat's card holders are root entities tagged for the
seat, not children of it.

### Seat-local space

The frame a [Seat template](https://diceytable.com/docs/editor/concepts/glossary#seat-template)'s geometry is authored in: origin at the seat's
group pivot, **`+Z` pointing at the table centre**, world units (feet), rotations in degrees.
Each linked seat's group transform converts it to world space. The one convention an author can
get wrong silently.

### Seat template

A scene's single authored layout — one name label, typed [Seat zones](https://diceytable.com/docs/editor/concepts/glossary#seat-zone) and
card-holder **definitions**, plus optional seat dice, starting-layout piece definitions and a
dice tray, all in [seat-local space](https://diceytable.com/docs/editor/concepts/glossary#seat-local-space) — applied to any number of seats at once. Lives in the [scene document](https://diceytable.com/docs/editor/concepts/glossary#scene-document), never on the wire. It is the
source of truth for a [Linked](https://diceytable.com/docs/editor/concepts/glossary#linked) seat; that seat's own stored zones are a derived cache
re-materialized on every load and save, so a consumer that has never heard of templates still
reads correct world geometry.

### Seat zone

An authored translucent box owned by a [Seat group](https://diceytable.com/docs/editor/concepts/glossary#seat-group) or by the
[Seat template](https://diceytable.com/docs/editor/concepts/glossary#seat-template), carrying a **type** that decides what it does. Two-dimensional:
a footprint on the table plane with no height.

| Type | Effect |
|---|---|
| `hand` | See [Hand zone](https://diceytable.com/docs/editor/concepts/glossary#hand-zone). |
| `area` | Gates who may interact with what is inside. Confers **no** ownership. |
| `hidden` | See [Hidden zone](https://diceytable.com/docs/editor/concepts/glossary#hidden-zone). |
| `scripting` | Geometry only — raises enter/leave events and nothing else. |
| `reveal` · `layout` · `randomize` · `fog-of-war` · `drop` | Parse and render; **no behaviour yet**. Listed in the schema so a scene authored on a newer client still loads on an older one. |

Every type raises enter and leave events. A zone's **tag filter** gates occupancy itself: no tags
matches everything, one or more matches an entity sharing at least one of them.

### Slug

See [label](https://diceytable.com/docs/editor/concepts/glossary#label). Also the Inspector field that edits it.

### Snapshot

The replicated form of table state. The host broadcasts full snapshots as keyframes and
incremental deltas in between.

### Sound emitter

A point in the room that plays a sound file — rain, a fire, birds — on a seamless loop or once
every so often. Authored in the room's `Sounds (N)` folder beside `Lights`, and stored in the
room (`room.sounds`), not in the table. **Not an [Entity](https://diceytable.com/docs/editor/concepts/glossary#entity) and not a
[Component](https://diceytable.com/docs/editor/concepts/glossary#component)**: it has no physics, is not in the [Snapshot](https://diceytable.com/docs/editor/concepts/glossary#snapshot), and is not
replicated. Every player plays it locally, on their own schedule, at their own Environment
volume. Distinct from an engine `sound` component, which is not exposed in the editor. See
[Room and lighting § Sounds](https://diceytable.com/docs/editor/working/room-and-lighting#sounds).

### System

Owns every instance of one component type and processes them in batches. Engine-internal;
never surfaced in the editor, a scene script or a mod.

## T

### Table Scripting

The in-editor script surface: TypeScript, authored in the editor, reaching the table through
the `world`, `globalEvents` and `refObject` globals. Distinct from
[Mod Scripting](https://diceytable.com/docs/editor/concepts/glossary#mod-scripting); the two surfaces share no globals and are documented
separately.

### Tag

A short lowercase token attached to an entity for grouping. Character class `[a-z0-9_-]`,
1–32 characters, up to 100 per entity, stored lowercase and de-duplicated. Tags whose names
begin `dt:` belong to the [dt: namespace](https://diceytable.com/docs/editor/concepts/glossary#dt-namespace) and cannot be authored.

### Tag Group

A set of Entities defined by a shared tag, such as `seat-group`. Shows `tag group` in the
`TYPE` column. **Not a parent** — membership is by tag, so moving the "group" moves nothing.

### Template

See [Definition](https://diceytable.com/docs/editor/concepts/glossary#definition).

## V

### Variant

One of several set-ups a single game pack is offered in — a board size, a seat count, with or
without scripts. The room's owner picks one in the lobby before the table starts. Stored in two
halves: the list in the [manifest](https://diceytable.com/docs/editor/concepts/glossary#manifest), and what each variant changes in the
[scene document](https://diceytable.com/docs/editor/concepts/glossary#scene-document). The editor shows one variant at a time. Not a
[setup option](https://diceytable.com/docs/mods/manifest/variants#variants-or-setup-options), which is an answer handed
to a script. See [Game variants](https://diceytable.com/docs/mods/manifest/variants).

The **base variant** is the one the scene document's top level describes; every other variant is
recorded as its differences from the base. It is not necessarily the lobby's default, which is
the first variant in the manifest's list.

## W

### Weld

Merging a parented assembly into the parent's single compound rigidbody: the parent's
collider becomes compound, descendants keep `collision` and lose `rigidbody`. One dynamic
body with combined mass and inertia. Welded members cannot be grabbed individually, and
welding a member of an already-welded assembly is rejected. Not [parenting](https://diceytable.com/docs/editor/concepts/glossary#parenting) and
not a [joint](https://diceytable.com/docs/editor/concepts/glossary#joint).
