mc-waypoint_skill

Overview

This skill labels a world coordinate with a named waypoint to support navigation and spatial reasoning. It persists named locations in a SpatialMap so the agent can recall, compare, and plan around key positions. Use it to mark current or offset positions for later queries and routing.

How this skill works

You provide a waypoint name and optional dx, dy, dz offsets relative to the agent; if offsets are omitted the skill queries the agent's current position. The skill stores the waypoint in a SpatialMap cell for the computed world coordinates, creating the cell if needed and allowing multiple names per cell. It returns a human-readable success message and a machine-readable object with the waypoint name, absolute location, and list of waypoints at that cell. The SpatialMap is auto-saved so waypoints persist across sessions.

When to use it

• Mark your base, resource nodes, or points of interest for later navigation
• Annotate a safe exit or entrance while exploring caves or builds
• Save locations to enable path planning or distance comparisons
• Record dynamic locations (e.g., recent loot, portal) for multi-step tasks
• Create consistent labels to share or reference in follow-up actions

Best practices

• Use concise, descriptive names (e.g., Base_Camp, Pit_Exit_1) to avoid ambiguity
• Omit dx/dy/dz to label your current location; use offsets to mark nearby spots
• Re-use existing names only when you intend to update that location
• Group related waypoints with a consistent naming convention for easier queries
• Rely on the returned location data for programmatic routing rather than parsing text

Example use cases

• Create a waypoint 'Base_Camp' at your current coordinates for return navigation
• Label the top of a ravine using dx/dy/dz offsets from your standing position
• Mark multiple exit points from an underground complex to plan escape routes
• Store named resource nodes (e.g., Iron_Node_3) to coordinate mining runs
• Add temporary waypoints during a multi-stage build or exploration task