Xaero's World Map

3,406,333 Downloads Last Updated: Aug 5, 2020 Game Version: 1.16.1

This mod is sponsored by:

Xaero's World Map mod adds a self-writing fullscreen map to your Minecraft client. Works as a separate mod but is a lot better with Xaero's Minimap. The reason why it's available separately is to keep Xaero's Minimap as light-weight as possible.

The mod is still in development! Please report any bugs that you encounter or otherwise they probably won't get fixed. 

Make sure your world is optimized (Singleplayer - Edit - Optimize World) for the Minecraft version you're playing (repeat after every Minecraft update). It takes A LOT longer to generate singleplayer maps from unoptimized world saves.


  • Self-writing world map (as opposed to manual paper maps). Different for every world/dimension/server.
  • Works in Singleplayer, Multiplayer and on Realms.
  • Intuitive interface. Open by pressing M. Move the map around with your mouse and zoom in/out using the mouse wheel, similar to Google Maps.
  • Automatic MultiWorld / Lilypadded etc servers support.
  • Minecraft Realms support (also with MultiWorld support).
  • Texture Pack support. Changing the texture packs updates the whole world map.
  • Cave dimensions support (for example Nether).
  • Vanilla maps mode. Makes the world map look like vanilla paper maps.
  • Terrain texture customization.
  • "Footsteps" showing your most recent path.
  • Optional performance boosters. Although in most cases the mod performs great even without them.
  • Xaero's Minimap integration. The minimap mod will display chunks loaded by the world map. The world map mod will display waypoints from the Xaero's Minimap. Also works with Better PVP mod. You can edit and teleport to the waypoints without leaving the map interface.
  • Off-screen waypoint menu that can be opened on the map GUI by placing the mouse cursor in the bottom-right corner of the screen. Selecting a waypoint from the menu with the mouse scroll wheel and clicking the right mouse button will quickly move the map view to the selected waypoint to speed-up map scrolling.
    You can also start typing a part of a waypoint's name to filter out unwanted waypoints. Pressing ENTER will restart the search.

You are allowed to make videos using this mod. Using it in your modpacks is ALLOWED as long as a link to one of my mod pages is provided and you do not profit from it (Curse modpacks are OK though). I'm very likely to make an exception for commercial use if you contact me!


Go To The Forum Thread | Get Xaero's Minimap

Try my new Android game if interested!

Flare Jump

You can support me on Patreon:


How to install the Fabric version:

  • Download and install the Fabric Loader.
  • Download Fabric API and put it in the "mods" folder in the Minecraft game directory.
  • Download the Fabric version of the map mod for your Minecraft version and put it in the mods folder.
  • Start the Fabric game "installation" using the Minecraft launcher. 

Why does the world map ask for confirmation?

A single server address can have multiple overworlds, nethers etc. It can be due to multiple sub-servers or just multiple world saves, for example a "Lobby" world and a "Game" world. Different worlds don't have any unique identifiers on the client side, which makes it impossible to reliably differentiate between them. Because of this, the world map mod lets you have multiple world maps for each dimension on the same server address. By default, map selection is Manual, which means that you are asked to confirm which map to use every time you switch dimensions/worlds/sub-servers. You can also choose one of the 2 automatic modes. Map selection is done in a special menu by clicking the bottom left icon on the world map screen (if the menu isn't open my default). In the menu you can switch between Manual, World Spawn and Single modes and select/create maps by using the top dropdown menu. If you hover over the Map Selection option, you can read everything you need to know about each map selection mode. World Spawn mode is the equivalent of what was used by the world map pre 1.6, but it's now improved with the possibility of changing which map is used on what world. So you don't have to downgrade the mod to still use it.

Your world map has "reset" for a specific server?

Do not panic. It's almost certainly not actually deleted (this has never happened as far as I know). Old world map versions use a world spawn-based system to separate a server into multiple maps. This system often breaks because of servers adding custom functionality to the vanilla compass item by sending fake world spawn coordinates to your game client. Make sure you update the mod to the latest version. There are now multiple map selection modes you can choose between, Manual being the default one. You can now view any world map you have on the current server address. Click the bottom left icon on the world map to open the map selection menu, if it's not open by default. There you can hover over the map selection mode option to read about how each mode works. Manual mode is the safest and should work on every server. You can even keep using the world spawn-based system by picking World Spawn mode. Choose what map is bound to your current spawn by "confirming" the selected map. It's something you couldn't do in older versions. Or, if it's a simple server with a single world, then choose Single mode. Message me or leave a comment if you have questions!

Here's the old explanation if you can't update the mod to 1.6.1 or newer:

Do not panic. It's almost certainly not actually deleted (this has never happened as far as I know). It's likely caused by a server plugin changing the behavior of the vanilla compass item and interfering with the mod's "multiworld" detection. In most such cases the compass item points to your bed instead of the global spawn point. Sleeping in the right bed again should bring everything back for you if sleeping in another one was the cause of the map "resetting".
If the map "reset" because of a new plugin being added (and if removing it is not an option for you), then here's how you can restore your map (and hope the plugin doesn't do it again):

Make sure Minecraft is NOT RUNNING.

1. Go to the game directory

2. Go to the XaeroWorldMap directory

3. Find directories that represent the dimensions you have visited on the server. These directories contain the address of the server in their name. The one that ends with _null is the overworld, _dim-1 is Nether etc.

4. Open the overworld directory (_null).

5. You should see multiple directories that start with mw.

6. Find the one that is the biggest in file size. Copy the name of it somewhere so you don't lose it.

7. Now find the newest mw directory (likely the emptiest or just check the creation date). Move this directory somewhere else. Don't delete it just yet.

8. Rename the directory from step 6 to the name of the backed up directory from step 7.

9. Open Minecraft and test if the overworld world map is back.

10. If it's not, exit Minecraft and restore the old name of the directory that you have renamed + restore the backed up folder. Reread all the steps to make sure you're doing everything right.
If overworld is now fixed, proceed to step 11.

11. Rename and backup the directories with the same names as overworld for every other dimension that you'd like to restore.

Contact me if you have questions!


  • To post a comment, please or register a new account.
Posts Quoted: