Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/flamingrickpat/pm-minecraft/minecraft_waypointsnpx skills add flamingrickpat/pm-minecraft --skill minecraft_waypointsgit clone --depth 1 https://github.com/flamingrickpat/pm-minecraftWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/flamingrickpat/pm-minecraft/minecraft_waypoints)<a href="https://agentmods.dev/skills/flamingrickpat/pm-minecraft/minecraft_waypoints"><img src="https://agentmods.dev/badge/skills/flamingrickpat/pm-minecraft/minecraft_waypoints.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00064 | $0.00538 |
| Opus 5 | $0.00032 | $0.00269 |
| Sonnet 5 | $0.00013 | $0.00108 |
| Haiku 4.5 | $0.00006 | $0.00054 |
Grade A, and why
minecraft-waypoints scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
Minecraft In-Memory Waypoints
find_block will not rediscover a walled/underground target: its
anti-x-ray is hard-locked, so something you already mined (e.g. an iron vein)
returns block_not_found from any visible angle. The fix is to remember it
instead of re-finding it.
When to save a waypoint
Save coordinates the moment they matter, while you can see them:
- A block you are mining (the vein's origin) — so you can walk back to it later.
- The entry of a staircase or a mine you dug — so you can return to it.
- A block too expensive / unmineable right now ("come back with better tool").
- A confirmed village sighting from
minecraft_raytrace.
Anything you would otherwise have to see again to locate is a candidate. Nothing that matters in the grand scheme — these are ephemeral and in-memory.
How
minecraft_add_waypoint(description="iron vein", x=..., y=..., z=...)stores it. Omitting any coordinate uses the current position — handy right after you stop at a spot.minecraft_list_waypoints()returns{ waypoints: [{x,y,z,description}], count, cap }.- Cap is 6; when full the oldest is evicted. Not persisted across sessions.
How to use them
- To revisit a saved spot:
minecraft_walk_to(x=..., y=..., z=..., chunk_limit=6)and let walk_to's standable-cell routing bring you in range. - After collecting everything at a spendable spot, replace it (add a new one for the next target — the oldest falls off).
Rules
- Remember at the moment of discovery, not later from memory.
- Prefer a waypoint over
find_blockfor anything underground, in a wall, or around a corner — find_block can't see those by design. - For durable, long-term facts (base location, route home, big chests) use the persistent memory files instead (AGENTS.md / memory/*.md), since waypoints are lost across sessions and autocompacts.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 5d ago First seen · 48 lines · 64 tokens per session scan A 62fa50666aa6
minecraft-waypoints is a skill published in the GitHub repository flamingrickpat/pm-minecraft (1 stars, last pushed 4d ago), licensed MIT. It adds 64 tokens to every session and 538 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
godot-optimization
Use when optimizing Godot games — profiler, draw calls, physics tuning, memory management, and common bottlenecks.
cgs-perf-profile
Use for perf profile tasks that profile frame time, memory, loading, assets, rendering, scripting, and platform constraints; produce verification evidence, changed or proposed files, and handoff boundaries.
cgs-soak-test
Use for soak test tasks that plan longer stability checks for memory, performance drift, save/load, networking, and live-ops loops; produce verification evidence, changed or proposed files, and handoff boundaries.
philosopher
Reviews a completed Minecraft build — the plan, the execution, what worked and what did not — and records reusable process lessons in Claude's project memory so future builds go better. Use after a build is finished or a build session wraps up. Part of the minecraft-builder workflow.
animation-memory-optimization
Optimize animation memory usage for efficiency.
rpg-worldstate-gm
Use the RPG Worldstate MCP as durable memory when starting, continuing, or gamemastering an RPG campaign. Applies only when the user is working with a persistent RPG world, not to unrelated chats or ordinary fiction writing without this MCP.