mcp-minecraft

Instructions

Implementation Reference

• src/tools/block-tools.ts:133-154 (handler)

  The handler function for the 'find-block' tool. It resolves the block type ID from minecraft-data, uses bot.findBlock to locate the nearest matching block within maxDistance, and returns the position if found.

  async ({ blockType, maxDistance = 16 }) => {
    const bot = getBot();
    const mcData = minecraftData(bot.version);
    const blocksByName = mcData.blocksByName;
  
    if (!blocksByName[blockType]) {
      return factory.createResponse(`Unknown block type: ${blockType}`);
    }
  
    const blockId = blocksByName[blockType].id;
  
    const block = bot.findBlock({
      matching: blockId,
      maxDistance: maxDistance
    });
  
    if (!block) {
      return factory.createResponse(`No ${blockType} found within ${maxDistance} blocks`);
    }
  
    return factory.createResponse(`Found ${blockType} at position (${block.position.x}, ${block.position.y}, ${block.position.z})`);
  }

• src/tools/block-tools.ts:129-132 (schema)

  Zod schema for 'find-block' tool inputs: required blockType (string) and optional maxDistance (number).

  {
    blockType: z.string().describe("Type of block to find"),
    maxDistance: z.number().optional().describe("Maximum search distance (default: 16)")
  },

• src/tools/block-tools.ts:126-155 (registration)

  Registration of the 'find-block' tool in the ToolFactory, including name, description, schema, and handler.

  factory.registerTool(
    "find-block",
    "Find the nearest block of a specific type",
    {
      blockType: z.string().describe("Type of block to find"),
      maxDistance: z.number().optional().describe("Maximum search distance (default: 16)")
    },
    async ({ blockType, maxDistance = 16 }) => {
      const bot = getBot();
      const mcData = minecraftData(bot.version);
      const blocksByName = mcData.blocksByName;
  
      if (!blocksByName[blockType]) {
        return factory.createResponse(`Unknown block type: ${blockType}`);
      }
  
      const blockId = blocksByName[blockType].id;
  
      const block = bot.findBlock({
        matching: blockId,
        maxDistance: maxDistance
      });
  
      if (!block) {
        return factory.createResponse(`No ${blockType} found within ${maxDistance} blocks`);
      }
  
      return factory.createResponse(`Found ${blockType} at position (${block.position.x}, ${block.position.y}, ${block.position.z})`);
    }
  );