Xaero's Minimap is a client-side mod for Minecraft Java Edition that adds a live minimap to the corner of your HUD. It shows terrain, players, mobs, and named entities in real time, and lets you create waypoints to mark coordinates you want to find again. The mod ships separate builds for Fabric, Forge, NeoForge, and Quilt and covers releases from 1.16.5 through the current 1.21.x generation.
Features
- Real-time minimap in a configurable HUD corner showing terrain height and biome colors.
- Player, mob, and entity tracking with labeled icons.
- Named waypoints with colored beacons and distance display.
- Automatic death point saved as a recoverable waypoint.
- Round or square minimap shape with adjustable zoom and scale.
- Pairs with Xaero's World Map for a full-screen map view using the same data.
Installation
Install Xaero's Minimap as a standard .jar mod file. Download the build that matches your exact Minecraft version and loader from the Modrinth project page.
- 1.Install your loader: Fabric Installer, Forge Installer, NeoForge Installer, or Quilt Installer.
- 2.Download the Xaero's Minimap .jar for your loader and Minecraft version from Modrinth.
- 3.Place the .jar file in your Minecraft mods folder.
- 4.Launch the game with your loader profile selected.
- 5.Open the minimap settings from the in-game menu or the dedicated key binding to configure the overlay.
Multiplayer and Server Use
Xaero's Minimap runs entirely client-side. No server installation is needed, and it works on vanilla servers, modded servers, and Minecraft Realms. Waypoints are saved per dimension and per server address, so your markers on one server do not appear on another. On multiplayer, the mod can display other players and mobs within render range.
Questions about this entry.
How do I install Xaero's Minimap?
Download the .jar that matches your Minecraft version and loader from the Modrinth project page. Drop it into your mods folder alongside your loader install. No extra libraries are required on Forge or NeoForge. Fabric users may also want Fabric API installed, though Xaero's Minimap does not strictly require it.
Does Xaero's Minimap work with Fabric and Forge?
Yes. Separate builds are released for Fabric, Forge, NeoForge, and Quilt. The files are not interchangeable, so download the jar labeled for your specific loader. Both Fabric and Forge builds are actively updated and cover Minecraft 1.16.5 through 1.21.x.
Can I use Xaero's Minimap on a multiplayer server?
Yes, the mod runs on the client and does not need to be installed on the server. It works on vanilla servers, modded servers, and Minecraft Realms. Some servers restrict entity tracking on minimaps for anti-cheat reasons, in which case mob and player icons will not appear.
Does Xaero's Minimap work with Sodium?
Yes. Xaero's Minimap is a HUD overlay and does not touch the rendering pipeline that Sodium optimizes. The two mods are widely used together on Fabric and are generally compatible without additional configuration.
Which Minecraft versions does Xaero's Minimap support?
Xaero's Minimap receives updates for current Minecraft releases. Actively maintained versions include 1.20.1, 1.20.4, 1.20.6, 1.21, 1.21.1, and 1.21.11. Older builds going back to 1.7.10 are available on the project page but are no longer updated.


