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).
Colour
A die does not need uploaded art to be coloured. Its face colour is the
shared backgroundColor field: on other kinds that is a fill painted behind
transparent art, but a die has no art to sit behind, so the fill is the
die itself. Select the die in the Layout tab and use Appearance → Die
colour in the component inspector. Pips and numbers switch to light ink
automatically on a dark die, so a black die stays readable.
You can also just ask Pip — "make the dice red" is a change it can apply for you.
Dice added from the component library arrive with
a colour already chosen from a small swatch (ivory, red, blue, black); that
swatch stays editable in the inspector afterwards, and so does the free
colour picker. Colour and face art are independent: a face with its own
binding image draws that image, and the colour shows on the faces that
have none.
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 |
backgroundColor | #rrggbb | .optional() | The die’s face colour — see Colour above. Absent → white |
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, and the component library
- Tokens — for counters and chips rather than randomisers
- Shapes, behaviors & value bindings — non-rectangular outlines
- Rules reference — where the meaning of a roll lives