update-actor
Edit stat-block fields of existing D&D 5e actors, covering identity, details, abilities, vitals, movement, senses, defenses, resources, and currency.
Instructions
[D&D 5e only] Edit an EXISTING actor's own stat-block fields. Supply only the groups you want to change: • identity + prototype token — name, tokenName (prototype nameplate ≠ actor name), img, disposition (friend/foe), tokenAutoRotate (face movement / lockRotation), tokenRing (dynamic ring), tokenScale (art size), tokenRotation (facing) — the PROTOTYPE-token editor. (elevation / hidden / x / y are placement-only: edit those on a dropped token with update-token) • details — size, cr*, creatureType*, creatureSubtype*, swarmSize*, alignment, biography, source • abilities — abilities.{str..cha}, savingThrows (replace), skills (merge; proficiency none/proficient/expert) • vitals — hp, ac, initiative • movement, senses • defenses — damageImmunities / damageResistances / damageVulnerabilities / conditionImmunities / languages (each {mode: replace|add|remove, values, custom?}), telepathy • resources* — legendaryActions, legendaryResistances, lair • 2024* — habitat, treasure • currency — coins {mode: set|add, pp, gp, ep, sp, cp} (carried money)
Fields marked * are NPC-only (skipped with a warning on player characters). This authors the stat block; it does NOT edit embedded items (use update-actor-item / add-feature / manage-activity) or run combat. Use list-actors or get-actor to find the actorIdentifier.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ac | No | Armor class. | |
| cr | No | [NPC] Challenge rating (0.125 / 0.25 / 0.5 allowed). | |
| hp | No | Hit points (value / max / temp / tempmax / formula). | |
| img | No | Portrait image path or URL. | |
| lair | No | [NPC] Lair actions — sets the lair initiative count (marks the creature as having a lair). | |
| name | No | Rename the actor. | |
| size | No | Creature size (long name or short code). | |
| senses | No | Senses ranges (feet) plus special-sense free text. | |
| skills | No | Set skill proficiencies — merge: only the listed skills change. | |
| source | No | Source metadata (book / page / rules edition). | |
| habitat | No | [NPC, 2024] Habitats (replace the whole list), e.g. [{type:"forest"},{type:"planar",subtype:"nine hells"}]. | |
| currency | No | Carried coins (pp/gp/ep/sp/cp). Only the coins you list change. | |
| movement | No | Movement speeds (in the given units, default feet). | |
| treasure | No | ||
| abilities | No | Ability scores to set — only the abilities you list change. | |
| alignment | No | Alignment free text (e.g. "Lawful Evil"). | |
| biography | No | Biography / description (HTML). | |
| languages | No | ||
| swarmSize | No | [NPC] Swarm member size, or "" if the creature is not a swarm. | |
| telepathy | No | Telepathy range (0 = none). | |
| tokenName | No | Prototype-token nameplate, decoupled from the actor name — e.g. actor "Morgash the Gravemaker" whose dropped tokens read just "Morgash". A plain `name` rename keeps the two in lockstep; pass tokenName (alone or alongside name) to make them differ. Placed tokens keep their own name — retitle those with update-token. | |
| tokenRing | No | Prototype-token dynamic ring: false = plain token (the house default; new creations already get it), true = re-enable the ring (its colors/subject config is preserved). | |
| initiative | No | Initiative bonus and/or ability override. | |
| tokenScale | No | Prototype-token art scale — the "Scale (Ratio)" slider on the token Appearance tab (sets texture.scaleX and scaleY together). 1 = normal, 1.5 = 50% larger, 2 = double. Scales only the art within the token's grid footprint; it does NOT change the token's size (grid spaces). | |
| disposition | No | Prototype-token disposition (friend vs foe). Set 'friendly' to mark an NPC an ally (e.g. a freed captive), 'hostile' for an enemy, 'neutral' for a bystander. | |
| creatureType | No | [NPC] Creature type: aberration, beast, celestial, construct, dragon, elemental, fey, fiend, giant, humanoid, monstrosity, ooze, plant, undead. | |
| savingThrows | No | Replace the proficient saving throws: the listed abilities become proficient, all others non-proficient. | |
| tokenRotation | No | Prototype-token facing in degrees (0–359) — the default angle a dropped token faces. Same behavior as update-token for placed tokens: a lock-rotation prototype (tokenAutoRotate false) HIDES the angle, so setting a rotation without also setting tokenAutoRotate AUTO-UNLOCKS rotation (and warns) so the facing shows. (elevation / hidden / x / y are PLACEMENT-only — a prototype has no such fields; set those on a dropped token with update-token.) | |
| actorIdentifier | Yes | Name or id of the actor to edit (partial name match supported). Also accepts a placed TOKEN id (from list-tokens): the edit then lands on that token INSTANCE's own actor (its delta), not the base actor — the way to edit ONE placed copy of an unlinked NPC, since base-actor edits never reach tokens already on a scene. | |
| creatureSubtype | No | [NPC] Creature subtype free text (e.g. "Devil"). | |
| tokenAutoRotate | No | Prototype-token auto-rotation: true = the token turns to face its movement (lockRotation off — the house default; new creations already get it), false = fixed facing. | |
| damageImmunities | No | ||
| legendaryActions | No | [NPC] Legendary action points per round (resources.legact.max). | |
| damageResistances | No | ||
| conditionImmunities | No | ||
| legendaryResistances | No | [NPC] Legendary resistance uses per day (resources.legres.max). | |
| damageVulnerabilities | No |