# RENDER

> The RENDER engine component — material assignment only. It has no enable checkbox by design; the ENTITY header's Enabled toggle is the only visibility control.

- Source: https://diceytable.com/docs/editor/inspector/render
- Last verified: 2026-07-27

`RENDER` is an **Engine component** section (`tone="engine"`), intrinsic to every table
Entity — every object has one, and it can be configured but never removed. It is the
smallest section in the Inspector: one field.

Source: the `RENDER` `EmCollapsible` in `TableEditModeShell.tsx`'s `object` Inspector branch.

## Fields

| Field | Type | Values | Default | Runtime effect | Replicates |
|---|---|---|---|---|---|
| **Material** | drag-and-drop material slot (`MaterialBox`) | any project [`SceneMaterial`](https://diceytable.com/docs/editor/inspector/materials-and-textures) or built-in preset, or empty | empty (the runtime's per-kind default appearance) | Assigns the material the runtime renders this entity's mesh with. Dragging a material card onto the slot assigns it; the × clears it back to the per-kind default. | Yes — `metadata.materialId`, part of `TableObjectState.metadata` |

## ⚠ `RENDER` has no enable checkbox

Unlike `RIGIDBODY` and `COLLISION`, `RENDER` renders with **no header enable checkbox at
all**. This is deliberate, not an oversight:

- Visibility is owned end-to-end by one writer — the runtime function that applies
  visibility to an object also encodes the card-face and hidden-information redaction rules.
  A second, independent `render` enable flag would fight that writer.
- The control that governs whether this entity draws anything is the
  [`ENTITY`](https://diceytable.com/docs/editor/inspector/entity) header's own **Enabled** toggle — which, per
  PlayCanvas semantics, disables every component (not just render) when turned off.
- A `metadata.renderEnabled` flag was proposed during the ECS alignment work and **never
  implemented**. If you encounter a reference to it — in an older doc, a comment, or a
  memory file — treat it as stale; `docs/memory/ecs-terminology.md` has been corrected to
  match this.

## See also

- [ENTITY](https://diceytable.com/docs/editor/inspector/entity) — the actual visibility control.
- [PIECE](https://diceytable.com/docs/editor/inspector/piece) — the panel directly above `RENDER`; it used to
  live inside `RENDER` and was split out because its fields (kind, surface) are not
  render state.
- [materials-and-textures.md](https://diceytable.com/docs/editor/inspector/materials-and-textures) — everything a
  `SceneMaterial` can configure once assigned here.
