Xaero’s Minimap Mod [1.21.11, 1.21.10, 1.21.9]

Tired of clunky, screen-hogging interfaces ruining your survival immersion? Xaero’s Minimap Mod is the ultimate solution for players who want a seamless, vanilla-style navigation tool. As the first-ever rotating square minimap created for Minecraft, it blends perfectly into the game’s original aesthetic while packing an incredibly powerful set of features under the hood.

Important Warning: Do not install the XaeroPlus addon alongside this mod. It is completely unaffiliated with the original creator, causes untrackable crashes, and is reportedly linked to server griefing groups that could compromise your builds.

To keep multiplayer environments balanced, the mod comes in two distinct editions: Full (uncapped features) and Fair-play (disables the entity radar and cave maps, making it the perfect choice for strict PvP servers).

Core Features and Highlights of Xaero’s Minimap

Xaero’s Minimap offers a massive arsenal of customization options (accessible by pressing Y) to fit any playstyle, from relaxed building to hardcore raiding.

• Flawless Vanilla Integration: Choose between a classic square or a sleek circular map shape. If you prefer a static map, you can lock the rotation and use a clean directional arrow for your character instead.
• Advanced Entity Radar: Instantly spot other players, friendly mobs (yellow dots), hostile threats, and dropped items (red dots). Want more detail? You can swap the standard colored dots for actual mob heads and icons.
• Infinite Waypoints System: Never lose your base again. Press B to drop a waypoint that renders both on the minimap and directly in the physical game world. You can categorize them into sets, share your coordinates in the server chat, and instantly teleport to them. Plus, if you die, the mod automatically generates a skull-shaped deathpoint so you can recover your loot.
• Automatic Cave Mode: The moment you go underground or step beneath a massive solid roof, the map instantly shifts to display the subterranean layouts around you.
• Total UI Control: Enjoy smoother performance than most alternative map mods. You can move the minimap literally anywhere on your screen (even shift it by a single pixel), tweak the zoom levels, and display real-time data directly under the map: your exact coordinates, current biome, light levels, and the in-game time.
• World Map Synergy: If you install Xaero’s World Map, the minimap will automatically pull its textures. This prevents the game from rendering the map twice, drastically boosting your PC’s performance.

Xaero’s Minimap Mod Troubleshooting: Waypoints and Teleportation

Why isn’t waypoint teleportation working?

When you click teleport, the mod automatically types a vanilla chat command (like /tp @s x y z). If you are playing on a modded server with custom plugins, you might not have OP rights, or the server might block the @s selector. The fix: Open the minimap settings, find the Default Teleport Command option, and tweak the syntax to match your specific server’s requirements.

Grayed-out teleport button?

You are likely in the wrong “sub-world” dimension. Open the waypoints menu (press U), verify you are in the correct dimension list, and click Make Sub-world Auto in the options menu to sync your location data.

Lost your server waypoints?

Don’t panic—they aren’t deleted! This usually happens if a server changes its IP address or a custom plugin breaks the vanilla compass mechanics.

1. Open the waypoints menu (U).
2. Select your old server address from the top-left dropdown menu.
3. Click Options -> Make World/Server Auto.
4. Check the top-right dropdown to ensure your current sub-world (like the Overworld) has the (auto) tag next to it.

Server Admin Configuration

Want to restrict the entity radar or cave mode on your multiplayer project?

• For modern setups (Version 25.3.0+): Install the mod server-side (Forge/NeoForge/Fabric) and use the in-game Minimap Server Settings keybind. You can instantly enforce rules and lock specific features for everyone online.
• For older versions: A xaero/minimap config file will automatically generate in your server’s root directory, allowing you to toggle feature access.
• For Vanilla Servers (No Server-Side Mods): You can restrict client features using hidden color codes in your server’s login message (MOTD). Adding §n§o§m§i§n§i§m§a§p will disable the mod entirely for anyone joining, while §f§a§i§r§x§a§e§r§o forces all players into the balanced Fair-play mode.

Custom Entity Icons

Since version 21.6.0, you can easily override the default entity heads using a standard resource pack. The mod automatically pulls textures bound to the mob models. To add your own custom sprites, extract the mod’s .jar file and navigate to /assets/xaerominimap/entity/icon/definition/ to find the JSON templates you need to get started.

Developer API Setup

If you are coding your own modpack or addon and want to hook into Xaero’s API, add the ChocolateMinecraft repository to your build.gradle script:

Gradle

repositories { 
    maven { 
        url "https://chocolateminecraft.com/maven" 
        name "Xaero's Maven" 
    } 
}

Then, declare the dependency based on your platform. For Forge (1.21.1 and newer): implementation "xaero.minimap:xaerominimap-forge-<minecraft version>:<mod version>"

For Fabric projects: modImplementation "xaero.minimap:xaerominimap-fabric-<minecraft version>:<mod version>"

Q&A