The /daggerheartRoll command opens the Daggerheart roll prompt. You can type it in the Journal or add it to an action as a Journal Command step. An optional argument after the command fills in the prompt ahead of time. The roller can still change anything in the prompt before pressing Roll.
How an argument works
An argument is a list of keys and values wrapped in curly braces, with a comma between each pair:
{"rollType": "action", "traitName": "Agility", "modifier": 1}Every key is optional. Leave out anything you don't need and the prompt uses its default.
Text values go in straight double quotes (
"Agility"). Numbers andtrue/falsedon't.If the argument can't be read (a missing brace, curly quotes, a stray comma), the prompt still opens, just without any of your values filled in. A key with an invalid value is skipped on its own.
Keys
You can double-click a key in the tables below to copy it into your own argument.
Any roll
Key | Purpose |
| Which roll prompt opens: a PC action roll, a PC reaction roll, an adversary (GM) roll, or a damage roll. Leave it out for an action roll. |
| The title shown on the Journal card. In an action, the title defaults to the step's name, then the action's name. |
| A flat bonus or penalty. Replace 0 with the actual modifier (positive or negative). Defaults to 0, so you only need it when it isn't zero. |
| Starts the roll with advantage or disadvantage. Works on action, reaction, and GM rolls. Damage rolls don't have advantage. |
| Adds extra dice to the prompt. |
Action and reaction rolls
Key | Purpose |
| The trait used for the roll. Alchemy reads the trait's value from the rolling character's sheet, so it stays current as the character changes. |
| Forces a specific trait value instead of reading it from the sheet. Most arguments should leave this out. |
| Uses the character's Spellcast trait from their sheet. If the sheet has no Spellcast trait, the roll falls back to |
| Used with |
| Opens the prompt in advanced mode. You need this for |
| The difficulty the roll must meet. Replace 10 with the actual difficulty. On action and reaction rolls this only applies together with |
| Shows a fixed list of Experiences to pick from. Leave it out and the prompt shows the rolling character's own Experiences. Experiences appear in the advanced prompt. |
| Changes the size of the Hope or Fear die. Both are d12 by default. |
GM rolls
Key | Purpose |
| The starting difficulty. Defaults to 10. The GM sets it to the target's Evasion in the prompt. |
| Changes the size of the GM die. Defaults to d20. |
Damage rolls
Key | Purpose |
| The damage type shown on the Journal card (for example, PHYSICAL DAMAGE). Defaults to physical. The type is a label only. It doesn't change how the roll is calculated. |
| For PC weapons and spells. Sets the die size, and the number of dice comes from the character's Proficiency. Replace d8 with the actual die size. |
| Sets the number of dice for a |
| For adversaries and anything else with a fixed number of dice. Replace 2 with the actual count and d8 with the actual die size. |
| Fixed damage with no dice (usually minions). Replace 5 with the actual value. |
Die sizes can be "d4", "d6", "d8", "d10", "d12", or "d20".
Action rolls
An action roll is a PC's duality roll (a Hope d12 and a Fear d12) plus a trait.
Action roll with a trait
Written example: "Make an Agility Roll"
{"rollType": "action", "traitName": "Agility"}Written example: "Make a Strength Roll with +1"
{"rollType": "action", "traitName": "Strength", "modifier": 1}Action roll with a set difficulty
Written example: "Make an Agility Roll (14)"
{"rollType": "action", "traitName": "Agility", "advanced": true, "difficulty": 14}Leave the difficulty out if the GM keeps it secret. The roller can open advanced mode and enter it at the table.
Spellcast roll
Written example: "Make a Spellcast Roll"
{"rollType": "action", "useSpellcastingTrait": true}Written example: "Make a Spellcast Roll (14) with +1"
{"rollType": "action", "useSpellcastingTrait": true, "advanced": true, "difficulty": 14, "modifier": 1}Written example: a feature that always casts with Presence
{"rollType": "action", "useSpellcastingTrait": true, "spellcastingTraitOverride": "Presence"}Action roll with advantage or disadvantage
Written example: "Make an Agility Roll with advantage"
{"rollType": "action", "traitName": "Agility", "advantageState": "advantage"}Action roll with an extra Hope die
Written example: "Make an Instinct Roll and add a Hope die"
{"rollType": "action", "traitName": "Instinct", "advanced": true, "extraDice": [{"kind": "rhombicHope", "size": "d12"}]}Extra dice appear in the advanced prompt, so include "advanced": true with them.
Reaction rolls
A reaction roll uses the same keys as an action roll. The Journal card is titled Reaction Roll unless you give it a title.
Written example: "Make an Agility Reaction Roll"
{"rollType": "reaction", "traitName": "Agility"}GM rolls
A GM roll is an adversary's attack roll: a d20 plus a modifier against the target's Evasion.
Written example: "ATK: +3"
{"rollType": "gm", "modifier": 3}Written example: "ATK: +0 with advantage"
{"rollType": "gm", "advantageState": "advantage"}The difficulty starts at 10. The GM enters the target's Evasion when the prompt opens.
Damage rolls
Damage rolls cover every weapon, spell, attack, and triggered effect that deals harm.
PC damage (scaled by Proficiency)
Use damageDieSize for PC weapons and spells. The number of dice comes from the character's Proficiency.
Written example: "d8 phy"
{"rollType": "damage", "damageType": "physical", "damageDieSize": "d8"}Written example: "d10+3 phy"
{"rollType": "damage", "damageType": "physical", "damageDieSize": "d10", "modifier": 3}Written example: "d6+1 mag"
{"rollType": "damage", "damageType": "magic", "damageDieSize": "d6", "modifier": 1}Adversary damage (fixed number of dice)
Use damageDice when the number of dice doesn't scale with Proficiency, such as adversary stat blocks and item-defined attacks.
Written example: "2d8+3 phy"
{"rollType": "damage", "damageType": "physical", "damageDice": {"count": 2, "size": "d8"}, "modifier": 3}Written example: "4d20 mag"
{"rollType": "damage", "damageType": "magic", "damageDice": {"count": 4, "size": "d20"}}Written example: "1d12+2 phy"
{"rollType": "damage", "damageType": "physical", "damageDice": {"count": 1, "size": "d12"}, "modifier": 2}Static damage (no dice)
For minions and effects that deal a fixed amount.
Written example: "5 phy"
{"rollType": "damage", "damageType": "physical", "staticDamageValue": 5}Written example: "12 phy"
{"rollType": "damage", "damageType": "physical", "staticDamageValue": 12}Stress damage
For effects that make the target mark Stress instead of Hit Points.
Written example: "1d4+1 Stress"
{"rollType": "damage", "damageType": "stress", "damageDice": {"count": 1, "size": "d4"}, "modifier": 1}Direct damage
For damage that armor can't reduce.
Written example: "8d10 direct mag"
{"rollType": "damage", "damageType": "direct magic", "damageDice": {"count": 8, "size": "d10"}}Written example: "3d6 direct phy"
{"rollType": "damage", "damageType": "direct physical", "damageDice": {"count": 3, "size": "d6"}}Attack and damage as a pair
Most weapons and spells pair an attack roll with a damage roll. Set them up as two actions: one for the attack and one for the damage. After the attack is rolled, a damage button appears under its Journal card so the roller can roll damage right away. This works under action, reaction, and GM roll cards.
Don't forget the Category! In the damage action's modal, set the Category field to Damage (capitalization doesn't matter). The damage action's step must also use "rollType": "damage". The damage action needs to live in the same place as the attack: on the same item, the same adversary, or the same character. If more than one damage action matches, the roller picks one, listed in the same order as the actions list.
Example: a PC weapon (Broadsword, d8 phy, Agility)
Attack action argument:
{"rollType": "action", "traitName": "Agility"}Damage action argument (Category: Damage):
{"rollType": "damage", "damageType": "physical", "damageDieSize": "d8"}Example: a PC spell (Arcane Bolt, d6+1 mag)
Attack action argument:
{"rollType": "action", "useSpellcastingTrait": true}Damage action argument (Category: Damage):
{"rollType": "damage", "damageType": "magic", "damageDieSize": "d6", "modifier": 1}Example: an adversary attack (+3 attack, 1d12+2 phy)
Attack action argument:
{"rollType": "gm", "modifier": 3}Damage action argument (Category: Damage):
{"rollType": "damage", "damageType": "physical", "damageDice": {"count": 1, "size": "d12"}, "modifier": 2}Standalone Hope and Fear dice (/roll)
To roll a single Hope or Fear die outside of an action roll, use the regular /roll command:
/roll 1d12rdhrolls a single Hope die./roll 1d12rdfrolls a single Fear die.
Standard dice modifiers work on these rolls:
Modifier | Effect |
| Keep the highest die |
| Keep the lowest die |
| Drop the highest die |
| Equal to N (success check) |
| Greater than N |
| Less than N |
| Greater than or equal to N |
| Less than or equal to N |
For example, /roll 2d12rdhkh1 rolls two Hope dice and keeps the highest. /roll 1d12rdh>=8 rolls a Hope die and counts a success on 8 or higher.
Quick reference
Written example | Argument |
Agility Roll |
|
Agility Roll (14) |
|
Spellcast Roll |
|
Agility Reaction Roll |
|
+3 attack (adversary) |
|
d8 phy (PC weapon) |
|
2d6+3 phy (adversary) |
|
5 phy (static) |
|
1d4+1 Stress |
|
8d10 direct mag |
|
Any action, reaction, or GM roll with advantage | Add |
Common gotchas
Difficulty needs advanced mode. On action and reaction rolls,
"difficulty"is ignored unless the argument also has"advanced": true. GM rolls don't need it.damageDieSize or damageDice?
"damageDieSize": "d8"is for PCs, where Proficiency sets the number of dice."damageDice": {"count": 2, "size": "d8"}is for everything else.Stress is a damage type. Roll Stress with
"rollType": "damage"and"damageType": "stress".Damage rolls don't take advantage.
advantageStateonly works on action, reaction, and GM rolls.Leave out traitValue. Without it, Alchemy reads the trait from the character sheet, so the roll keeps up as the character levels.
Use straight quotes. Text copied from a word processor or chat app often has curly quotes (“ ”). The argument won't be read and the prompt opens empty. Retype the quotes as
".