Xaero's Minimap

Source-provided project description. FreeMinecraftMods keeps creator credit and adds separate compatibility and decision guidance below.

Project overview

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. Unlike many other minimap mods, Xaero's minimap keeps the aesthetic of vanilla Minecraft , which helps it be a more seamless addition to the game. It is also the first rotating square minimap for Minecraft. Among a wide variety of customization settings, there is an option for a circle-shaped minimap and a separate setting for locking the minimap's rotation (using a direction arrow instead). The minimap can display the surrounding entities, including players, mobs and items , as dots with a custom color or as icons (usually heads) . In addition to the default compass directions , you can place your own waypoints that are visible both on the minimap and in the game world. Waypoints help you find previously visited locations or reach specific coordinates, with optional teleportation . The minimap can display the surrounding blocks above ground and below ground ( cave mode ). 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. This mod is mostly client-sided. Installing it on the server side is optional for some additional features like world identification. Follow me on Mastodon (Twitter alternative)? mas.to/@xaero96 Support me on Patreon? patreon.com/xaero96 Thank you! undefined Features Look of vanilla Minecraft . Multiple minimap size options including automatic. Multiple zoom options. Two minimap shape options: square or circle . Runs smoother than a lot of minimap mods . 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. 2 block color modes: Vanilla , which uses the colors of vanilla Minecraft maps and Accurate , which uses the colors of block textures and biomes. You can also enable biome colors for the Vanilla mode using a separate setting. A custom key binding (Z by default) to temporarily enlarge the minimap to take a better look around. All key bindings are in the vanilla controls menu. 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. Map shading customization with the "Terrain Depth" and "Terrain Slopes" settings. Compatible with Xaero's World Map . By default uses the map textures generated by the world map mod instead of generating its own. This improves performance when using both mods. 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. Option to limit your minimap access by binding it to an item required in your hotbar or to be equipped. For example, add minimapItemId:minecraft:compass 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. 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: xaerominimap:no_minimap, xaerominimap:no_entity_radar, xaerominimap:no_waypoints, xaerominimap:no_cave_maps. The effects are of the neutral type by default, but you can also specify a harmful type by appending _harmful to the end of the effect ID, for example xaerominimap:no_entity_radar_harmful . Translated to a lot of languages. Option to lock north to stop the minimap from rotating and instead display the direction of your character with an arrow. Works both above and under ground thanks to the automatic cave mode . 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. Waypoints . 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 B to create a new waypoint. Press U 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. Local and global waypoints. 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 max

FreeMinecraftMods decision guide

This mod is most relevant to players looking for Map and Information, Player Transport on Forge, NeoForge, Fabric, Quilt. Treat those labels as discovery hints, then verify the exact file and dependency list on the official project page.

The source record was updated on Jul 22, 2026, which is a recent freshness signal. A recent date does not guarantee support for every loader or Minecraft version, so still inspect the current file list.

What to verify before choosing a file

• Confirm that the file is published by the credited creator on the linked official source.
• Match the Minecraft version exactly instead of relying only on a broad category label.
• Read dependencies, incompatibilities, and changelog notes before updating an existing instance.
• Match the loader or server platform and its required version. Forge and NeoForge are not interchangeable.
• Back up worlds and configuration files before testing the project in a long-term save or public server.

Compatibility at a glance

Minecraft versions in this snapshot: 1.15.2, 1.14.4, 1.8.9, 1.19, 1.18.1, 1.18, 1.16.1, 1.12.1, 1.12, 1.15.1, 1.13.2, 1.14.3

Loaders and platforms: Forge, NeoForge, Fabric, Quilt, undefined

Before you install

Match the exact Minecraft version and loader, install every required dependency, and test in a separate profile before opening an important world. Keep a backup before changing a working mod list.

Source, licensing, and corrections

FreeMinecraftMods does not mirror the project files. Use the official source for downloads, release notes, dependencies, support, and licensing details. Project names, images, and creator-written descriptions remain the property of their respective owners.

How listings are reviewed | Report incorrect project information | Rights-holder and DMCA information