Ping to Map: Xaero's Minimap & Ping Wheel Addon
Drop a temporary Xaero's Minimap waypoint the instant a teammate (or you) pings a spot with Ping-Wheel. No prompt, no edit screen — the waypoint just appears, then auto-expires after 30 seconds.
You ping "come here!" with Ping-Wheel, but it never shows on the map — so for big builds people still can't find the spot. This addon makes every ping silently create a temporary waypoint on Xaero's Minimap, with zero UI interruption. The waypoint auto-expires after 30 seconds so the map stays clean.
- 📍 Temporary waypoint on every ping — no prompt, no edit screen, no clicks
- 🕒 Auto-expires in 30 s (configurable 1–600 s)
- 🤝 Multiplayer team-share — Ping-Wheel broadcasts pings to all teammates server-side; this addon runs on each client independently and creates the waypoint locally
- 🌐 Client-side only — no server install needed
- 💡 Pure addon — Ping-Wheel + Xaero's Minimap (or World Map) you already have; no items, no blocks
- 🛟 Safe without Xaero's — silent fail if Xaero's isn't installed; no crash
How it works
Ping-Wheel has no public API, so this mod uses a Mixin (@Inject(at = @At("HEAD"))) on nx.pingwheel.common.core.PingManager.acceptPingPacket. Ping-Wheel itself dispatches its packet work through Minecraft.execute(...), so we do the same: marshal everything onto the main client thread, then reflect into Xaero's internal API to construct and add a Waypoint directly to the current WaypointSet. After the configured lifetime elapses, a self-managed System.nanoTime()-based tracker removes it via the same reflection chain.
Ping-Wheel's own behaviour is never interrupted — @Inject at HEAD only, never cancel. All reflection paths swallow exceptions silently, so an Xaero update / API rename / Xaero absence just yields a no-op (no crash, no console spam).
Supported loaders / versions
| Minecraft |
NeoForge |
Forge |
Fabric |
| 1.21.1 |
✅ |
✅ |
✅ |
| 1.20.1 |
— |
✅ |
✅ |
NeoForge has no 1.20.1 release.
Compatibility
| Mod |
Support |
Note |
| Ping-Wheel |
required |
Mixin target |
| Xaero's Minimap |
optional (CLIENT only) |
Waypoint target |
| Xaero's World Map |
optional (CLIENT only) |
Shares the same waypoint store with Minimap |
| Voice Chat mods (Plasmo, etc.) |
unaffected |
Ping-Wheel coexists with them, so does this |
| JourneyMap |
not targeted by this build |
Use the JourneyMap sister mod instead |
Install
- Install NeoForge / Forge / Fabric for 1.21.1 or 1.20.1
- Install Ping-Wheel (required)
- Install Xaero's Minimap and/or Xaero's World Map on the client (recommended)
- Fabric only: add Forge Config API Port
- Drop
pingtomapxaeros-<version>.jar for your loader/MC from the releases page into mods/ (client only — no server install needed)
License
MIT — modpack use, modification and redistribution OK, credit not required (welcome).
Author: KURONAMI · Built on Ping-Wheel / Xaero's Minimap / Xaero's World Map. Sister mod: Compass to Map: Xaero's edition.
