mc-map-query

Query a cell-based SpatialMap for coverage, reachability, safety, and resource presence.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill allows an agent to query its persistent spatial memory of the Minecraft environment, enabling informed decision-making for planning, navigation, and resource management.

Core Features & Use Cases

  • Spatial Analysis: Understand the environment by querying for unobserved areas, reachable locations, hazards, and resource distribution.
  • Navigation & Planning: Find safe paths, identify potential waypoints, and assess risks like drops or blockages.
  • Resource Discovery: Locate specific resources like wood or ore, or even dropped items.
  • Use Case: An agent needs to find a safe path to a nearby cave entrance. It can use cells-candidate-waypoints combined with cells-safe-to-stand to identify suitable intermediate points.

Quick Start

Use the mc-map-query skill to find all walkable cells within a radius of 20 blocks around the current position.

Frequently Asked Questions about mc-map-query

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

FAQPage Schema
How do I query spatial memory in Minecraft to find safe paths and resources?

Spatial memory querying in Minecraft is done by analyzing a cell-based SpatialMap to extract strategic information like coverage, reachability, safety, and resource presence using specific query types and parameters.

Can I use a spatial query to locate specific resources like wood or ore in a Minecraft environment?

Yes, spatial queries can locate specific resources like wood, ore, and dropped items by analyzing the agent's persistent spatial memory to identify resource distribution and presence within the environment.

What's the best way to find candidate waypoints and safe standing locations for Minecraft pathfinding?

Minecraft pathfinding waypoints are found by combining the cells-candidate-waypoints query with cells-safe-to-stand to identify suitable, hazard-free intermediate points for navigation and planning.

Does querying an agent's spatial map require its current position for calculations?

Yes, relative spatial calculations require access to the agent's current position, alongside its persistent spatial memory, to accurately assess environmental coverage and reachability.

What types of environment analysis can I perform with a cell-based Minecraft spatial query?

Cell-based Minecraft spatial queries support environment analysis including identifying unobserved areas, reachable locations, hazards like drops or blockages, and resource distribution for informed decision-making.

When should I not use a spatial map query for Minecraft navigation?

Spatial map queries are not suitable when the agent lacks persistent spatial memory of the environment, as the skill requires existing cell-based map data to perform coverage, reachability, and safety analysis.