Updated example to match player-only, no-target limitation using a sudoskill... authored by Brickgard's avatar Brickgard
Updated example to match player-only, no-target limitation using a sudoskill and recommend consumeslot mechanic instead, added links.
## Description
Removes the given amount from the casting player's held item.
> **This is a no-target mechanic, and the affected entity will always be the caster**
> **This is a no-target mechanic, and the affected player will always be the caster**
<details><summary>Easier Alternative:</summary>
The [consumeslot](skills/mechanics/consumeslot) mechanic is likely an easier choice for most use-cases, since it can target entities directly and choose which slot to remove from.
</details>
## Attributes
| Attribute | Aliases | Description | Default |
......@@ -10,11 +14,22 @@ Removes the given amount from the casting player's held item.
## Examples
As a skill that only targets the casting player, a mob may need to use a [sudoskill](skills/mechanics/sudoskill) to remove the player's item:
```yaml
munchy:
Type: PIG
Skills:
- SudoSkill{s=removeApple} @trigger ~onInteract
```
This will cause a player to cast the `removeApple` meta-skill when right-clicking the mob:
```yaml
ExampleSkill:
removeApple:
Conditions:
- holding{m=APPLE} true
Skills:
- removeHeldItem{amount=1} @trigger
- removeHeldItem{amount=1}
```
This example checks for if the player (now the caster) is holding an apple, and if so, remove 1 from their hand.
## Aliases
......
......