Use item
use-itemUse an actor's spell, ability, or consumable in Foundry VTT without waiting for GM confirmation. Targets active scene tokens and reports verified results.
Instructions
Start the use of an item of an actor (a spell, an ability, a consumable) in Foundry and return at once, without waiting for a dialog the Gamemaster may have to confirm. Targets are tokens of the active scene; if one cannot be found exactly, nothing is used. The adapter of the game system decides how the item is used and how consume and spellLevel apply; without one the usual item methods are tried, and failing those a plain chat message is posted. The answer says what was verified (targets, whether the use finished) and what was not (consumption).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| consume | No | Let the game system spend uses, resources or slots; true when left out | |
| targets | No | Tokens of the active scene to target, by token id, token name or actor name; "self" is the token of the actor. Leave out to keep the targets the Gamemaster has selected | |
| spellLevel | No | Cast at this higher level, where the game system knows spell levels | |
| itemIdentifier | Yes | Id or exact name of the item on that actor | |
| actorIdentifier | Yes | The actor that uses the item. Id of the actor, its exact name (case does not matter) or the id of one of its tokens |