Xaero's Minimap

Xaero's Minimap

Displays a map of the nearby world terrain, players, mobs, entities in the corner of your screen. Lets you create waypoints which help you find the locations you've marked.

66.9M downloads
Created Apr 9, 2026
by thexaero

About

<p><img src="https://chocolateminecraft.com/images/minimap_2020.png" width="1125" height="655" /></p>

Do not use XaeroPlus with this mod! It is not affiliated with me and causes critical untrackable bugs/crashes. It is also allegedly affiliated with a server griefing group, which can put your server builds at risk.

<p>Unlike many other minimap mods, Xaero's minimap keeps the <strong>aesthetic of vanilla Minecraft</strong>, which helps it be a more seamless addition to the game. It is also <strong>the first rotating square minimap for Minecraft. </strong>Among a wide variety of customization settings, there is an option for a <strong>circle-shaped minimap</strong> and a separate setting for <strong>locking the minimap's rotation</strong> (using a direction arrow instead). The minimap can display the surrounding entities, including <strong>players, mobs and items</strong>, as <strong>dots with a custom color</strong> or as <strong>icons (usually heads)</strong>. In addition to the default <strong>compass directions</strong>, you can place your own&nbsp;<strong>waypoints </strong>that are visible both on the minimap and in the game world.&nbsp;Waypoints help you find previously visited locations or reach specific coordinates, with <strong>optional teleportation</strong>. The minimap can display the surrounding blocks above ground and below ground (<strong>cave mode</strong>). These are just some of the features of the mod while there are many more. Please read the "Minimap features" section below for a more complete list. For the purposes of following multiplayer server rules, there are 2 mod editions, full and fair-play, the latter being designed for fair PVP.&nbsp;<strong>This mod is mostly client-sided. Installing it on the server side is optional for some additional features like world identification.</strong></p>

Follow me on Mastodon (Twitter alternative)? <a href="https://mas.to/@xaero96" target="_blank" rel="nofollow noopener noreferrer">mas.to/@xaero96</a>

Support me on Patreon?</strong> <span style="text-decoration: underline;"><a href="https://bit.ly/PatreonXaero96">patreon.com/xaero96</a></span>

<p>Thank you!</p>

Features

<ul> <li><strong class="bbc">Look of vanilla Minecraft</strong>.</li> <li>Multiple minimap size options including automatic.&nbsp;</li> <li>Multiple zoom options.</li> <li>Two minimap shape options: <strong>square or circle</strong>.</li> <li>Runs&nbsp;<strong class="bbc">smoother than a lot of minimap mods</strong>.</li> <li>Can be placed anywhere on the screen using the "Change Position" setting/screen. You can even shift it by 1 pixel if you so wish. Can be useful when playing with other UI mods.</li> <li>2 block color modes:&nbsp;<strong class="bbc">Vanilla</strong>, which uses the colors of vanilla Minecraft maps and&nbsp;<strong class="bbc">Accurate</strong>, which uses the colors of block textures and biomes. You can also enable biome colors for the Vanilla mode using a separate setting.</li> <li>A custom key binding (Z by default) to temporarily enlarge the minimap to take a better look around.&nbsp;<strong>All key bindings are in the vanilla controls menu.&nbsp;</strong>There are also settings for controlling the behavior of the minimap when it is enlarged, for example to center the minimap on the screen or to fully zoom out the minimap.</li> <li>Map shading customization with the "Terrain Depth" and "Terrain Slopes" settings.</li> <li>Compatible with&nbsp;<a href="https://modrinth.com/mod/xaeros-world-map" target="_blank" rel="noopener noreferrer">Xaero's World Map</a>. By default uses the map textures generated by the world map mod instead of generating its own. This improves performance when using both mods.</li> <li>Server-sided configs with an in-game UI screen that let you control in real time how players on your server are able to use the mod. You can base it on ranks/permission (xaero.minimap.enforced_server_profile). Supports FTB Ranks, Odyssey Roles, LuckPerms and general permission APIs.</li> <li>Option to limit your minimap access by binding it to an item required in your hotbar or to be equipped. For example, add <em>minimapItemId:minecraft:compass</em> anywhere in the config file to bind it to the compass item. This way the minimap will not be displayed unless you have the compass in your hotbar or equipped.</li> <li>Potion effects to control the usage of the minimap or some of its features for the players on your server/map. The following potion effects exist as of writing this: <em>xaerominimap:no_minimap, xaerominimap:no_entity_radar, xaerominimap:no_waypoints, xaerominimap:no_cave_maps. </em>The effects are of the neutral type by default, but you can also specify a harmful type by appending <em>_harmful</em>&nbsp;to the end of the effect ID, for example&nbsp;<em>xaerominimap:no_entity_radar_harmful</em>.</li> <li>Translated to a lot of languages.</li> <li>Option to&nbsp;<strong class="bbc">lock north</strong>&nbsp;to stop the minimap from rotating and instead display the direction of your character with an arrow.</li> <li>Works both above and under ground thanks to the&nbsp;<strong>automatic cave mode</strong>. Cave mode should also activate inside buildings. You can choose the size of the "solid roof" above you that the mod searches for to activate cave mode. Roof size 3x3 and above should prevent cave mode activation when standing under log blocks while cutting wood.</li> <li><strong class="bbc">Waypoints</strong>. Practically an infinite amount. Can be teleported to (permission for teleportation chat command needed). Waypoints are rendered in the game world and displayed on the minimap. You can hide all or specific waypoints. Press&nbsp;<strong class="bbc">B</strong>&nbsp;to create a new waypoint. Press&nbsp;<strong class="bbc">U</strong>&nbsp;to list all the waypoints. In the waypoints list, you can add/edit a single or multiple waypoints, sort them, view waypoints from other sub-worlds/dimensions and much more.</li> <li><strong>Local and global waypoints. </strong>To clear the screen from unnecessary waypoints you can create local waypoints that, unlike global ones, are affected by the "Max WP Draw Distance" option. This enables you to set a single global waypoint for a large area/region and multiple local ones in the area/region. Only the global waypoints will be visible when you are beyond the maximum draw distance.</li> <li><strong>Waypoint sets.</strong>&nbsp;You can organize your waypoints by sorting them into sets. Your current set can be quickly switched with a key binding. <strong>All key bindings are in the vanilla controls menu.</strong></li> <li><strong>Waypoint sharing</strong>. You can share your waypoints in the game chat with players on the server. This is done from the waypoints list (press U).</li> <li><strong class="bbc">Deathpoints</strong>. An&nbsp;<strong class="bbc">automatic skull-shaped waypoint</strong>&nbsp;is created&nbsp;<strong class="bbc">on each death</strong>. Old deathpoints are converted to regular waypoints, which you can disable using the "Keep Old Deathpoints" setting.</li> <li>Displays chunk claims and ally players from the <a href="https://modrinth.com/mod/open-parties-and-claims" target="_blank" rel="noopener noreferrer">Open Parties and Claims</a> mod.</li> <li>Togglable&nbsp;<strong class="bbc">chunk grid</strong>. The chunk grid shows you where block chunks begin and end.&nbsp;</li> <li>Togglable&nbsp;<strong class="bbc">slime chunks</strong>&nbsp;mode. The chunks where slimes can spawn are marked with a green overlay.</li> <li><strong>Custom light overlay</strong>. You can setup a light overlay that will mark blocks with a custom color if they are within a custom light value range, which is block light from 0 to 7 by default. The default settings are meant for finding mob-spawnable blocks. You can use it for any purpose.</li> <li>Multi-world detection in multiplayer. If you install the minimap mod on the server side in addition to the client side, each server world should get a separate waypoints "sub-world". Otherwise a much less reliable world separation is used, which is based on the world spawnpoint. If you can't install the mod on the server side, it is recommended to turn off multi-world detection for servers that only have a single "world". You can do it through the <em>Waypoints Menu (press U) -&gt; Options</em> screen.</li> <li>Displays&nbsp;<strong class="bbc">mobs</strong>&nbsp;on the map as&nbsp;<strong class="bbc">yellow dots.</strong>&nbsp;<strong class="bbc">Hostile and friendly</strong>&nbsp;mobs can be colored&nbsp;<strong class="bbc">differently. </strong>Can also be displayed as <strong>icons/heads</strong>.&nbsp;Check the <strong>"Entity Radar"</strong> settings.</li> <li>Displays&nbsp;<strong class="bbc">players</strong>&nbsp;on the map as&nbsp;<strong class="bbc">white dots or player heads.&nbsp;</strong>Can also be displayed as <strong>icons/heads</strong>.&nbsp;Check the <strong>"Entity Radar"</strong> settings.</li> <li>Displays&nbsp;<strong class="bbc">items</strong>&nbsp;on the map as&nbsp;<strong class="bbc">red dots. </strong>Check the <strong>"Entity Radar"</strong> settings.</li> <li>Displays all the&nbsp;<strong class="bbc">other entities</strong>&nbsp;such as arrows and item frames as&nbsp;<strong class="bbc">purple dots</strong><span class="bbc">.</span><strong class="bbc">&nbsp;</strong>Different types of entities can be disabled in the settings.&nbsp;Check the <strong>"Entity Radar"</strong> settings.</li> <li>Options for <strong>displaying entity names </strong>on the minimap<strong>&nbsp;</strong>in the "Entity Radar" settings.</li> <li>Zoom in and out key bindings&nbsp;<strong class="bbc">(I and O by default) </strong>to efficiently change the zoom level to fit your preference or use case.</li> <li><strong class="bbc">Coordinates&nbsp;</strong>under the minimap.</li> <li><strong class="bbc">Current biome name</strong>&nbsp;under the mini

Versions

vfabric-1.21.11-25.3.10Latest
1.21.11fabric, quiltFeb 9, 2026

[Read changelogs](https://chocolateminecraft.com/update.php?mod_id=0)

Download
vforge-1.21.11-25.3.10
1.21.11forgeFeb 9, 2026

[Read changelogs](https://chocolateminecraft.com/update.php?mod_id=0)

Download
vneoforge-1.21.11-25.3.10
1.21.11neoforgeFeb 9, 2026

[Read changelogs](https://chocolateminecraft.com/update.php?mod_id=0)

Download

Download

Download vfabric-1.21.11-25.3.10

Minecraft: 1.21.11

Loaders: fabric, quilt

Tags

fabricforgeneoforgequilt1.21.71.21.81.21.91.21.101.21.11