Dice
A die (kind: die) is a randomiser — a cube of pips, a custom symbol
die, a coin modelled as a two-faced die. Its faces are an ordered list of
at least two DieFace entries; rolling picks one at random.
taybl rolls the die and shows the chosen face, but it never reads the
result — there is no "add the dice", no re-roll rule, no hit table. Players
interpret the value themselves, just as at a real table. A die’s value can
be a number (a d6) or a string (a symbol die), and a face can carry its own
art so the rolled face draws correctly.
How to edit in the Studio
Open your game → Layout tab and select the die. The component inspector shows a Die faces section listing every face: edit each face’s value in its text box, give it an image with the face slot beside it, and use + Add face / the ✕ button to add or remove faces (a die must keep at least two).
Die fields
| Field | Values | Default | What it does |
|---|---|---|---|
kind | die | — | Marks this component as a die |
faces | array of DieFace (≥ 2) | — | Required. The faces the roll chooses between |
A die shares the rest of its fields with every kind — see components overview.
DieFace
| Field | Values | Default | What it does |
|---|---|---|---|
value | number or string | — | The face’s value — 6 for a pip die, "sword" for a symbol die |
binding | FaceBinding | .optional() | Art drawn when this face lands; absent → the renderer shows the bare value |
A face needs only a value — art is optional. A plain d6 is just six faces
with values 1–6 and no bindings.
Related
- Components overview — shared fields
- Tokens — for counters and chips rather than randomisers
- Shapes, behaviors & value bindings — non-rectangular outlines
- Rules reference — where the meaning of a roll lives