Dice Rolls

Roll dice right inside your notes. Write a formula in inline code that starts with dice: and it turns into its result. Click the result to roll again.

The goblin attacks: `dice: 1d20+4` to hit, `dice: 1d6+2` slashing damage.
Ability scores: `dice: 4d6dl1` `dice: 4d6dl1` `dice: 4d6dl1`

It works in Live Preview and in Reading view, on desktop and on mobile. Hover over a result to see the formula and every die rolled. Put the cursor inside a roll to edit its formula. A roll keeps its result while you edit around it; it changes only when you click it.

Coming from Dice Roller

This plugin reads the dice formulas of Dice Roller, with the same dice: syntax, modifiers and flags, so notes written for it roll the same way. Settings → Import from Dice Roller copies your saved formulas.

What is different:

• No surprise rewrites of your notes. A dice-mod: roll writes its result into the note only when you click it, or when you run Write the results of dice-mod rolls in this note. Either way it is one change that one undo takes back, and it is refused if the note changed in the meantime.
• Custom ranges include both ends. 1d[3,5] rolls 3, 4 or 5, and so does 1d[3-5]. A list of three or more numbers, such as 1d[1,3,5], is a die with exactly those faces.
• A roll history in the sidebar, with the note each roll came from, and a dialog to roll any formula without writing it into a note.
• Clear errors. A formula that cannot be rolled stays visible, underlined, with the reason in its tooltip.

Not included: section, table, tag, line and Dataview rollers (dice: [[Note]], dice: #tag), narrative dice and 3D dice. Those codes stay as plain code, so you can keep Dice Roller installed for them.

Formulas

Modifiers

Add them right after the dice. A number after a modifier is optional and defaults to 1.

Explode and reroll take conditions: 1d6!>=5 explodes on 5 and 6, 2d6r<3 rerolls 1s and 2s, 1d4r<2>3 rerolls 1s and 4s.

Counting successes

A condition right after the dice counts each die that meets it as one success.

Flags

Add flags after the formula with |, such as dice: 1d20+5|signed|nodice.

Writing a result into the note

dice-mod: 3d100 + 12 shows the formula with a pencil button. Click it and the code is replaced by the result, as Dice Roller writes it: 3d100 + 12 -> [75, 20, 75] + 12 -> 182. With |noform, or the setting off, only the total is written. dice+: and dice-: roll like dice:.

Commands

None has a hotkey by default; assign them in Settings → Hotkeys.

Settings

• Show a dice button next to each result.
• Show the formula with the result, such as 2d6+3 → [3, 4]+3 → 10.
• Rounding of results with decimals: two decimals (the default), round, round up or round down.
• Plus sign on positive results.
• Faces of a die written without them: 100 by default, as in Dice Roller.
• Write the formula and the dice with dice-mod:, and Escape Markdown in what it writes so [75, 20] does not read as a link.
• Add rolls from notes to the history, and how many rolls to keep.
• Saved formulas: give a formula a name, such as attack for 1d20+5, and use the name alone (dice: attack) or inside a formula (dice: attack + 2).

Installation

In Obsidian, open Settings → Community plugins → Browse and search for "Dice Rolls".

More plugins by Siulved54

All of them are in the community directory: Settings -> Community plugins -> Browse, then search for the name.