Skip to main content

/ DaggerheartRoll Command

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 and true/false don'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

"rollType": "action"
​"rollType": "reaction"
​"rollType": "gm"
​"rollType": "damage"

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.

"title": "Broadsword Attack"

The title shown on the Journal card. In an action, the title defaults to the step's name, then the action's name.

"modifier": 0

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.

"advantageState": "advantage"
​"advantageState": "disadvantage"

Starts the roll with advantage or disadvantage. Works on action, reaction, and GM rolls. Damage rolls don't have advantage.

"extraDice": [{"kind": "standard", "size": "d6"}]

Adds extra dice to the prompt. "kind" is "standard" for a regular die, "rhombicHope" for an extra Hope die, or "rhombicFear" for an extra Fear die.

Action and reaction rolls

Key

Purpose

"traitName": "Agility"
​"traitName": "Strength"
​"traitName": "Finesse"
​"traitName": "Instinct"
​"traitName": "Knowledge"
​"traitName": "Presence"

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.

"traitValue": 2

Forces a specific trait value instead of reading it from the sheet. Most arguments should leave this out.

"useSpellcastingTrait": true

Uses the character's Spellcast trait from their sheet. If the sheet has no Spellcast trait, the roll falls back to traitName.

"spellcastingTraitOverride": "Presence"

Used with "useSpellcastingTrait": true for features that always cast with a fixed trait, whatever the character's subclass says.

"advanced": true

Opens the prompt in advanced mode. You need this for "difficulty" to take effect.

"difficulty": 10

The difficulty the roll must meet. Replace 10 with the actual difficulty. On action and reaction rolls this only applies together with "advanced": true. Without a difficulty, the Journal card shows the result as With Hope or With Fear instead of a success or failure.

"experiences": [{"name": "Playing With Fire", "value": 2}]

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.

"hopeDieSize": "d12"
​"fearDieSize": "d12"

Changes the size of the Hope or Fear die. Both are d12 by default.

GM rolls

Key

Purpose

"difficulty": 10

The starting difficulty. Defaults to 10. The GM sets it to the target's Evasion in the prompt.

"gmDieSize": "d20"

Changes the size of the GM die. Defaults to d20.

Damage rolls

Key

Purpose

"damageType": "physical"
​"damageType": "magic"
​"damageType": "stress"
​"damageType": "direct physical"
​"damageType": "direct magic"

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.

"damageDieSize": "d8"

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.

"proficiency": 2

Sets the number of dice for a damageDieSize roll instead of reading Proficiency from the sheet.

"damageDice": {"count": 2, "size": "d8"}

For adversaries and anything else with a fixed number of dice. Replace 2 with the actual count and d8 with the actual die size.

"staticDamageValue": 5

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 1d12rdh rolls a single Hope die.

  • /roll 1d12rdf rolls a single Fear die.

Standard dice modifiers work on these rolls:

Modifier

Effect

kh1

Keep the highest die

kl1

Keep the lowest die

dh1

Drop the highest die

=N

Equal to N (success check)

>N

Greater than N

<N

Less than N

>=N

Greater than or equal to N

<=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

{"rollType": "action", "traitName": "Agility"}

Agility Roll (14)

{"rollType": "action", "traitName": "Agility", "advanced": true, "difficulty": 14}

Spellcast Roll

{"rollType": "action", "useSpellcastingTrait": true}

Agility Reaction Roll

{"rollType": "reaction", "traitName": "Agility"}

+3 attack (adversary)

{"rollType": "gm", "modifier": 3}

d8 phy (PC weapon)

{"rollType": "damage", "damageType": "physical", "damageDieSize": "d8"}

2d6+3 phy (adversary)

{"rollType": "damage", "damageType": "physical", "damageDice": {"count": 2, "size": "d6"}, "modifier": 3}

5 phy (static)

{"rollType": "damage", "damageType": "physical", "staticDamageValue": 5}

1d4+1 Stress

{"rollType": "damage", "damageType": "stress", "damageDice": {"count": 1, "size": "d4"}, "modifier": 1}

8d10 direct mag

{"rollType": "damage", "damageType": "direct magic", "damageDice": {"count": 8, "size": "d10"}}

Any action, reaction, or GM roll with advantage

Add "advantageState": "advantage" to the argument

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. advantageState only 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 ".

Did this answer your question?