Dice and visual systems

Physical shapes

Die	Valid faces	Presentation
d2	1–2	Procedural coin; 1 is front, 2 is back
d4	1–4	Value corresponds to the downward resting face
d6	1–6	Polyhedron
d8	1–8	Polyhedron
d10	1–10	Polyhedron
d12	1–12	Polyhedron
d20	1–20	Polyhedron
d100	1–100	Two visual bodies for one semantic result

View requires finite integer values in range. It has no native generic d3 or dF geometry. createMixedDisplayRequest() shows a generic d3 using d6 geometry (faces 1–3), omits dF by default, and can turn omission into an error. For 3D Fate use fate-df, which uses a physical d6. Try 1d2, try 1d20, or try 1d100.

d2 coin

The coin is generated at runtime; themes can replace front, back, edge, and dimensions. Its contract is fixed: local +Y/front shows 1, local −Y/back shows 2. Textures or symbols do not change this mapping.

System profiles

profileId	Theme	Geometry	Meaning
vampire-v5-normal-d10	vampire-v5-normal	d10	Normal V5 die
vampire-v5-hunger-d10	vampire-v5-hunger	d10	V5 Hunger die
assimilation-d6	assimilation	d6	Assimilation symbols
assimilation-d10	assimilation	d10	Assimilation symbols
assimilation-d12	assimilation	d12	Assimilation symbols
fate-df	fate	d6	Two −, two blank, two + faces
daggerheart-hope-d12	default-v2	d12	Hope, pink color
daggerheart-fear-d12	default-v2	d12	Fear, inverse color

The physical number remains authoritative. Fate uses d6 values 1–2 for −1, 3–4 for 0, and 5–6 for +1; Core supplies the semantic total. In Daggerheart, Hope and Fear remain numeric d12 dice; the profile changes color. Vampire V5 and Assimilation themes draw symbols while Core applies successes and other rules. Use createSystemDisplayRequest() or createMixedDisplayRequest() to apply the correct theme automatically.

Vampire V5

Normal and Hunger dice are d10s. Values 6–9 show success; 10 shows success plus a critical icon. A Hunger 1 bears a bestial marker. View draws these glyphs while Core determines critical pairs, bestial failure, and success totals. Try v5(7,3,4).

Assimilation

The d6, d10, and d12 profiles share an atlas for Success, Adaptation, and Pressure. Faces 1–2 are blank; 3–4 show Pressure; 5 combines Adaptation and Pressure; 6 shows Success. Larger dice add combinations through 12. Selection belongs to your application: pass keptIds to the adapter to fade other dice without changing faces. Try assim(2,1,1,1).

Fate

Each Fate Die is a physical d6 with pairs of −, blank, and + faces. fateValue belongs to Core’s result; View uses physicalValue to orient a face. Four dice are the default and the semantic total ranges from −4 to +4. Try fate(4).

Daggerheart

Hope and Fear are separate d12s. default-v2 keeps numbers visible; the profile colors Hope pink and Fear with its inverse. Core calculates the sum, optional difficulty, and critical success on matching faces. Try daggerheart(modifier=2,difficulty=15).

See Core integration and Themes and assets.