How to Download and Install Xaero’s Minimap for Minecraft

Banner image for Xaero’s Minimap showing a circular in-game minimap over a blurred Minecraft terrain background with the mod’s title above.

Want to add a minimap to your Minecraft world? Xaero’s Minimap is one of the best out there. It shows you where you are, sets waypoints, and even helps you find your base or favorite biome again.

In this guide, we’ll show you how to install Xaero’s Minimap step-by-step for Minecraft. It’s quick, easy, and works with Forge.

⚠️ Important

Java 21 it’s required for mods to work in any Minecraft 1.20.4 and above. Learn how to install Java 21 here.

Quick Navigation

Promotional banner for Apex Hosting offering 25% off Minecraft server hosting with over 300 modpacks, 24/7 worldwide servers, and instant setup.

What is Xaero’s Minimap?

Xaero’s Minimap is a client-side Minecraft mod that shows a live minimap on your screen. It helps you navigate, place waypoints, and never get lost again. You can even customize it — from position to size and colors.

Best part? It works in both single-player and multiplayer, since it doesn’t affect the server.

Step 1: Download Xaero’s Minimap

The first step before we install Xaero’s Minimap is to download it.

Download button to be redirected to the Xaero's Minimap download page.

  • Pick the Forge version (unless you’re using a different mod loader like Fabric or NeoForge) and click the three dots next to the version.
Xaero’s Minimap download page on CurseForge showing available mod versions for Fabric, NeoForge, and Forge with the download menu highlighted.

💡 TIP: Use the filters to choose the version you want to match your Minecraft.

  • Hit Download file and wait 5 seconds for the download to begin.
Mouse cursor selecting the “Download file” option for Xaero’s Minimap Forge version on CurseForge for Minecraft.

💡 TIP: Make sure you download the file that matches your Minecraft version.

Save the file to your Desktop for easy access.

After we download Xaero’s Minimap, it is time to install Forge. Let’s move onto the next step.

Step 2: Install Forge for Minecraft

In the previous step we downloaded the Xaero’s minimap mod, now let’s go ahead and install Forge so we can use the mod in Minecraft.

This is a short summary, for the full detailed guide on how to install Forge click here.

If you already have Forge installed, you can skip this step.

  • Go to the Forge download page.
  • Select the Minecraft version that matches your Xaero’s version from the menu.
  • Click the Installer button. Wait 5 seconds, then hit Skip to begin the download.
  • Once downloaded, right-click the file and choose Open with → Java.
  • Choose Install Client and press OK.
  • Wait for the confirmation message and then close the installer.

⚠️ Important: Before installing Forge, make sure you’ve launched the matching Minecraft version at least once.

After installing Forge, we’re ready to place the mod in the right folder.

Step 3: Install Xaero’s Minimap

Now that we downloaded our Xaero’s Minimap file, and after we installed the proper mod loader, it is time to add the minimap into Minecraft.

  • Press Windows + R and type %appdata%\.minecraft, then press Enter. You can also manually locate your Minecraft instance.
Windows Run dialog box with the path %appdata%\.minecraft entered, used to access the Minecraft installation folder.

  • Look for a folder called mods. If you don’t see it, create one and name it mods.
Minecraft directory showing the creation of the "mods" folder, where players place mod files like Xaero’s Minimap for installation.

  • Drag and drop the Xaero’s Minimap .jar (Download from the first step) file into this folder.
Xaero’s Minimap mod file placed inside the Minecraft mods folder, ready for use with Forge.

💡 TIP: Only place mods that match your Minecraft and Forge version in this folder.

We have now installed Xaero’s Minimap for Minecraft. Let’s open the game and try it out.

Step 4: Test Xaero’s Minimap

Open the Minecraft Launcher, but don’t hit Play yet.

  • Select the Forge profile from the dropdown menu next to the Play button.
Minecraft Launcher showing the Forge profile selected, ready to launch with installed mods like Xaero’s Minimap.
  • Click Play.
  • Once Minecraft loads, click Mods from the main menu.
Minecraft Mods menu showing Xaero’s Minimap successfully installed and detected under Forge.

You should see Xaero’s Minimap listed. If you do, you’re good to go!

To test it, open a world and look for the minimap in the top left. Press Y on your keyboard to open the settings and customize the look and feel of your minimap.

In-game Minecraft screenshot showing Xaero’s Minimap active in the top-left corner while exploring a snowy biome.

That is it! You can now enjoy Xaero’s Minimap on Minecraft.

Extra Tips

  • If the game crashes, double-check that the mod and Forge versions match.
  • If Forge won’t open, make sure you have Java 21 installed.
  • You can install Xaero’s World Map too, which works with the minimap for extra features.

Final Thoughts

Now you’re ready to explore with confidence using Xaero’s Minimap in Minecraft 1.21.5. It’s one of the most helpful mods out there, and it’s easy to set up.

We recommend pairing your Xaero’s Minimap with some nice shaders. Check out our Top 10 Free Shaders for Minecraft.