mc-attack_skill

Overview

This skill performs a left-click style interaction in Minecraft to attack entities or strike/break blocks. It returns a uniform success/failure result with a human-readable message and machine-readable data indicating whether the interaction succeeded.

How this skill works

You specify a single target mode: either an entity_id to attack a mob/player or world-relative coordinates (dx, dy, dz) to hit a block. The skill executes a left-click interaction at the target and returns a structured result with a boolean success flag and a short text summary. Block breaking speed depends on tool appropriateness and may require repeated attacks.

When to use it

• Engaging a specific mob or player by ID for combat or crowd control.
• Attempting to break or hit a block at a relative position from the agent.
• Automating simple combat routines in scripts or task flows.
• Triggering left-click interactions that require repeated hits (e.g., mining).
• Testing attack mechanics or validating reach and targeting logic.

Best practices

• Provide exactly one targeting mode: either entity_id or dx/dy/dz coordinates.
• Use entity_id when you need to target a specific mob or player reliably.
• Use dx, dy, dz for world-relative block targeting; consult the environment coordinate system.
• Equip an appropriate tool before attacking blocks to improve breaking speed.
• Allow for multiple attack calls when targeting high-health entities or hard blocks.

Example use cases

• Attack a zombie by ID: target {"entity_id":"zombie_123"} to perform a left-click attack.
• Break a block one block south: target {"dx":0,"dy":0,"dz":1} to strike the block.
• In a combat loop, check success flag and repeat attack until the entity is defeated.
• Automation script that mines multiple adjacent blocks by issuing sequential block targets.