update-actor-item
Edit an embedded item on a D&D 5e actor by applying dot-path patches, deleting keys, or changing name and image. Ideal for low-level item modifications.
Instructions
[D&D 5e] Edit an item embedded on an actor (weapon / feature / spell / equipment). Apply a dot-path patch (values applied as-is; arrays/Sets replace whole) and/or deletePaths (remove keys, e.g. an activity by id), and/or change name/img. This is the low-level item editor — to add/edit/remove activities (attacks, saves, heals, etc.) prefer manage-activity, which knows the shapes. Use get-actor or get-actor-entity to find the item and the exact paths/ids to change.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| img | No | Item image path or URL. | |
| name | No | Rename the item. | |
| type | No | Optional item type to disambiguate the lookup (e.g. "weapon", "feat", "spell"). | |
| patch | No | Map of Foundry dot-path -> value, applied as-is. Examples: {"system.damage.base.number": 3}, {"system.damage.base.types": ["fire"]} (arrays REPLACE whole), {"system.activities.<id>.attack.bonus": "2"}, {"system.equipped": true}, {"system.description.value": "<p>...</p>"}. | |
| deletePaths | No | Dot-paths to delete from the item, e.g. "system.activities.<id>" to remove an activity. Converted to the Foundry "-=" deletion form for you. | |
| itemIdentifier | Yes | Name or id of the embedded item to edit (id, exact name, then substring). | |
| actorIdentifier | Yes | Name or id of the actor that owns the item (partial name match supported). Also accepts a placed TOKEN id (from list-tokens): the edit then lands on that token INSTANCE's own delta, not the base actor — the way to re-gear ONE placed copy of an unlinked NPC (base-actor edits never reach tokens already on a scene). |