# Standard presets

> The 160 built-in STANDARD_OBJECT_PRESETS definitions — verified counts, the 22 hidden from spawn catalogs, and the pattern behind which ones are hidden.

- Source: https://diceytable.com/docs/mods/reference/standard-presets
- Last verified: 2026-08-12

A **standard preset** is a built-in, ready-made [`TableObjectDefinition`](https://diceytable.com/docs/mods/reference/object-state)
template — a die, a chess pawn, a poker chip — that a mod's `setup.json` or a table script can spawn by id
without hand-authoring every field. `STANDARD_OBJECT_PRESETS` (`packages/shared/src/standardObjects.ts`) is
the catalog; `buildStandardObjectPresetDefinition(presetId, position)` turns one preset id into a full
`TableObjectDefinition` ready to spawn.

**160 presets**, each with a `label`, `kind`, `family`, spawn height, and kind-appropriate defaults
(`color`, `scale`, `faceDown`, `stackCount`, `containerMode`, `capacityLimit`, `metadata`). The catalog grew
sharply with the KayKit "Board Game Bits" (CC0) import, which added most of the `pieces`, `tiles` and `props`
families. Verified against source 2026-08-12 — the full table with every preset's kind and family is below.

## Referencing a preset from a mod

A preset is addressed by its **preset id** — the left-hand key in `STANDARD_OBJECT_PRESETS`, e.g.
`"die-d20"` or `"chess-knight"` — a catalog key, and a different thing from the spawned entity's own `id`
(assigned fresh on every spawn; see [Object state](https://diceytable.com/docs/mods/reference/object-state#the-three-names-at-the-schema-level)).
The preset's `label` field (e.g. `"D20"`, `"Chess Knight"`) becomes the spawned entity's **`label`** — the
slug, not a cosmetic display string — and can be overridden per-instance like any other spawn, same as
`displayName` can be set alongside it.

Table scripts and mods do not call `buildStandardObjectPresetDefinition` directly — it is a
`packages/shared` helper the **host** (the `/table` app, and the legacy `mod-setup` template expansion) uses
internally. What you actually author is either a [setup.json](https://diceytable.com/docs/mods/files/setup-json) object placed
through Edit Mode's spawn catalog (which calls this same helper), or an ordinary
[`createObject`](https://diceytable.com/docs/scripting-api/api#apicreateobject)/`world.spawnObject` call with your own field
values — there is no `api.createObject({ presetId: … })` shortcut. Match a preset's field values by hand if
you want your own spawn to look like one.

## 160 presets, 22 hidden, 138 offered

Not every preset appears in the **Add Items** spawn catalog (the `/table` toolbar) or the editor's Models
library. `HIDDEN_SPAWN_PRESET_IDS` (`packages/shared/src/standardObjects.ts`) names **22** of the 160 that are
excluded from both catalogs, leaving **138** offered. A hidden preset is not disabled or deprecated — it is
exactly as spawnable as any other preset by id, and any *existing* scene or save that already placed one
keeps working unchanged. Hiding only curates what a browsing author is offered when adding something new.

> Source ground truth: `HIDDEN_SPAWN_PRESET_IDS` is a plain `Set<string>` with no per-entry comment
> explaining *why* each id is on it — only a header note that this "curates what new content offers."
> The grouping below is this page's own analysis of the 22 ids, verified against
> `STANDARD_OBJECT_PRESETS`' `family` field, not a quoted rationale from the source. Read it as an
> observed pattern, not a documented policy.

Grouped by `family`, the 22 hidden ids split cleanly into three kinds of exclusion:

### Whole pre-built board sets (8 of 9 `boards`)

**Eight of the nine `boards`-family presets are hidden**: `board-backgammon`, `board-cardbots`,
`board-checkers`, `board-chess`, `board-chinese-checkers`, `board-go`, `board-pachisi`, `board-reversi` — the
lone exception is the generic `board-checkers-wood`, which is offered. A specific game board on its own
doesn't compose the way a generic die or token does. Telling evidence: a checkers pack that ships a
playable board doesn't reach for `board-checkers` at all — it authors a `kind: "board"` object in
`setup.json` carrying its own metadata (snap grid, capture radius), over the generic
`board-checkers-wood`. A game-specific
board reads as something a **mod's setup** places deliberately for its one game, not something an author
browses to and adds piecewise from a catalog.

### Whole pre-built character/piece sets (10)

**All 6 `chess-*` pieces** (`chess-bishop`, `chess-king`, `chess-knight`, `chess-pawn`, `chess-queen`,
`chess-rook`) and **all 4 `piecepack-*` tokens** (`piecepack-arms`, `piecepack-crowns`, `piecepack-moons`,
`piecepack-suns`) are hidden. Both are pieces that only mean something as part of one specific game's
complete matching set — a lone chess bishop or a lone piecepack arms-suit tile isn't a generically useful
catalog entry the way a checker, a Go stone, or a plain token is (all of which **are** offered).

### Single redundant/niche items (4)

The remaining 4 don't share a family and are each hidden individually, each because a more general sibling
is already offered in the same family: `card-standard` (`deck-standard` is the offered card-family entry),
`die-piecepack` (a game-specific die face set, alongside the piecepack character tokens above),
`go-bowl-black` and `go-bowl-white` (redundant with the offered generic `bag-standard`/`bowl-standard`
containers).

## The full catalog

The complete, generated 160-row table — id, label, kind, family, and catalog visibility for every preset —
is appended below, generated directly from `STANDARD_OBJECT_PRESETS` so it cannot drift from source.

## See also

- [Object kinds](https://diceytable.com/docs/mods/reference/object-kinds) — the 9 `kind` values every preset resolves to, and their per-kind physics/scale defaults.
- [Object state](https://diceytable.com/docs/mods/reference/object-state) — the full `TableObjectState`/`TableObjectDefinition` shape a built preset definition fills in.
- [Setup JSON](https://diceytable.com/docs/mods/files/setup-json) — placing preset-derived objects in a mod's setup scene.
- [Limits and caps](https://diceytable.com/docs/mods/reference/limits-and-caps) — the size caps that bound how many objects (preset-derived or not) a table or setup file can hold.

## `STANDARD_OBJECT_PRESETS`

160 values. Built-in spawnable presets. `In catalogs = no` means the preset stays valid in existing scenes but is not offered when adding new content.

| Preset id | Label | Kind | Family | In catalogs |
|---|---|---|---|---|
| `card-standard` | Card | `card` | cards | no |
| `deck-standard` | Deck | `deck` | cards | yes |
| `die-d4` | D4 | `die` | dice | yes |
| `die-d6` | D6 | `die` | dice | yes |
| `die-d8` | D8 | `die` | dice | yes |
| `die-d10` | D10 | `die` | dice | yes |
| `die-d12` | D12 | `die` | dice | yes |
| `die-d20` | D20 | `die` | dice | yes |
| `die-piecepack` | Piecepack Die | `die` | dice | no |
| `board-backgammon` | Backgammon Board | `board` | boards | no |
| `board-cardbots` | CardBots Board | `board` | boards | no |
| `board-checkers` | Checkers Board | `board` | boards | no |
| `board-chess` | Chess Board | `board` | boards | no |
| `board-chinese-checkers` | Chinese Checkers Board | `board` | boards | no |
| `board-go` | Go Board | `board` | boards | no |
| `board-pachisi` | Pachisi Board | `board` | boards | no |
| `board-reversi` | Reversi Board | `board` | boards | no |
| `checker-black` | Black Checker | `token` | pieces | yes |
| `checker-red` | Red Checker | `token` | pieces | yes |
| `checker-white` | White Checker | `token` | pieces | yes |
| `token-standard` | Token | `token` | pieces | yes |
| `chinese-checkers-piece` | Chinese Checkers Piece | `token` | pieces | yes |
| `chess-bishop` | Chess Bishop | `custom` | pieces | no |
| `chess-king` | Chess King | `custom` | pieces | no |
| `chess-knight` | Chess Knight | `custom` | pieces | no |
| `chess-pawn` | Chess Pawn | `custom` | pieces | no |
| `chess-queen` | Chess Queen | `custom` | pieces | no |
| `chess-rook` | Chess Rook | `custom` | pieces | no |
| `chip-10` | $10 Chip | `token` | chips | yes |
| `chip-50` | $50 Chip | `token` | chips | yes |
| `chip-100` | $100 Chip | `token` | chips | yes |
| `chip-500` | $500 Chip | `token` | chips | yes |
| `chip-1000` | $1000 Chip | `token` | chips | yes |
| `domino-blank` | Domino | `custom` | tiles | yes |
| `mahjong-coin` | Mahjong Coin | `custom` | tiles | yes |
| `mahjong-stick` | Mahjong Stick | `custom` | tiles | yes |
| `mahjong-tile` | Mahjong Tile | `custom` | tiles | yes |
| `go-piece-black` | Go Stone (Black) | `token` | pieces | yes |
| `go-piece-white` | Go Stone (White) | `token` | pieces | yes |
| `go-bowl-black` | Go Bowl (Black) | `bag` | containers | no |
| `go-bowl-white` | Go Bowl (White) | `bag` | containers | no |
| `piecepack-arms` | Piecepack Arms | `token` | pieces | no |
| `piecepack-crowns` | Piecepack Crowns | `token` | pieces | no |
| `piecepack-moons` | Piecepack Moons | `token` | pieces | no |
| `piecepack-suns` | Piecepack Suns | `token` | pieces | no |
| `block-rectangle` | Rectangle Block | `custom` | blocks | yes |
| `block-square` | Square Block | `custom` | blocks | yes |
| `block-triangle` | Triangle Block | `custom` | blocks | yes |
| `bag-standard` | Bag | `bag` | containers | yes |
| `bag-infinite` | Infinite Bag | `bag` | containers | yes |
| `bowl-standard` | Bowl | `bag` | containers | yes |
| `counter-standard` | Counter | `token` | props | yes |
| `digital-clock` | Digital Clock | `custom` | props | yes |
| `notecard` | Notecard | `custom` | props | yes |
| `timer-standard` | Timer | `custom` | props | yes |
| `quarter` | Quarter | `token` | pieces | yes |
| `reversi-chip` | Reversi Chip | `token` | pieces | yes |
| `tablet` | Tablet | `custom` | props | yes |
| `3d-text` | 3D Text | `custom` | props | yes |
| `card-holder` | Card Holder | `custom` | containers | yes |
| `button-rect` | Button | `button` | props | yes |
| `button-round` | Round Button | `button` | props | yes |
| `board-checkers-wood` | Draughts Board | `board` | boards | yes |
| `card-stand` | Card Stand | `card-holder` | containers | yes |
| `wooden-cube` | Wooden Cube | `custom` | blocks | yes |
| `chess-king-dark` | Chess King (Dark) | `custom` | pieces | yes |
| `chess-queen-dark` | Chess Queen (Dark) | `custom` | pieces | yes |
| `chess-rook-dark` | Chess Rook (Dark) | `custom` | pieces | yes |
| `chess-bishop-dark` | Chess Bishop (Dark) | `custom` | pieces | yes |
| `chess-knight-dark` | Chess Knight (Dark) | `custom` | pieces | yes |
| `chess-pawn-dark` | Chess Pawn (Dark) | `custom` | pieces | yes |
| `meeple` | Meeple | `token` | pieces | yes |
| `pawn-round` | Pawn | `token` | pieces | yes |
| `pawn-tall` | Tall Pawn | `token` | pieces | yes |
| `player-disc` | Player Disc | `token` | pieces | yes |
| `flag-marker` | Flag | `token` | pieces | yes |
| `flag-pennant` | Pennant Flag | `token` | pieces | yes |
| `house` | House | `token` | pieces | yes |
| `game-tile` | Game Tile | `custom` | tiles | yes |
| `coin` | Coin | `coin` | pieces | yes |
| `chip-stylised-a` | Chip (Notched) | `token` | chips | yes |
| `chip-stylised-b` | Chip (Striped) | `token` | chips | yes |
| `coin-1` | Coin (1) | `coin` | pieces | yes |
| `coin-2` | Coin (2) | `coin` | pieces | yes |
| `coin-5` | Coin (5) | `coin` | pieces | yes |
| `coin-10` | Coin (10) | `coin` | pieces | yes |
| `tray-square` | Component Tray | `bag` | containers | yes |
| `tray-square-deep` | Deep Tray | `bag` | containers | yes |
| `tray-round` | Round Tray | `bag` | containers | yes |
| `tray-round-deep` | Deep Round Tray | `bag` | containers | yes |
| `tray-lid` | Tray Lid | `custom` | containers | yes |
| `hourglass` | Hourglass | `custom` | props | yes |
| `hourglass-empty` | Hourglass (Spent) | `custom` | props | yes |
| `domino-0-1` | Domino 0-1 | `custom` | tiles | yes |
| `domino-0-2` | Domino 0-2 | `custom` | tiles | yes |
| `domino-0-3` | Domino 0-3 | `custom` | tiles | yes |
| `domino-0-4` | Domino 0-4 | `custom` | tiles | yes |
| `domino-0-5` | Domino 0-5 | `custom` | tiles | yes |
| `domino-0-6` | Domino 0-6 | `custom` | tiles | yes |
| `domino-1-1` | Domino 1-1 | `custom` | tiles | yes |
| `domino-1-2` | Domino 1-2 | `custom` | tiles | yes |
| `domino-1-3` | Domino 1-3 | `custom` | tiles | yes |
| `domino-1-4` | Domino 1-4 | `custom` | tiles | yes |
| `domino-1-5` | Domino 1-5 | `custom` | tiles | yes |
| `domino-1-6` | Domino 1-6 | `custom` | tiles | yes |
| `domino-2-2` | Domino 2-2 | `custom` | tiles | yes |
| `domino-2-3` | Domino 2-3 | `custom` | tiles | yes |
| `domino-2-4` | Domino 2-4 | `custom` | tiles | yes |
| `domino-2-5` | Domino 2-5 | `custom` | tiles | yes |
| `domino-2-6` | Domino 2-6 | `custom` | tiles | yes |
| `domino-3-3` | Domino 3-3 | `custom` | tiles | yes |
| `domino-3-4` | Domino 3-4 | `custom` | tiles | yes |
| `domino-3-5` | Domino 3-5 | `custom` | tiles | yes |
| `domino-3-6` | Domino 3-6 | `custom` | tiles | yes |
| `domino-4-4` | Domino 4-4 | `custom` | tiles | yes |
| `domino-4-5` | Domino 4-5 | `custom` | tiles | yes |
| `domino-4-6` | Domino 4-6 | `custom` | tiles | yes |
| `domino-5-5` | Domino 5-5 | `custom` | tiles | yes |
| `domino-5-6` | Domino 5-6 | `custom` | tiles | yes |
| `domino-6-6` | Domino 6-6 | `custom` | tiles | yes |
| `character-tile-barbarian-blue` | Barbarian Tile (Blue) | `custom` | tiles | yes |
| `character-tile-barbarian-red` | Barbarian Tile (Red) | `custom` | tiles | yes |
| `character-tile-barbarian-green` | Barbarian Tile (Green) | `custom` | tiles | yes |
| `character-tile-barbarian-yellow` | Barbarian Tile (Yellow) | `custom` | tiles | yes |
| `character-tile-knight-blue` | Knight Tile (Blue) | `custom` | tiles | yes |
| `character-tile-knight-red` | Knight Tile (Red) | `custom` | tiles | yes |
| `character-tile-knight-green` | Knight Tile (Green) | `custom` | tiles | yes |
| `character-tile-knight-yellow` | Knight Tile (Yellow) | `custom` | tiles | yes |
| `character-tile-mage-blue` | Mage Tile (Blue) | `custom` | tiles | yes |
| `character-tile-mage-red` | Mage Tile (Red) | `custom` | tiles | yes |
| `character-tile-mage-green` | Mage Tile (Green) | `custom` | tiles | yes |
| `character-tile-mage-yellow` | Mage Tile (Yellow) | `custom` | tiles | yes |
| `character-tile-rogue-blue` | Rogue Tile (Blue) | `custom` | tiles | yes |
| `character-tile-rogue-red` | Rogue Tile (Red) | `custom` | tiles | yes |
| `character-tile-rogue-green` | Rogue Tile (Green) | `custom` | tiles | yes |
| `character-tile-rogue-yellow` | Rogue Tile (Yellow) | `custom` | tiles | yes |
| `character-tile-skeleton-brute` | Skeleton Brute Tile | `custom` | tiles | yes |
| `character-tile-skeleton-mage` | Skeleton Mage Tile | `custom` | tiles | yes |
| `character-tile-skeleton-minion` | Skeleton Minion Tile | `custom` | tiles | yes |
| `character-tile-skeleton-rogue` | Skeleton Rogue Tile | `custom` | tiles | yes |
| `character-standee-barbarian-blue` | Barbarian Standee (Blue) | `custom` | pieces | yes |
| `character-standee-barbarian-red` | Barbarian Standee (Red) | `custom` | pieces | yes |
| `character-standee-barbarian-green` | Barbarian Standee (Green) | `custom` | pieces | yes |
| `character-standee-barbarian-yellow` | Barbarian Standee (Yellow) | `custom` | pieces | yes |
| `character-standee-knight-blue` | Knight Standee (Blue) | `custom` | pieces | yes |
| `character-standee-knight-red` | Knight Standee (Red) | `custom` | pieces | yes |
| `character-standee-knight-green` | Knight Standee (Green) | `custom` | pieces | yes |
| `character-standee-knight-yellow` | Knight Standee (Yellow) | `custom` | pieces | yes |
| `character-standee-mage-blue` | Mage Standee (Blue) | `custom` | pieces | yes |
| `character-standee-mage-red` | Mage Standee (Red) | `custom` | pieces | yes |
| `character-standee-mage-green` | Mage Standee (Green) | `custom` | pieces | yes |
| `character-standee-mage-yellow` | Mage Standee (Yellow) | `custom` | pieces | yes |
| `character-standee-rogue-blue` | Rogue Standee (Blue) | `custom` | pieces | yes |
| `character-standee-rogue-red` | Rogue Standee (Red) | `custom` | pieces | yes |
| `character-standee-rogue-green` | Rogue Standee (Green) | `custom` | pieces | yes |
| `character-standee-rogue-yellow` | Rogue Standee (Yellow) | `custom` | pieces | yes |
| `character-standee-skeleton-brute` | Skeleton Brute Standee | `custom` | pieces | yes |
| `character-standee-skeleton-mage` | Skeleton Mage Standee | `custom` | pieces | yes |
| `character-standee-skeleton-minion` | Skeleton Minion Standee | `custom` | pieces | yes |
| `character-standee-skeleton-rogue` | Skeleton Rogue Standee | `custom` | pieces | yes |

The table above is the complete, verified 60-row catalog, generated directly from
`STANDARD_OBJECT_PRESETS` so it cannot drift from source. `In catalogs = no` marks the 23 ids in
`HIDDEN_SPAWN_PRESET_IDS` — see the grouped explanation above the table for the pattern behind which ones
those are. `Family` is a purely organizational string (`cards`, `dice`, `boards`, `pieces`, `chips`,
`tiles`, `containers`, `blocks`, `props`) used for catalog grouping in the editor and this table; it has no
schema meaning and nothing validates against it.
