01 · Basics

One line, one preset

Use name = formula for named presets, a lone formula for unnamed presets, # for categories and // for comments.

#combat
attack = 1d20+5
damage = 2d6+3

#generic
2d6+4

02 · Math

Natural expressions

TAPD supports arithmetic operators and parentheses.

1d20+5
2d6+3
(2d6+3)*3
2*(1d8+1)
d20+4

03 · Dice modifiers

Keep, drop, advantage

Use compact notation or more readable aliases.

4d6kh3
4d6kl2
4d6dh1
4d6dl1

2d20 advantage
2d20 disadvantage
4d6 best 3
4d6 worst 2
4d6 high 3
4d6 low 2

04 · Successes

Count hits instead of totals

Use canonical syntax or the readable shortcut.

count(6d10>=8)
count(4d6kh3>=5)

6d10 count success >= 8
6d10 successes >= 8
2d20 advantage count success >= 15

05 · Helpers

Utility functions

Small helpers for shaping results.

sum(3x(1d4+1))
min(1d20+3, 1d20+5)
max(2d6, 1d12+2)
abs(1d6-8)
floor((1d10+3)/2)
ceil((1d10+3)/2)