Dice & D&D

Dice & D&D

Tabletop dice rolling, in the notation Avrae uses.

10 commands

Dice notation

Everything r!r (and /dnd roll’s expression field) understands. The slash command can build most of this for you from its options, but the notation is faster once you know it, and it is the same syntax Avrae uses.

Basics

1d20
One twenty-sided die. The leading 1 is optional; d20 works too.
4d6
Four six-sided dice, summed.
1d20+5
A flat modifier. Negatives work: 1d20-2.
1d20 + 1d4 + 2
As many terms as you like.
(1d4+1)*2
Parentheses and arithmetic: *, /, // all work.

Keep & drop

4d6kh3
Keep the highest 3, the classic ability-score roll.
4d6kl1
Keep the lowest 1.
4d6ph1
Drop the highest 1.
4d6pl1
Drop the lowest 1.
4d6k>3
Keep every die above 3 (k< and p> also work).
4d6k1
Keep only the dice that rolled exactly 1.

Rerolls

4d6rr1
Reroll 1s, repeatedly, until none are left.
4d6ro<3
Reroll anything below 3, once each, whatever it becomes.
4d6ra<2
Reroll below 2 and add the new die to the old one.

Exploding

4d6e6
Roll an extra die for every 6.
4d6e>4
Explode on 5 and up.

Bounds

1d20mi2
Treat anything below 2 as a 2 (Elven Accuracy, Reliable Talent).
1d20ma19
Treat anything above 19 as a 19.

Rolling your character

r!c stealth
Skill check, using the modifier your sheet worked out.
r!c perception adv
With advantage. Use dis for disadvantage.
r!c athletics +2
A one-off bonus. Order doesn’t matter: r!c athletics +2 adv.
r!s dex
Saving throw. Full names work too: r!s wisdom.
r!a rapier
Attack and damage together; crits double the dice.
r!hp -7
Damage. r!hp +5 heals, r!hp full resets, r!hp temp 8 sets temporary.
r!cast fireball at 4
Casts, shows the SRD text, spends the slot.
r!slots · r!rest
What’s left, and getting it all back.
r!sheet
Your active character at a glance.

Labels & advantage

2d6[fire] + 1d8[cold]
Annotate parts of a roll: damage types, sources.
8d6 fireball
Trailing text becomes the roll’s title.
r!r 1d20+5 adv
Advantage. Use dis for disadvantage.

/dnd

group
Raven-chanOmni-chan

Tabletop dice rolling, in the same notation Avrae uses.

Arguments
  • expressionoptional string Dice to roll as notation. Supports keep/drop (kh, kl, p), rerolls (rr, ro, ra), exploding (e), bounds (mi, ma), [annotations] and a trailing comment. Leave blank to use the builder options instead.
  • dieoptional choice d4, d6, d8, d10, d12, d20 or d100. The builder alternative to writing notation.
  • diceoptional integer How many of that die (1–100, default 1).
  • modifieroptional integer Flat bonus or penalty, e.g. 5 or -2.
  • keepoptional choice Keep highest / Keep lowest / Drop highest / Drop lowest.
  • keep_countoptional integer How many dice to keep or drop (default 1).
  • reroll_belowoptional integer Reroll any die below this, once.
  • explodeoptional boolean Roll an extra die for every maximum face.
  • minimumoptional integer Treat any die lower than this as this.
  • maximumoptional integer Treat any die higher than this as this.
  • advantageoptional choice Advantage or Disadvantage. Rolls the leading d20 twice.
  • timesoptional integer Roll the same thing up to 20 times, with high/low/average (rolling stats).
  • labeloptional string Name the roll. Shown as the title.
  • secretoptional boolean Show the result only to you.
Subcommands
  • /dnd roll Roll dice: 1d20+5, 4d6kh3, 2d6[fire], 8d6 fireball.
Examples
/dnd roll expression: 1d20+5/dnd roll die: d6 dice: 4 keep: Keep highest keep_count: 3 times: 6/dnd roll expression: 8d6 fireball/dnd roll expression: 1d20+7 advantage: Advantage label: Stealth

Two ways to roll, and they are mutually exclusive: write notation in expression, or build it from die/dice/keep/explode and the rest. The builder compiles to notation and the result always shows what it rolled, so it doubles as a way to learn the syntax. Powered by the MIT-licensed d20 library, the same dice parser Avrae uses. Natural 20s turn the embed gold, natural 1s red. Restrict it to a channel with /blacklist add dnd. Not to be confused with /roll, which is the gambling command.

c

prefix
Raven-chanOmni-chan

Roll a skill check for your active character.

Aliases: check skill

<prefix>c <skill> [adv|dis] [+N]
Examples
r!c stealthr!c perception advr!c sleight of hand +2

Reads the modifier your character sheet already worked out. Build one at /dnd and set it active. Skill names match loosely: stealth, sleight, animal and perc all land. adv/dis and a one-off bonus can come in either order.

s

prefix
Raven-chanOmni-chan

Roll a saving throw for your active character.

Aliases: save

<prefix>s <ability> [adv|dis] [+N]
Examples
r!s dexr!s wisdom dis

Takes str/dex/con/int/wis/cha or the full ability name.

a

prefix
Raven-chanOmni-chan

Roll an attack and its damage from your character sheet.

Aliases: attack

<prefix>a [weapon] [adv|dis] [+N]
Examples
r!ar!a rapierr!a shortbow adv

Rolls to hit and damage together. A critical doubles the damage dice and not the modifier; a natural 1 rolls no damage. Weapon names match loosely, and no name at all uses your first attack.

hp

prefix
Raven-chanOmni-chan

Track your character’s hit points.

<prefix>hp [-N | +N | temp N | full]
Examples
r!hpr!hp -7r!hp +5r!hp temp 8r!hp full

Temporary hit points soak damage first. Dropping below zero keeps the negative rather than clamping, since it matters for death saves. Current HP lives outside the sheet, so editing your character on the site never resets it.

cast

prefix
Raven-chanOmni-chan

Cast a spell. Shows the SRD text and spends the slot.

<prefix>cast <spell> [at N]
Examples
r!cast fireballr!cast magic missile at 3r!cast light

Looks the spell up in the bundled SRD 5.1 and shows it alongside your own save DC and spell attack. "at N" upcasts; casting from a slot below the spell’s level is refused; cantrips spend nothing.

slots

prefix
Raven-chanOmni-chan

Show your remaining spell slots.

<prefix>slots

rest

prefix
Raven-chanOmni-chan

Long rest: full hit points and every spell slot back.

Aliases: longrest

<prefix>rest

sheet

prefix
Raven-chanOmni-chan

Show your active character at a glance.

Aliases: mychar

<prefix>sheet

Abilities, AC, HP, initiative, save proficiencies, trained skills, attacks and spell slots.

r

prefix
Raven-chanOmni-chan

Roll dice by prefix, the same engine as /dnd roll.

Aliases: roll dice

<prefix>r <expression> [adv|dis]
Examples
r!r 1d20+5r!r 1d20+5 advr!r 4d6kh3

Notation only. The builder options are what the slash command is for. Add adv or dis on the end for advantage/disadvantage. Your command message is deleted once the result posts (where the bot can manage messages); a roll that fails to parse keeps it, so you can edit and retry. All the r! dice commands honour /blacklist add dnd.