mc-unequip_skill

Overview

This skill clears or swaps the equipped item in Minecraft from the selected hand slot and returns a clear success/failure result. It moves the item back into inventory when possible and reports whether the operation succeeded. The default target is the main hand when no slot is specified.

How this skill works

The skill inspects the specified slot ("hand" or "offhand") and attempts to remove the item there. If an item is present it moves the item into the player inventory and sets success=true in the structured output. If the slot is already empty or the inventory cannot accept the item, the operation fails and returns success=false with a brief message.

When to use it

• Prepare to equip a different tool or weapon
• Automate inventory management scripts
• Clear offhand items before performing an action that requires an empty offhand
• Run safety checks before using commands that assume an empty hand

Best practices

• Specify "hand" or "offhand" explicitly when automation depends on a particular slot
• Check the returned success boolean before proceeding with follow-up actions
• Use this skill prior to equipping items to avoid inventory conflicts
• Handle failure cases by notifying the player or retrying after freeing inventory space

Example use cases

• Unequip main hand before equipping a different tool in an automated routine
• Clear offhand to ensure a free slot for shields or consumables
• Confirm unequip success in a macro before running a crafting or building sequence
• Integrate into scripts that maintain tidy inventories for farming or combat runs