mcp-minecraft

Instructions

Implementation Reference

• src/tools/block-tools.ts:86-102 (handler)

  Handler function for the 'dig-block' tool. It retrieves the bot, checks for a block at the given coordinates, navigates if necessary, digs the block, and returns a success message.

  async ({ x, y, z }) => {
    const bot = getBot();
    const blockPos = new Vec3(x, y, z);
    const block = bot.blockAt(blockPos);
  
    if (!block || block.name === 'air') {
      return factory.createResponse(`No block found at position (${x}, ${y}, ${z})`);
    }
  
    if (!bot.canDigBlock(block) || !bot.canSeeBlock(block)) {
      const goal = new goals.GoalNear(x, y, z, 2);
      await bot.pathfinder.goto(goal);
    }
  
    await bot.dig(block);
    return factory.createResponse(`Dug ${block.name} at (${x}, ${y}, ${z})`);
  }

• src/tools/block-tools.ts:81-85 (schema)

  Zod input schema for 'dig-block' tool defining required numeric parameters x, y, z coordinates.

  {
    x: z.number().describe("X coordinate"),
    y: z.number().describe("Y coordinate"),
    z: z.number().describe("Z coordinate"),
  },

• src/tools/block-tools.ts:78-103 (registration)

  Registration of the 'dig-block' tool using ToolFactory.registerTool, including name, description, schema, and inline handler function.

  factory.registerTool(
    "dig-block",
    "Dig a block at the specified position",
    {
      x: z.number().describe("X coordinate"),
      y: z.number().describe("Y coordinate"),
      z: z.number().describe("Z coordinate"),
    },
    async ({ x, y, z }) => {
      const bot = getBot();
      const blockPos = new Vec3(x, y, z);
      const block = bot.blockAt(blockPos);
  
      if (!block || block.name === 'air') {
        return factory.createResponse(`No block found at position (${x}, ${y}, ${z})`);
      }
  
      if (!bot.canDigBlock(block) || !bot.canSeeBlock(block)) {
        const goal = new goals.GoalNear(x, y, z, 2);
        await bot.pathfinder.goto(goal);
      }
  
      await bot.dig(block);
      return factory.createResponse(`Dug ${block.name} at (${x}, ${y}, ${z})`);
    }
  );