Removehelditem

Description

Removes the given amount from the casting player's held item.

This is a no-target mechanic, and the affected player will always be the caster

Attributes

Attribute Aliases Description Default
amount a The amount to remove 1

Examples

As a skill that only targets the casting player, a mob may need to use a sudoskill to remove the player's item:

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:

removeApple:
  Conditions:
  - holding{m=APPLE} true
  Skills:
  - 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

  • consumeHeldItem
  • takeHeldItem
Updated Aug 19, 2026