Skip to content

Item Activations & Effects ​

An activation is everything that happens when a player clicks an item: what it costs, what it targets, what it rolls, and what shows up on the chat card. This is the most powerful part of the item sheet, so this page teaches it through two builds:

  • Frostbrand Dagger: a weapon that deals 1d4 + Dexterity piercing damage and, only on a hit, an extra 1d6 cold damage.
  • Ghostwalk Draught: a potion that heals 1d4 + 2 and turns the drinker Invisible.

The Activation tab appears on objects, spells, features, and monster features, and is split into three sub-tabs: Core, Targets, and Effects.

The Activation tab of an item with the Core / Targets / Effects sub-tab bar visible

The Core sub-tab ​

  • Output item description on activation: when ticked, the item's description text is printed on the chat card.
  • Activation Cost is a number plus a unit: Action, Minute, Hour, None, Special, or Turn. The number field only appears for actions, minutes, and hours. Choosing Special reveals a free-text details field.
  • Is Reaction marks the activation as a reaction and reveals a Reaction Trigger text field ("when an enemy leaves your reach…").
  • Duration: a number plus a unit (Action, Minute, Hour, None, Round, Turn, Special), with a details field for special durations.

Monster features are simpler

Monster feature sheets hide the Activation Cost section. A monster's action economy is handled on the monster side instead. Their Targets sub-tab gains extra fields; see below.

The Targets sub-tab ​

  • AoE targeting (can't miss or crit): tick this for area effects. A template configuration appears where you pick a shape (circle, cone, emanation, line, or square) and its dimensions. Attacks resolved through a template share one roll across everyone caught in it, so they can neither miss nor critically hit.
  • Target Count: how many targets the item expects (hidden when AoE targeting is on).
  • Target Restrictions: free text shown to the user, such as "creatures that can hear you".

On monster features only, an Attack Type dropdown (None / Reach / Range) and a Distance field describe the attack's reach for the stat block.

The Effects sub-tab: the effect tree ​

Effects are built as a tree. Click the + button next to Effects to add a top-level entry: Damage, Healing, Condition, Move, Pool, or Save. Damage and Save entries can then hold child effects that trigger on specific outcomes.

Damage ​

A damage entry has a Roll Formula (dice plus references like @strength or @key), a Damage Type (fire, slashing, and so on), and a Target Disposition dropdown (Any / Friendly / Neutral / Hostile / Secret) that tells the chat card who the roll is meant for. Any means no preference: the Apply Damage button gets no hint about the targets. Picking Any is still a choice, so the entry keeps its own box on the chat card even when nothing else shows its roll. Leave the dropdown alone and a damage entry with no outcome child under On Hit shows on a miss only. Three checkboxes refine it: Ignore Armor, Only Damage Hostile Actors, and Roll Damage From Card.

Roll Damage From Card is for damage that lands on a later trigger than the activation itself, such as a trap that springs on the next creature to step adjacent. The card posts with the damage unrolled and shows a Roll Damage button in its place; the message author and the GM can press it, and the result then behaves like any other damage packet. It appears on top-level damage entries only, because damage nested under an outcome already waits on that outcome. Can Miss and Can Crit still apply to the deferred roll.

The first damage entry in the list is special: it is the attack roll. It alone shows the Can Miss and Can Crit checkboxes, and its result decides whether the whole card reads as a hit, a miss, or a critical hit.

When crits are suppressed

Even with Can Crit ticked, some attacks never crit: template (AoE) attacks, attacks made by minions and flunkies, and attacks with a weapon whose type the wielder is not proficient with.

Under a damage entry you get three outcome buckets: On Critical Hit, On Hit, and On Miss. Each bucket can hold child effects: more damage, a damage outcome, healing, a condition, a saving throw, or a note.

A critical hit is also a hit, so a crit card shows the children of both On Critical Hit and On Hit. The Damage Outcome is the one exception. If both buckets hold one, only the On Critical Hit outcome applies. Two outcomes would apply the same roll two times.

  • Damage Outcome declares what the parent roll deals in that bucket: Full Damage or Half Damage. The stock longsword, for example, has a Damage Outcome of Full Damage under On Hit. A damage entry nested in a bucket can hold its own Damage Outcome, and the rule is the same at every depth: the roll shows once, through that outcome.
  • Note: a text callout on the chat card with a style of General, Flavor, Reminder, or Warning.

Healing ​

A healing entry has a Roll Formula, a Healing Type (Healing or Temporary Healing), and a Target Disposition. On consumable objects, healing formulas are automatically increased by any healing-potion-bonus rules the drinker has.

Save ​

A save entry prompts a saving throw: pick the Save Type (Strength, Dexterity, Intelligence, or Will) and optionally a Custom Save DC. It has three sections:

  • Shared Rolls: damage that is rolled once and then split by the outcome. Add a damage entry here, then put Damage Outcome entries under On Failed Save (Full Damage) and On Passed Save (Half Damage) for the classic "half on a save" pattern.
  • On Failed Save / On Passed Save are buckets for child effects: damage, healing, conditions, or notes.

Condition ​

A condition entry picks one status condition from the system's list (Frightened, Poisoned, Prone…). It renders as a labeled button on the chat card.

Move ​

A move for free or Forced Movement for a creature. The card watches that creature's next drag: the drag counts as that movement, and the ruler shows how far it can go. There is nothing to click, and nothing stops a longer drag. Choose the Kind (Move for free or Forced Movement), Who Moves (the creature that uses the feature, or the card's targets), and the Distance as a formula against the data of the feature's user: @abilities.strength.mod is their Strength modifier, 2 a fixed number, and @speed the walk speed of the creature that moves (@speed / 2 half of it). The distance is worked out once, when the card is posted. Distance by size can override the formula for a size category (a push that moves Small creatures twice as far, for example). Tick Ignore difficult terrain for a move for free that says so; Forced Movement always ignores it. Show the distance as "up to" sets how the card words the distance. It starts ticked for a move for free ("Can move up to 6 spaces for free.") and clear for Forced Movement ("Pushed 2 spaces away from Grug."), as the rulebooks word them. Tick it for a push or pull whose text says "up to"; clear it for a move for free of a set distance. It changes only the words on the card. The card shows the Direction: away from or toward the feature's user, or in any direction for Forced Movement. It leaves the direction out when only the user moves. A move for free that ignores difficult terrain says so. Nothing enforces the direction, and the rules give a push no particular shape. Placed under On Hit, On Critical Hit or On Miss, the move is on the card only when the card has that outcome; a critical hit is also a hit. The card does not record the saving throw of each target, so under On Failed Save or On Passed Save the card shows the distance for each target, but the drag is not watched. Move the token by hand when the save calls for it. With the Forced Movement and Moves for Free automation toggle off, the card shows the distance as text and the token is dragged as usual. See Running Combat.

Pool ​

An advanced entry that manipulates a dice pool or charge pool when the item activates: pick the Pool Type (Dice Pool or Charge Pool) and an Action (Roll Die, Roll Pool, Fill Count, Clear, or Maximize Lowest Die), plus the pool's identifier and a value. The Predicate (JSON) field lets the entry apply only when a condition test passes, using the same syntax as the Condition box, for example { "level": { "min": 5 } }. Pools themselves are created with rules; see the resources reference.

Maximize Lowest Die raises the lowest Value dice in a dice pool to the die's highest face, and reports on the card when there was nothing to raise (an empty pool, or every die already at maximum). It acts on its own with no player input, which suits a feature that always maximizes. When the rules text lets the player choose which die, use a Dice Consumer rule with its selection outcome set to maximize instead: that opens the dice panel and lets them pick. See the resources reference.

Pool entries only take effect once the activation is allowed to proceed, so an item gated by a charge that has run out changes nothing.

Build A: the Frostbrand Dagger ​

  1. Create an Object, set Object Type to Weapon, and pick your weapon properties.
  2. On Activation → Core, set the cost to 1 Action.
  3. On Activation → Effects, add a Damage entry: formula 1d4+@dexterity, type Piercing, Can Miss and Can Crit ticked.
  4. Under that entry's On Hit bucket, click + and add a Damage Outcome of Full Damage. This is the weapon's own damage landing.
  5. In the same On Hit bucket, add a second Damage entry: formula 1d6, type Cold.

The placement is the point: because the cold damage sits under On Hit, it only appears on the chat card when the attack hits. If you instead added it as a second top-level entry (like the Flaming Longsword on the items page), it would be rolled and shown regardless of the attack outcome.

The effect tree for the Frostbrand Dagger, showing the piercing damage node with a Damage Outcome and a cold damage node nested under On Hit

Build B: the Ghostwalk Draught ​

  1. Create an Object and set Object Type to Consumable (size 0.5 slots is the potion convention).
  2. On Activation → Core, set the cost to 1 Action and leave the description output on.
  3. On Activation → Effects, add a Healing entry: formula 1d4+2, type Healing.
  4. Add a top-level Condition entry and pick Invisible.

Because the item has a healing effect, drinking it with no target selected automatically targets the drinker's own token.

What the player sees ​

The roll window. If the activation contains any damage or healing, clicking the item opens a roll window first (spells always get one; see Spells). It offers:

  • a roll mode selector (advantage / disadvantage),
  • an Add to Roll field for one-off bonuses like 2 or 1d4,
  • Set Primary Die Result and Add to Primary Die Result fields, to handle table rulings (see The attack roll window),
  • if the character has spendable dice or charge pools, a section to click individual rolled dice or step charges to add to the roll,
  • a live preview of each damage formula with references filled in,
  • for GMs activating a non-player-character item, a Hide roll checkbox that whispers the card to GMs only,
  • a Roll button.

Holding Alt while clicking the item skips the window and rolls with defaults.

The activation roll window showing roll mode, the Add to Roll field, and the formula preview pills

The chat card. After rolling, a card is posted with:

  • the item's image, name, and (if enabled) description,
  • a targets row: targets you had marked when activating are listed, and buttons let anyone add currently selected or targeted tokens as targets afterwards,
  • each damage roll as a summary line with the total, an expandable breakdown, and an Apply Damage button that applies it to the card's targets (on a miss the roll is still shown but the apply button is disabled; half-damage outcomes halve the total),
  • each healing roll with an Apply Healing button and an undo button after use,
  • each saving throw section with a d20 button that rolls that save for all currently selected tokens, plus its "On Failed Save" / "On Successful Save" contents,
  • each condition as a button that applies the condition to all selected tokens when clicked,
  • any notes, styled by their note type.

A chat card for the Ghostwalk Draught showing the healing roll with Apply Healing and the Invisible condition button

The Macro tab ​

Every item also has a Macro tab where advanced users can attach a script that runs on activation instead of, or alongside, the standard flow. See Macros.

Released under the MIT License.