manage-activity
Manage rollable activities on D&D 5e items—add, edit, remove, or list attacks, damage, saves, heals, checks, utility, and linked spell casts. Author activities without running combat.
Instructions
[D&D 5e only] Add / edit / remove / list Activities on an item — the rollable things (attack, damage, save, heal, check, utility, cast). Target an item on an actor (set actorIdentifier) or a world item (omit it). This authors actions like a Multiattack (action="add", type="utility", name="Multiattack"), a heal, an ability-check, a saving-throw activity, OR a spell-casting item (action="add", type="cast", spellUuid=…, charges=…, saveDC/attackBonus=… to pin a fixed challenge) — the cast LINKS a real compendium spell so its measured template + save/attack fire for free. Use action="list" (or get-actor-entity) to find activityIds, then edit/remove by id; edit takes a patch of dot-paths relative to the activity. Authoring only — it does not run combat.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Activity name (e.g. "Multiattack"). Used by add and edit (rename). | |
| type | No | Activity type. Required for add. "utility" = descriptive action (e.g. Multiattack). "cast" = link & cast a real compendium spell (e.g. a wand/staff) — see spellUuid. | |
| patch | No | Edit: dot-paths RELATIVE to the activity root, e.g. {"attack.bonus":"3"}, {"save.dc.formula":"16"}, {"damage.onSave":"half"}. | |
| action | Yes | add a new activity, edit/remove an existing one (by activityId), or list activities. | |
| onSave | No | Save activity: damage on a successful save. | |
| saveDC | No | Save activity: the DC. Cast activity: pins a FIXED save DC for the linked spell (else the cast defers the DC to the casting actor). | |
| skills | No | Check activity: associated skill keys (e.g. ["acr","ath"]). | |
| ability | No | Attack ability override (attack activity). | |
| charges | No | Cast activity: item charges (uses) consumed per cast. Omit for an at-will cast. | |
| checkDC | No | Check activity: the DC. | |
| castLevel | No | Cast activity: level to cast at (0 = cantrip). Defaults to the spell's base level. | |
| spellUuid | No | Cast activity (REQUIRED): the Compendium uuid of the spell to LINK, e.g. "Compendium.dnd-players-handbook.spells.Item.phbsplFireball00". The activity CASTS this spell — its measured template (fireball sphere, lightning line…), save/attack, and effects come for free. The spell must be a real premium-book spell (off-book/SRD is refused — if it is not in the books, STOP and ASK; do not hand-roll a fake save/damage activity). | |
| activityId | No | Activity id — required for edit/remove. Get it from action "list" or get-actor-entity. | |
| attackType | No | Attack activity: melee or ranged. | |
| healAmount | No | Heal activity: healing dice (type "healing" or "temphp"). | |
| attackBonus | No | Attack activity: flat to-hit bonus. Cast activity: pins a FIXED spell-attack bonus (else the cast defers the attack to the casting actor). | |
| damageParts | No | Damage dice — for attack (extra parts), damage, and save activities. | |
| includeBase | No | Attack: also roll the item base damage (default true). | |
| saveAbility | No | Save activity: the saving-throw ability. | |
| checkAbility | No | Check activity: the ability rolled. | |
| activationType | No | Action economy. Default "action". | |
| itemIdentifier | Yes | Item to operate on (id or name). On an actor when actorIdentifier is set, else a world item. | |
| actorIdentifier | No | If set, the item is embedded on this actor; omit to target a world (sidebar) item. Also accepts a placed TOKEN id (from list-tokens) — the activity edit then lands on that token INSTANCE's own delta, not the base actor. |