mc-use_skill

Overview

This skill performs a right-click style interaction using the agent's currently equipped item. It attempts to activate blocks, use tools, or interact with world objects at a specified world-relative position. The result reports success or failure both as a human-readable value and a structured data object.

How this skill works

Provide world-relative offsets dx, dy, dz to target the block or entity within reach. The skill uses whatever is equipped in the agent's hand and returns a uniform_return containing a text summary and a data dict with a boolean success field. The action fails if nothing is equipped, the item is not usable at the target, or the position is out of reach.

When to use it

• Activate a block (doors, buttons, levers, furnaces) that requires a right-click.
• Use a tool action such as right-clicking with a flint-and-steel, bucket, or shears.
• Interact with entities or item containers at a nearby position.
• Trigger block-specific behavior (e.g., place liquids from a bucket) without changing inventory state.
• Test whether a particular interaction is permitted at a location (reach and item validity).

Best practices

• Equip the correct item first using mc-equip to avoid predictable failures.
• Check inventory with mc-inventory to confirm item presence before calling this skill.
• Compute target coordinates in world-relative dx, dy, dz using the environment's coordinate system.
• Keep target positions within reach to prevent automatic failure.
• Interpret both the human-readable value and the data.success boolean for robust logic.

Example use cases

• Right-click the block directly east to open a door: dx=1, dy=0, dz=0.
• Use a bucket on the block below to place or pick up liquid: dx=0, dy=-1, dz=0.
• Activate a furnace or chest in front of the agent to open its UI.
• Attempt to shear a nearby sheep or use shears on foliage within reach.
• Test whether a button at a target position can be pressed with the equipped item.