mc-dig

Remove a Minecraft block at agent-relative coordinates via HTTP.

10|Updated Jul 22, 2025
One-click install
npx skills add https://github.com/bdambrosio/Cognitive_workbench --skill mc-dig
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mc-dig
Source: https://github.com/bdambrosio/Cognitive_workbench/tree/main/src/world-tools/minecraft/mc-dig
Command: npx skills add https://github.com/bdambrosio/Cognitive_workbench --skill mc-dig

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires logging, os, requests, sys, time, pathlib, typing, local_grid, nav_core, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill allows an agent to remove blocks from the Minecraft world, enabling terrain modification and resource gathering.

Core Features & Use Cases

  • Block Removal: Destroys a specified block at agent-relative coordinates.
  • Synchronous Operation: Waits for the digging action to complete or time out.
  • Spatial Map Update: Automatically updates the persistent spatial map after a successful dig.
  • Use Case: An agent needs to clear an area for building or mine a specific ore. This tool enables that direct interaction with the game world.

Quick Start

Use the mc-dig skill to remove the block directly in front of the agent.

Frequently Asked Questions about mc-dig

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I remove a block in Minecraft using agent-relative coordinates?

The tool removes a block in Minecraft by targeting agent-relative coordinates (dx, dy, dz). It converts these to absolute coordinates and sends an HTTP request to the Minecraft bot server to destroy the targeted block.

How does an agent update its spatial map after digging blocks in Minecraft?

After digging blocks in Minecraft, the tool automatically updates the persistent spatial map. This ensures the agent's local grid accurately reflects the newly removed terrain for subsequent navigation and building.

Does the Minecraft digging tool wait for the block removal to finish?

Yes, the Minecraft block removal operation is synchronous. It waits for the digging action to complete or time out before returning control, ensuring the agent knows the exact state of the world.

What do I need to interact with a Minecraft bot server for terrain modification?

To interact with a Minecraft bot server for terrain modification, you need a running server accessible via HTTP requests. The tool uses this connection to send coordinate data and execute block removal commands.

What happens if a Minecraft block removal request times out?

If a Minecraft block removal request times out, the synchronous operation stops waiting. The tool handles the timeout gracefully, though the spatial map update only occurs after a successful dig completion.