Xaero's Minimap Mod: Download and Install Guide (26.3)

Xaero's Minimap: never get lost in Minecraft 26.3

A map of everything around you in the corner of your screen: entity radar, waypoints, deathpoints and automatic cave mode. What I saw in my own test, the settings worth changing, fixes for missing waypoints and teleports, and how to install it on Minecraft 26.3.

October 1, 2026Updated Oct 225 min readby

Tested on Minecraft 26.3 (Fabric), October 20, 2026, together with Xaero's World Map, render distance 16. How I test

Minecraft screenshot of a meadow with sheep, pigs and chickens, a square minimap with yellow dots in the top left corner
Real in-game screenshot from Minecraft 26.3 (Fabric, Xaero's Minimap): the minimap in the top left corner shows the animals around me as yellow dots.

Xaero’s Minimap puts a map of everything around you in the corner of your screen and keeps the look of vanilla Minecraft while doing it. Add the entity radar, waypoints, automatic deathpoints and a cave mode that switches on by itself, and it’s hard to get lost again. It’s a client mod for Fabric, Quilt, NeoForge and Forge, and it’s the map mod I’d install first.

Xaero's Minimap for Minecraft 26.3 title card over a dark forest with a minimap in the corner 1:30

The short version

Xaero's Minimap for Minecraft 26.3

Playing loads the video from YouTube (privacy-enhanced mode), which may set cookies and process your data. Details.

What Xaero’s Minimap does

  • The map: terrain around you in the colors of vanilla maps, square or round, rotating with you or locked to north. Size, zoom and position on screen are adjustable.
  • Entity radar: mobs, players, items and other entities as colored dots, or as icons (usually the mob’s head). Hostile and friendly mobs can get different colors.
  • Waypoints: press B to create one. It shows on the minimap and in the game world. U opens the list, where you sort waypoints into sets, share them in chat and see waypoints from other dimensions.
  • Deathpoints: every time you die, the mod sets a skull-shaped waypoint at the spot.
  • Cave mode: underground, and also inside buildings, the map switches to the layer you’re in.
  • Overlays: a chunk grid, slime chunks, and a light overlay that marks blocks where mobs can spawn.

What I saw in my test

I tested Xaero’s Minimap on October 20, 2026 in my own world on Minecraft 26.3 with Fabric, together with Xaero’s World Map.

  • Radar: I put farm animals on a meadow (cows, sheep, chickens and more) and moved past them. They showed up as yellow dots. The compass letters on the edge had W at the top while I was facing west, so the map was turned to my view.
  • Waypoint: I pressed B and the New Waypoint editor opened with my coordinates (3, 70, -27) already filled in, the world and dimension set to “(auto)”, the color White and the type Local. I typed “Home”, the initial “H” became the marker, and after Confirm the marker stood in the world. Later it was on the world map too.
  • Cave mode: in a cave at height 0 I didn’t press anything, and the minimap switched to its dark cave layer showing the tunnels around me.
  • Deathpoint: I died on the meadow and respawned. A skull marker called “Latest Death” sat at the spot, in the world and on the minimap.

Everything worked without touching a setting. In my Minecraft 26.3 tier list Xaero’s Minimap is in S tier at #4.

Settings worth changing

Press Y for the settings. From the developer’s feature list and FAQ:

  • Block colors: Vanilla (map colors) or Accurate (the colors of block textures and biomes). In Vanilla mode you can turn on biome colors separately.
  • Info under the map: besides the coordinates, the biome name, light level, game time and camera angles can be shown. Most of these are off by default.
  • Entity Radar: choose which kinds of entities show up, dots or icons, colors for hostile and friendly mobs, and names.
  • Light overlay: by default it marks blocks with block light from 0 to 7. The developer says these defaults are meant for finding mob-spawnable blocks.
  • Cave mode: you can set how big the “roof” above you has to be before it switches on.
  • Default Teleport Command: waypoint teleports send /tp @s x y z by default. Servers with their own teleport command can get a different one per server (“Teleport Chat Command” in the waypoints menu).
  • Multiworld Detection: turn it off on servers that only have one world.

Compatibility

  • Loaders: Fabric (needs Fabric API), Quilt, NeoForge and Forge. Version 26.5.3 came out for Minecraft 26.3 in September. On October 19, Modrinth listed 26.6.0 (October 5) as the newest Fabric file for 26.3.
  • Client or server: a client mod. On a server it’s optional, but multi-world detection works best with it installed there. Since 25.3.0, admins get a Minimap Server Settings key binding to enforce options like cave mode and the entity radar, and access can follow ranks from FTB Ranks, Odyssey Roles or LuckPerms.
  • Xaero’s World Map: when both are installed, the minimap uses the world map’s textures instead of generating its own, which the developer says improves performance.
  • Open Parties and Claims: claims and allies show on the map.
  • XaeroPlus: the developer asks you not to use it with his mods.
  • Mob model packs: resource packs or mods that change vanilla mob models can break the radar icons.
  • Vanilla players on a modded server: the developer’s FAQ says the mod’s registered status effects are what keep vanilla clients out. The server’s common config (usually config/xaero/minimap) has an option to disable that registration. Restart the server afterwards, and do the same for the world map.

Troubleshooting

From the developer’s FAQ:

  • Teleport to a waypoint doesn’t work: the mod sends /tp, and vanilla /tp needs operator rights (in single-player: cheats on). If the server uses a different command, change it in the settings. If the Teleport button is greyed out, you may be in the wrong sub-world: select the right one and use “Make Sub-world Auto”.
  • Waypoints are gone on a server: “Do not panic”, the developer writes, they’re almost certainly not deleted. Press U and check the sub-worlds in the dropdown at the top right. If the server address changed, pick the old address at the top left and use Options, “Make World/Server Auto”.
  • Mobs are dots instead of icons: a resource pack or mod that changes mob models. Remove it or add a pack with radar icons for those mobs.
  • Editing config files: client and server-specific settings live in xaero/minimap in your game directory. Close Minecraft first and keep a backup.

Alternatives

  • Xaero’s Minimap Fair-Play Edition: the same minimap without entities and cave maps, for PvP servers.
  • Xaero’s World Map: not an alternative but the other half. Press M for a full-screen map of everything you’ve explored.
  • Waystones: if you mainly want to get back home fast in survival. Waypoint teleports need /tp rights, waystones don’t.

How to install Xaero’s Minimap

  1. Install your mod loader for Minecraft 26.3: Fabric, Quilt, NeoForge or Forge. On Fabric, add Fabric API.
  2. Download Xaero’s Minimap for 26.3 from Modrinth or CurseForge, filtered by your loader.
  3. Put the file into your mods folder. On a server it’s optional.

New to Fabric? My Fabric install guide for 26.3 walks through every step.

Verdict

Xaero’s Minimap is for anyone who explores, builds far from home or plays on servers.

  • Pro: looks like vanilla, works out of the box: radar, waypoints, deathpoints and cave mode.
  • Pro: loads of settings, and server admins can lock features they don’t want.
  • Pro: pairs with Xaero’s World Map.
  • Con: waypoint teleport needs /tp rights.
  • Con: the radar and cave maps are a big advantage in PvP, which is why the fair-play edition exists.

FAQ

Is Xaero's Minimap available for Minecraft 26.3?

Yes. Xaero’s Minimap 26.5.3 is out for Minecraft 26.3 on Fabric, Quilt and NeoForge (September 17, 2026) and on Forge (September 20, 2026).

Do I need Fabric API?

On Fabric, yes: the Fabric version lists Fabric API as a required dependency. On NeoForge and Forge you only need the mod itself.

Do I need to install it on the server?

No, it’s mostly client-side. On the server it’s optional and adds reliable world detection for waypoints and server-side settings.

What are the default keys?

B creates a waypoint, U opens the waypoint list, Z enlarges the minimap, I and O zoom in and out, and Y opens the settings. All key bindings are in the vanilla Controls menu.

What is the fair-play edition?

A separate download that doesn’t show entities or cave maps, meant for PvP against players without a minimap.

Why do mobs show up as dots instead of icons?

According to the developer, a resource pack or mod that changes vanilla mob models or animations can break the icon rendering. Remove it, or add a resource pack with radar icons for those mobs.

Where are the minimap settings and waypoints saved?

In the folder xaero/minimap inside your game directory (XaeroWaypoints in older versions). The developer recommends closing Minecraft before you edit anything there, and keeping a backup.

Is it compatible with XaeroPlus?

The developer asks you not to use XaeroPlus with this mod. It isn’t affiliated with him and, according to the mod page, causes hard-to-track bugs and crashes.

Sources

What changed

  • Replaced the illustrations with real screenshots from my test and added my results, the settings worth changing, compatibility notes and troubleshooting.
  • First published.