XaeroNav: Real Pathfinding for Xaero's Maps in Minecraft
XaeroNav is an add-on that brings genuine route planning to Xaero's Minimap and Xaero's World Map. Instead of drawing a straight line and hoping for the best, it runs an A* search over the actual terrain, weighing walking, climbing, swimming, boat riding, ladders and vines, short jumps, digging, and bridging with blocks you are carrying. If you have ever stared at a straight-line arrow pointing into a ravine, you already understand why this matters.
What XaeroNav Actually Does
Routes follow real terrain rather than raw distance. The search combines every movement type the player can perform, and bridging blocks are budgeted against your inventory. A route that needs more blocks than you have is only offered when nothing else gets you through, and the HUD tells you exactly how many are missing. A path that would drain most of a stack loses to a slightly longer one that places fewer blocks, which keeps your resources intact on long trips.
Long-distance routes are calculated in stages. A rough route is drawn from Xaero's Map data so it can reach beyond the chunks loaded around you, while the loaded area is quietly turned into a navigation graph in the background. The detailed search aims straight at the destination using that graph and falls back to the rough route past its edge. Multi-layer paths are supported too, which matters in the Nether where passages overlap at the same coordinates but sit at different heights.
Guidance That Stays Calm
Recalculation only happens when it is needed. Small deviations while walking do not trigger a redraw, so the line stays stable instead of flickering. The HUD shows time left to the destination, even when only part of the route has been found, and the estimate sharpens as you move. Danger warnings arrive before the danger does: segments beside lava, digging that could flood an area, falls without a safe landing, and swims that would run out of breath all get their own colors, and warning colors always outrank movement colors.
Commands, Keybinds, and Elytra Flight
Setting a destination takes seconds. Right-click empty space on the world map and choose "Route here," right-click a waypoint, use the unbound "Route to block looked at" keybind, or run the command below.
- /xaeronav goto <x> <y> <z> sets the destination
- /xaeronav clear removes the route
- /xaeronav version prints the running build for bug reports
- /xaeronav debug holds measurement commands like mapdata, route, probe, and flight
With Xaero's Minimap installed, your destination registers as a temporary waypoint that stays upright as the map rotates, slides to the edge with a distance readout when off screen, and never gets saved to disk. While gliding with an elytra, the system plots a 3D flight path in the air that avoids terrain collisions and follows it with its own deviation check and recalculation interval. XaeroNav even works without Xaero installed: map drawing and the right-click menu are disabled, but pathfinding, in-world rendering, and on-screen guidance keep running.
If you would rather skip manual file juggling, the foxygame.net launcher installs XaeroNav in a single click and keeps it updated automatically, so version compatibility with your Minecraft build is handled for you.
Versions, Loaders, and Installation
XaeroNav ships for modern Minecraft releases on Fabric and NeoForge, and it is licensed under MIT. To download XaeroNav for Minecraft, grab the build that matches your game version and loader, then drop the jar into your mods folder. The steps are simple:
- Confirm you are running Fabric or NeoForge for your Minecraft version
- Install Xaero's Minimap and Xaero's World Map for full map integration
- Place the XaeroNav jar in the mods folder and launch the game
- Allocate at least 2 GB of Java heap, since searches need the memory
Knowing how to install is only half the battle. The search range is limited by render distance, so distant destinations may end partway and appear as a dotted line that fills in as you travel. Chunks the server has not sent cannot be read, so raising your render distance helps long routes complete. The navigation graph covers up to 224 blocks around you, or 160 blocks with less than 2.5 GB of heap, and rebuilds every 8 blocks walked. Cross-dimension routes are not supported, and moving to another dimension clears the destination.
Final Thoughts
XaeroNav turns Xaero's maps into a genuine navigation system rather than a decorative overlay. The terrain-aware routing, block budgeting, danger coloring, and staged long-distance planning solve problems that straight-line arrows never could. Install it alongside your map mods, keep an eye on the HUD, and let the route handle the rest.