mc-observe

Fetch blocks, entities, and navigation surface data from a Minecraft world in one API call.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, local_grid, nav_core, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a unified and efficient way to gather comprehensive information about the Minecraft world, including blocks, entities, and navigation data, in a single operation.

Core Features & Use Cases

  • Comprehensive World Scan: Fetches blocks, entities (items, mobs, players), and navigation surfaces simultaneously.
  • Efficiency: Reduces network calls compared to fetching each data type separately.
  • Map Building & Awareness: Ideal for agents that need to build maps, understand their surroundings, or track entities.
  • Use Case: An agent needs to build a detailed map of its surroundings. It uses mc-observe with a radius of 5 to get a complete picture of blocks, identify nearby mobs, and locate any dropped items.

Quick Start

Use the mc-observe skill to observe the world within a radius of 5 blocks.

Frequently Asked Questions about mc-observe

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

FAQPage Schema
How do I fetch Minecraft world state including blocks and entities in one call?

To fetch Minecraft world state efficiently, use a single API call to an `/observe` endpoint that simultaneously retrieves block data, entity locations, and navigation surfaces. This unified observation method eliminates the need for separate network requests for each data type.

What do I need to observe a Minecraft world for map-building tasks?

Observing a Minecraft world for map-building requires a running Minecraft bridge with an active `/observe` endpoint. You specify a radius around the agent to receive structured data on surrounding blocks, nearby mobs, dropped items, and the agent's current pose.

Can I get navigation surface data and entity positions at the same time?

Yes, you can get navigation surface data and entity positions simultaneously. The observation process queries blocks, entities like items and mobs, and navigation surfaces together in a single operation, providing a complete environmental picture for pathfinding and awareness.

What is the best way to reduce network calls when scanning a Minecraft environment?

The best way to reduce network calls when scanning a Minecraft environment is to use a unified observation endpoint. By fetching blocks, entities, and navigation data in one request rather than querying each category separately, you significantly cut down network overhead.

Does this world observation approach work without a local grid dependency?

No, this world observation approach relies on specific dependencies including `local_grid` and `nav_core` to process spatial data. Alongside a running Minecraft bridge exposing an `/observe` endpoint, these components are required to structure the fetched blocks and navigation surfaces.