How to Install Xaero's Minimap in Minecraft

Xaero's Minimap is one of the most popular client-side mods for Minecraft, adding a real-time minimap to your HUD that displays terrain, waypoints, cave layers, and player/mob positions. Installing it correctly depends on a few key factors — most importantly, which mod loader you're using and which version of Minecraft you're running.

What Xaero's Minimap Actually Does

Unlike the in-game map item, Xaero's Minimap renders a persistent, always-visible minimap in a corner of your screen. It updates as you explore, supports waypoints you can set and teleport to (on servers that allow it), and includes a cave maps mode that switches between surface and underground layers automatically.

There are two versions of the mod:

• Xaero's Minimap — the free version, fully functional for most players
• Xaero's Minimap Fair-Play Edition — designed for multiplayer servers where minimap advantages (like entity radar) are restricted

Both install identically. The difference is purely in what features are enabled by default.

What You Need Before You Start

Xaero's Minimap is not a standalone installer. It requires a mod loader to run. The two supported loaders are:

You'll also need:

• Java installed (bundled with the Minecraft launcher in most cases)
• The correct Minecraft version matching your loader and the mod version
• Fabric API (if using Fabric) — Xaero's Minimap on Fabric requires this as a dependency

If you're playing in a modpack (like via CurseForge or Modrinth), the mod loader is likely already set up.

Step-by-Step: Installing Xaero's Minimap

Step 1 — Install a Mod Loader

If you haven't already, install either Forge, Fabric, or NeoForge for your target Minecraft version.

• Forge: Download from files.minecraftforge.net, run the installer JAR, and select "Install client"
• Fabric: Download the installer from fabricmc.net, select your Minecraft version, and click Install
• NeoForge: Available at neoforged.net, same installer process as Forge

Each creates a new profile in the Minecraft launcher automatically.

Step 2 — Download Xaero's Minimap

Go to the official mod page on CurseForge or Modrinth and search for "Xaero's Minimap." 🗺️

Critical: Match the mod version to both your Minecraft version and your mod loader. Downloading the Fabric version when you're running Forge (or vice versa) is the most common cause of installation failure. The mod page lists compatible versions explicitly — always check the file details before downloading.

Step 3 — Add Fabric API (Fabric Users Only)

If you're on Fabric, download Fabric API from CurseForge or Modrinth. This is a required dependency — Xaero's Minimap will not load without it. Download the version that matches your Minecraft version.

Step 4 — Place the JAR in Your Mods Folder

1. Open the Minecraft launcher and click Installations
2. Find your modded profile and click the folder icon, or navigate manually to your .minecraft folder
3. Open (or create) the mods folder
4. Drop the downloaded .jar file(s) into this folder — including Fabric API if applicable

Default mods folder locations:

• Windows:%AppData%.minecraftmods
• macOS:~/Library/Application Support/minecraft/mods
• Linux:~/.minecraft/mods

Step 5 — Launch and Verify

Launch Minecraft using your modded profile. On the main menu, check the Mods button (Forge/NeoForge) or Mods tab in the title screen (Fabric with ModMenu installed). Xaero's Minimap should appear in the list.

Once in a world, the minimap renders in the top-right corner by default. Press Y to open the minimap settings menu, where you can adjust size, position, zoom, waypoints, and entity display options.

Common Issues and What Causes Them

Minimap doesn't appear in-game Usually a version mismatch. Double-check that the mod JAR, your mod loader, and your Minecraft version all match exactly. A mismatch of even a minor version (1.20 vs 1.20.1) can prevent the mod from loading.

Game crashes on launch Often caused by a missing dependency (Fabric API on Fabric builds) or a conflict with another mod. Check the crash log in .minecraft/crash-reports — it usually names the conflicting mod directly.

Multiplayer server shows a warning about the minimap Some servers detect minimap mods and will prompt you to use the Fair-Play Edition instead. This version disables entity radar and certain features that give competitive advantages. The installation process is identical — just swap the JAR file.

Variables That Shape Your Experience 🎮

How well Xaero's Minimap performs and which configuration makes sense depends on several factors:

• Mod loader ecosystem — If you're already running a Forge or Fabric modpack, your loader choice is already decided
• Minecraft version — Older versions may have fewer supported mod versions or miss newer minimap features
• Server type — Singleplayer, co-op, or competitive multiplayer each call for different feature settings (especially entity radar)
• System performance — The minimap renders chunks as you explore; on lower-end systems, rendering settings may need adjustment
• Paired mods — Xaero's Minimap pairs closely with Xaero's World Map (a separate mod by the same developer), and many players install both together

Players running curated modpacks through launchers like CurseForge, Prism Launcher, or ATLauncher may find the mod pre-included — in which case the installation is handled automatically and individual JAR management isn't needed.

The right configuration — which version, which features enabled, whether to pair it with the world map mod — comes down to what kind of Minecraft experience you're building and the environment you're playing in.