Xaero's Minimap

xaero96's vanilla-styled minimap: a square or round map in the corner of the screen with an entity radar, automatic cave mode and waypoints you can share, teleport to and sort into sets. It works on any server from your own game, and a server copy adds world identification and admin controls.

111M+ Downloads by xaero96

About Xaero's Minimap

Xaero's Minimap, by xaero96, draws a live map of the terrain around you in a corner of the screen, marks nearby players, mobs and items on it, and adds waypoints that show on the map and as markers in the world itself. It deliberately keeps the look of vanilla Minecraft, and its author credits it as the first rotating square minimap made for the game. It runs on your own client, so it works in singleplayer and on servers that know nothing about it. Installing it on a server as well is optional and adds a few things covered below.

What the corner map shows

The map is square by default and can be switched to a circle. It rotates with you unless you lock north, in which case an arrow shows your heading instead. Size, zoom (I and O by default) and position are all adjustable, down to a single pixel on the Change Position screen, which helps when another mod's interface wants the same corner. Pressing Z enlarges the map for a closer look. Every key binding lives in the vanilla Controls menu, and Y opens the mod's own settings.

Two colour modes decide how the terrain looks. Vanilla reuses the colours of paper maps, and Accurate samples the block textures and biome tints, which also reflects your resource pack. Underground, or under a solid roof, the map switches to cave mode by itself. The size of the roof it looks for is a setting, and 3x3 or larger stops a single log overhead from flipping the map while you chop a tree.

The entity radar marks players as white dots, mobs as yellow (with hostile and friendly mobs colourable separately), items as red and everything else, arrows and item frames included, as purple. Any category can show heads or icons instead of dots, or be hidden. Optional overlays add a chunk grid, slime chunks and a light overlay that by default marks blocks with block light 0 to 7, the spots where hostile mobs can spawn. Coordinates, biome, light level and game time can sit under the map.

Mob icons are drawn from each entity's own model, which covers every vanilla mob and some simple modded ones with an obvious head. When the mod cannot find a recognisable head on a modded mob, it falls back to a coloured dot. Since version 21.6.0 a resource pack can supply its own icons under assets/xaerominimap/entity/icon/, and at least one community pack does this for popular mods. Claims and allied players from the Open Parties and Claims mod also show on the map.

Waypoints

B creates a waypoint and U opens the full list, where waypoints can be edited in bulk, sorted, hidden and viewed from other dimensions. Every death leaves a skull-shaped deathpoint automatically. Waypoints come in two kinds. Global ones stay visible at any distance, while local ones obey the Max WP Draw Distance setting, so one global marker can label a region while local markers inside it stay out of sight until you arrive. Sets group waypoints further, and a key binding switches the active set.

Sharing works through the game chat: send a waypoint from the list and other players with the mod can add it. Teleporting to a waypoint sends a chat command, /tp @s x y z by default, so it needs permission to run that command, which in vanilla means operator status or cheats. Servers with their own teleport plugin can set a different command in the waypoint options, usually without the @s.

Full edition or fair-play

The mod comes in two editions. The full edition, the one in this page's download table, has no restrictions. The separate fair-play edition shows no entities and no cave maps, which keeps things even on PvP servers where other players have no minimap. Servers can also enforce those limits on players running the full edition.

What a server installation adds

A Fabric, Quilt, NeoForge or Forge server can run the minimap too. The first benefit is world identification: each world on the server gets its own waypoint "sub-world" reliably. Without the server copy, the mod separates worlds by their spawn point, which is much less reliable, and on a single-world server the author recommends switching multiworld detection off in the waypoint options.

From version 25.3.0, admins get a Minimap Server Settings key binding that opens a screen for enforcing nearly any option, cave mode and the entity radar included, even with custom radar categories. Rules can follow ranks through the xaero.minimap.enforced_server_profile permission, with FTB Ranks, Odyssey Roles and LuckPerms supported. Map makers can use potion effects such as xaerominimap:no_minimap, no_entity_radar, no_waypoints and no_cave_maps, and a config line such as minimapItemId:minecraft:compass hides the map until the player carries that item.

One side effect catches server owners out. With the mod on the server, players without it cannot join, because of the status effects it registers. The server's common config in config/xaero/minimap has an option to stop registering them. Change it, restart, and do the same for Xaero's World Map if it is installed.

When waypoints seem to vanish

Missing waypoints are almost never deleted. Waypoints are stored per server address and per sub-world, so a changed address or the wrong sub-world marked as automatic hides them. Open the list with U and check the sub-worlds in the top-right dropdown. If the address changed, find the old one in the top-left dropdown and use Options, then Make World/Server Auto. With the World Map installed, the map you confirm on its screen also decides which waypoint sub-world is automatic, so confirming the wrong map is a common cause.

Reading the file names

Files released since January 2026 are named like xaerominimap-fabric-26.3-26.5.3.jar: loader, Minecraft version, then the mod's own version. Since June 2026 that mod version has started with 26, so it reads like a Minecraft release without being one. Only the middle number tells you which game version the file is for.

Pairing it with Xaero's World Map

Xaero's World Map is the fullscreen companion. With both installed, the minimap reuses the world map's rendered chunks instead of generating its own, which the author notes improves performance, and the world map displays and edits the minimap's waypoints. Keep both current: the latest minimap refuses World Map versions older than 1.44.0. The author also warns against XaeroPlus, a third-party add-on that is not affiliated with the Xaero mods and, according to the author, causes crashes that are hard to trace.

Every loader and Minecraft version has its own minimap file, and the Fabric one needs Fabric API next to it.

How to Download Xaero's Minimap for Minecraft

Start from the Xaero's Minimap Downloads section. Choose your Minecraft version, then your loader, and the table leaves the one file you need. Its Download button takes you to that file on Modrinth. Quilt uses the Fabric row. The table lists the full edition. The fair-play edition is a separate project on the author's pages.

How to Install Xaero's Minimap in Minecraft

  1. Get Fabric, NeoForge or Forge running for your Minecraft version first.
  2. Put the minimap jar in the mods folder. On Fabric, add Fabric API for the same Minecraft version. On Forge 1.12.2 or 1.16.5, add XaeroLib for that version instead. Newer files have XaeroLib built into the jar.
  3. If you use Xaero's World Map as well, update it at the same time. Current minimap files refuse World Map versions older than 1.44.0.
  4. When updating, delete the previous minimap jar first. Two copies of the same mod in one folder stop the game from starting. Some modpacks already include the minimap, Better MC among them, so look through the pack's mods before installing your own copy.
  5. Launch and join a world. The map appears in the corner straight away.

On a server

Installing the same file on a Fabric, NeoForge or Forge server is optional. It gives each world its own waypoints and unlocks the server settings screen for admins. Before inviting players who do not use the mod, turn off the status effect registration option in the server's common config under config/xaero/minimap, then restart, or they will not be able to join.

Checking that it works

Press Y in game to open the minimap settings, and B to create a test waypoint. If the keys do nothing, look for them under Controls, where the mod's bindings live. A crash at launch usually means a missing Fabric API, a jar for another loader, or a minimap and World Map from different generations. For general loader problems, see the mod installation guide.

Waypoints are saved in the game directory under xaero/minimap (XaeroWaypoints in older versions). Copy that folder along when you move to a new instance or launcher, and your waypoints come with you.

Download Xaero's Minimap

Release status VersionMinecraft version Platform / LoaderReleased Download
forge-26.3-26.5.3Latest versionRelease 26.3 Forge Download
neoforge-26.3-26.5.3Latest versionRelease 26.3 NeoForge Download
fabric-26.3-26.5.3Latest versionRelease 26.3 Fabric, Quilt Download
fabric-26.2-26.5.1Release 26.2 Fabric, Quilt Download
neoforge-26.2-26.5.1Release 26.2 NeoForge Download
forge-26.2-26.5.1Release 26.2 Forge Download
forge-26.1.2-26.5.0Release 26.1.2 Forge Download
neoforge-26.1.2-26.5.0Release 26.1.2 NeoForge Download
fabric-26.1.2-26.5.0Release 26.1.2–26.1 Fabric, Quilt Download
fabric-1.21.11-26.5.0Release 1.21.11 Fabric, Quilt Download
forge-1.21.11-26.5.0Release 1.21.11 Forge Download
neoforge-1.21.11-26.5.0Release 1.21.11 NeoForge Download
forge-1.21.10-26.5.0Release 1.21.10 Forge Download
neoforge-1.21.10-26.5.0Release 1.21.10 NeoForge Download
fabric-1.21.10-26.5.0Release 1.21.10 Fabric, Quilt Download
25.2.15_Fabric_1.21.9Release 1.21.9 Fabric, Quilt Download
25.2.15_NeoForge_1.21.9Release 1.21.9 NeoForge Download
25.2.15_Forge_1.21.9Release 1.21.9 Forge Download
forge-1.21.8-26.5.0Release 1.21.8 Forge Download
neoforge-1.21.8-26.5.0Release 1.21.8 NeoForge Download
fabric-1.21.8-26.5.0Release 1.21.8 Fabric, Quilt Download
25.2.10_Fabric_1.21.7Release 1.21.7 Fabric, Quilt Download
25.2.10_NeoForge_1.21.7Release 1.21.7 NeoForge Download
25.2.10_Forge_1.21.7Release 1.21.7 Forge Download
25.2.8_NeoForge_1.21.6Release 1.21.6 NeoForge Download
25.2.7_Fabric_1.21.6Release 1.21.6 Fabric, Quilt Download
fabric-1.21.5-26.5.0Release 1.21.5 Fabric, Quilt Download
forge-1.21.5-26.5.0Release 1.21.5 Forge Download
neoforge-1.21.5-26.5.0Release 1.21.5 NeoForge Download
fabric-1.21.4-26.5.0Release 1.21.4 Fabric, Quilt Download
forge-1.21.4-26.5.0Release 1.21.4 Forge Download
neoforge-1.21.4-26.5.0Release 1.21.4 NeoForge Download
fabric-1.21.3-25.3.5Release 1.21.3 Fabric, Quilt Download
forge-1.21.3-25.3.5Release 1.21.3 Forge Download
neoforge-1.21.3-25.3.5Release 1.21.3 NeoForge Download
fabric-1.21.1-26.5.0Release 1.21.1 Fabric, Quilt Download
forge-1.21.1-26.5.0Release 1.21.1–1.21 Forge Download
neoforge-1.21.1-26.5.0Release 1.21.1–1.21 NeoForge Download
25.3.2_Fabric_1.21Release 1.21 Fabric, Quilt Download
25.2.12_Forge_1.20.6Release 1.20.6–1.20.5 Forge Download
25.2.10_Fabric_1.20.6Release 1.20.6 Fabric, Quilt Download
25.2.10_NeoForge_1.20.6Release 1.20.6 NeoForge Download
25.2.0_Fabric_1.20.6Release 1.20.5 Fabric, Quilt Download
24.2.0_NeoForge_1.20.6Release 1.20.5 NeoForge Download
forge-1.20.4-26.5.0Release 1.20.4 Forge Download
neoforge-1.20.4-26.5.0Release 1.20.4 NeoForge Download
fabric-1.20.4-26.5.0Release 1.20.4 Fabric, Quilt Download
24.1.1_Fabric_1.20.4Release 1.20.3 Fabric, Quilt Download
24.1.1_NeoForge_1.20.4Release 1.20.3 NeoForge Download
24.1.1_Forge_1.20.4Release 1.20.3 Forge Download
25.2.10_Fabric_1.20.2Release 1.20.2 Fabric, Quilt Download
25.2.10_Forge_1.20.2Release 1.20.2 Forge Download
25.2.10_NeoForge_1.20.2Release 1.20.2 NeoForge Download
forge-1.20.1-26.5.0Release 1.20.1–1.20 Forge Download
fabric-1.20.1-26.5.0Release 1.20.1–1.20 Fabric, Quilt Download
25.2.10_Fabric_1.19.4Release 1.19.4 Fabric, Quilt Download
25.2.10_Forge_1.19.4Release 1.19.4 Forge Download
23.9.3_Fabric_1.19.3Release 1.19.3 Fabric, Quilt Download
23.9.3_Forge_1.19.3Release 1.19.3 Forge Download
forge-1.19.2-26.5.0Release 1.19.2–1.19.1 Forge Download
fabric-1.19.2-26.5.0Release 1.19.2–1.19.1 Fabric, Quilt Download
forge-1.18.2-26.5.0Release 1.18.2 Forge Download
fabric-1.18.2-26.5.0Release 1.18.2 Fabric, Quilt Download
23.9.7_Fabric_1.17.1Release 1.17.1–1.17 Fabric, Quilt Download
23.9.7_Forge_1.17.1Release 1.17.1 Forge Download
fabric-1.16.5-26.5.0Release 1.16.5 Fabric, Quilt Download
forge-1.16.5-26.5.0Release 1.16.5 Forge Download
fabric-1.16.5-26.1.0Release 1.16.4–1.16.2 Fabric, Quilt Download
24.6.1_Forge_1.16.5Release 1.16.4–1.16.2 Forge Download
23.3.14_Forge_1.15.2Release 1.15.2 Forge Download
23.3.14_Forge_1.14.4Release 1.14.4 Forge Download
forge-1.12.2-26.5.1Release 1.12.2 Forge Download
21.10.41_Forge_1.8.9Release 1.8.9 Forge Download
21.10.44_Forge_1.7.10Release 1.7.10 Forge Download

FAQ

Does Xaero's Minimap need to be installed on the server?

No. It works on any server as a client mod. A server copy is optional and adds reliable per-world waypoints and an admin screen for enforcing settings.

Do I need Fabric API for Xaero's Minimap?

Yes on Fabric and Quilt. NeoForge and Forge builds do not use it. Recent files include XaeroLib, but the Forge 1.12.2 and 1.16.5 builds need XaeroLib installed separately.

Why does waypoint teleport not work?

The mod teleports by sending a chat command, /tp @s x y z by default, which needs permission to use /tp. On servers with a different teleport command, change it in the waypoint options, often removing @s.

What is the fair-play edition?

A separate version that shows no entities and no cave maps, for PvP servers where the full radar would be an unfair advantage. Servers can also enforce the same limits on the full edition.

Where did my waypoints go on a server?

They are almost always still there, under another sub-world or server address. Open the list with U, check the dropdowns, and use Make Sub-world Auto or Make World/Server Auto on the right one.

Can vanilla players join a server that has Xaero's Minimap?

Only after you disable the registration of status effects in the server's common config under config/xaero/minimap and restart. Do the same for Xaero's World Map.

Is XaeroPlus made by Xaero?

No. The author states that XaeroPlus is not affiliated with the Xaero mods and asks players not to combine them, because it causes crashes that are hard to trace.

Why is the mod version 26.5 when I play Minecraft 26.3?

The mod's own version numbers now resemble Minecraft versions. In a file name like xaerominimap-fabric-26.3-26.5.3.jar, 26.3 is the Minecraft version and 26.5.3 is the mod version.

Related
Mod · Fabric / NeoForge

Simple Voice Chat

henkelmax's proximity voice chat for Minecraft: Java Edition. Nearby players hear each other with directional audio that fades with distance, and push to talk, voice activation, whispering and password-protected groups cover the rest. Voice runs through the server, so the server and every player need it installed.

Mod · NeoForge / Fabric

Just Enough Items (JEI)

Just Enough Items (JEI) is an item and recipe viewer by mezz. It lists every item in the game, vanilla and modded, in a searchable panel beside your inventory. One key shows the recipes that make an item, another shows what it is used for, and that includes machine recipes from mods that support JEI. Bookmarks and a cheat mode for testing round it out.

Mod · Forge / NeoForge

Xaero's World Map

xaero96's fullscreen map that draws itself from the chunks you explore, opened with M and panned like an online map. It keeps separate maps per world on the same server, has a cave mode for the Nether, and becomes a waypoint editor when Xaero's Minimap is installed.