update-actor

Previous value: -"Armor class."New value: +"Armor class (dnd5e 6.0 model): override = fixed AC; natural = natural armor; calcs / formulas = what the sheet may calculate from."

Previous value: -"AC calculation: flat, natural, default, mage, draconic, unarmoredMonk, ..."New value: +"DEPRECATED dnd5e 5.x alias, still translated: \"flat\" (+flat → override), \"natural\" (+flat), \"default\" (reset calcs), \"custom\" (+formula), or a calcs key. Prefer the fields above."

Added value: +{
+  "description": "Base calculations the actor QUALIFIES for — the sheet uses the best: unarmored (10 + DEX), armored (worn armor), mage, draconic, unarmoredMonk, unarmoredBarb, unarmoredBard, natural. Replaces the list; default is [\"unarmored\",\"armored\"].",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Previous value: -"Flat AC value (used by calc \"flat\" / \"natural\")."New value: +"DEPRECATED 5.x alias — see calc."

Added value: +"DEPRECATED 5.x alias — see calc."

Added value: +{
+  "description": "Custom AC formulas, e.g. [{formula:\"13 + @abilities.dex.mod\", label:\"Mage Armor\"}]; armored/shielded = only qualifies when (not) wearing armor / a shield. Replaces the list.",
+  "items": {
+    "properties": {
+      "armored": {
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "formula": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "label": {
+        "type": "string"
+      },
+      "shielded": {
+        "type": [
+          "boolean",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "formula"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Natural armor: AC = this value (+ shield, bonuses, cover). Sets calcs to [\"natural\"] and clears any override.",
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "anyOf": [
+    {
+      "minimum": 0,
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "FIXED AC that replaces every calculation (a stat block \"AC 17\"; armor/shield no longer matter). null clears it so the calculations apply again."
+}

Previous value: -"Movement speeds (in the given units, default feet)."New value: +"Movement speeds (in the given units, default feet). Stored under movement.speeds.*."

Added value: +{
+  "minimum": 0,
+  "type": "number"
+}

Previous value: -"Source metadata (book / page / rules edition)."New value: +"[NPC] Source metadata (book / page / rules edition) — system.source."

Added value: +{
+  "description": "[NPC] Spellcasting configuration — caster level and/or casting ability. PCs derive both from their class advancement, so this group is skipped with a warning on a player character.",
+  "properties": {
+    "ability": {
+      "anyOf": [
+        {
+          "enum": [
+            "str",
+            "dex",
+            "con",
+            "int",
+            "wis",
+            "cha"
+          ],
+          "type": "string"
+        },
+        {
+          "const": "",
+          "type": "string"
+        }
+      ],
+      "description": "Casting ability (system.attributes.spellcasting) — drives spell save DC (8 + prof + mod) and spell attack bonus. \"\" clears it. A caster left unset computes off a +0 modifier, so an INT 16 mage reads DC 10 instead of DC 13 until this is set."
+    },
+    "level": {
+      "description": "Caster level — the NPC sheet's \"Spellcasting Level\" (system.attributes.spell.level). This is what DERIVES the spell-slot pools: leave it 0 and the sheet shows slots as \"4/0\" and a long rest restores them to nothing. 0 = not a slot caster (the 2024-MM default, where monsters use 1/Day free casts instead of slots — see add-free-cast).",
+      "maximum": 20,
+      "minimum": 0,
+      "type": "integer"
+    }
+  },
+  "type": "object"
+}

Added value: +{
+  "description": "Prototype-token RESOURCE-BAR (HP) visibility — the default for dropped tokens, same modes as tokenDisplayName. Set \"none\" to hide the health bar on background / window-dressing NPCs.",
+  "enum": [
+    "none",
+    "control",
+    "owner-hover",
+    "hover",
+    "owner",
+    "always"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Prototype-token NAMEPLATE visibility — the default for tokens dragged from this actor: none (never) · control (only when selected) · owner-hover · hover (anyone hovering) · owner (always, to owners) · always (always, to everyone). Same modes as update-token for placed tokens; set \"none\" for window-dressing NPCs that should show no name.",
+  "enum": [
+    "none",
+    "control",
+    "owner-hover",
+    "hover",
+    "owner",
+    "always"
+  ],
+  "type": "string"
+}

Removed value: -{
-  "description": "Free-text custom entry stored alongside the set (replaces the existing custom string).",
-  "type": "string"
-}

Added value: +{
+  "description": "[PC] 2024 Weapon Mastery selections — the kinds of weapons whose mastery property the character can use (system.traits.weaponProf.mastery). Swappable on a Long Rest per the class feature; the count allowed is the class's business (fighter 3, paladin/ranger 2 at low levels) — the tool does not enforce it.",
+  "properties": {
+    "mode": {
+      "default": "replace",
+      "description": "replace (default) overwrites the whole list; add/remove merge with the current list.",
+      "enum": [
+        "replace",
+        "add",
+        "remove"
+      ],
+      "type": "string"
+    },
+    "values": {
+      "default": [],
+      "description": "Base weapon KINDS (\"greatsword\", \"longbow\", \"handcrossbow\", ...) — NOT mastery names: each weapon carries its own mastery property (vex/topple/graze/...), the actor just unlocks it per kind.",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    }
+  },
+  "type": "object"
+}

Previous value: -"Name or id of the actor to edit (partial name match supported)."New value: +"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."

Added value: +{
+  "description": "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.",
+  "enum": [
+    "hostile",
+    "neutral",
+    "friendly",
+    "secret"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "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.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "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.",
+  "minLength": 1,
+  "type": "string"
+}

Added value: +{
+  "description": "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).",
+  "type": "boolean"
+}

Added value: +{
+  "description": "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.)",
+  "type": "number"
+}

Added value: +{
+  "description": "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).",
+  "exclusiveMinimum": 0,
+  "type": "number"
+}