Xaero's World Map

xaero96's fullscreen map that draws itself from the chunks you explore, opened with M and panned like an online map. It keeps separate maps per world on the same server, has a cave mode for the Nether, and becomes a waypoint editor when Xaero's Minimap is installed.

97M+ Downloads by xaero96

About Xaero's World Map

Xaero's World Map is a client-side mod by xaero96 that turns every chunk your game loads into a fullscreen map, opened with M and moved around with the mouse and scroll wheel like an online map. It is "self-writing": nothing appears until you have been near it, and the map grows as you explore. It works in singleplayer, on servers and on Realms, and it is published separately from Xaero's Minimap so that the minimap stays light for anyone who wants only the corner view.

How the map fills in

In multiplayer the map records what your client receives from the server, so it covers the area inside your render distance as you travel. In singleplayer it reads the world save directly, which is faster and complete for everywhere the world has generated. Two consequences follow. A world pre-generated with a separate tool shows up in full once you relog and run Reload Regions from the map settings. And a save that has not been optimized for the current Minecraft version takes, in the author's words, a lot longer to map, so Singleplayer, Edit, Optimize World after each game update is worth the wait.

On a server you cannot read the save, but there is a workaround the author documents. If you can download the server's world, open it in singleplayer, let the map generate, then use Convert All Regions to produce a multiplayer map instance you can copy into the server's folder under xaero/world-map.

The map is drawn from the current resource pack's textures, so changing packs makes the whole map regenerate. A vanilla maps mode gives it the look of paper maps instead, and the terrain shading can be adjusted.

One server address, several maps

A single server can host many worlds: a lobby, a survival world, a creative plot world, each with its own overworld and Nether. The client has no reliable way to tell them apart, so the mod lets one server address hold several maps per dimension and switch between them. The bottom-left icon on the map screen opens map selection, with these modes:

  • Manual asks you to confirm the map every time you change world or dimension. It is the safest mode when nothing else works.
  • World Spawn tells worlds apart by their spawn point, as versions before 1.6 did. Plugins that fake the spawn point (some change what the compass points at) can confuse it.
  • Single uses one map per dimension, fine for a plain one-world server.
  • Server lets the server pick the map from its own internal level IDs. The author calls it the best option in most cases, and it needs the mod installed on the server.

This is also why the map sometimes asks for confirmation: it is protecting one world's map from being painted over with another's. Changing the mode can drop you onto an empty map. Nothing is lost when that happens: pick the old map from the dropdown and confirm it again.

Caves and the Nether

Cave mode shows the layer below a chosen height instead of the surface, and it is set per dimension. Setting the Cave Mode Type to Full in the Nether shows the tunnels under the bedrock roof rather than the roof itself, and the Cave Mode Top Y setting moves the cut. Nether-like dimensions from other mods can be set the same way. Because the type is stored per dimension, the overworld can stay on its surface view while the Nether always opens in cave mode. If you use the fair-play edition of the minimap, it disables the world map's cave mode in the Nether, and servers can switch cave mode off for everyone.

Working with the minimap

Installed together, the two mods share their work. The corner map stops rendering terrain for itself and draws from the world map's cache instead, an arrangement the author says is lighter on performance. The world map shows the minimap's waypoints, and you can create, edit and teleport to them from the map. The icon in the bottom-right corner opens a waypoint list you can filter by name. Right-clicking a spot on the map teleports you there through a separate setting, Map Teleport Command, so the same /tp permission applies as for the minimap's waypoints.

Keep the pair on matching generations. Current World Map files refuse minimap versions older than 26.4.0, while the minimap in turn will not start beside a World Map below 1.44.0, so updating one without the other ends in a crash at launch.

Other tools on the map

  • Footsteps trace the path you most recently took.
  • PNG export saves the whole map as an image. The author notes it may fail for maps millions of blocks across.
  • Open Parties and Claims integration shows claimed chunks and allied players, and lets you claim or forceload chunks straight from the map.
  • Tracked players, such as party members from Open Parties and Claims, can be teleported to with a right-click, using a separate Player Teleport Command.
  • Performance settings exist for large maps or slow machines, although the author expects the defaults to perform well in most cases.
  • Item-gated access: a line such as mapItemId:minecraft:compass in the config hides the map until the player holds or wears that item.

For server owners

The server copy is optional, but it enables Server map selection, and World Map 1.40.0 added an Open Server Settings key binding whose screen lets admins lock almost any option, cave mode among them. Enforcement can follow ranks through the xaero.world_map.enforced_server_profile permission, and the xaeroworldmap:no_world_map effect switches the map off for a player. As with the minimap, players without the mod cannot join until the status effect registration option in config/xaero/world-map on the server is turned off.

A map that looks reset

The data is almost certainly still on disk, in the game directory under xaero/world-map (XaeroWorldMap in old versions). First check map selection: the old map may simply be another entry in the dropdown. If the server's address changed, the map sits in a folder named after the old address. Back up the whole folder, close the game, remove the empty folder created for the new address and rename the old one to match. Dimensions have their own subfolders (null for the overworld, DIM-1 for the Nether, DIM1 for the End) if a dimension ID changed instead.

The World Map installs on its own, but most players add Xaero's Minimap in the same step, so both are covered here.

How to Download Xaero's World Map for Minecraft

The Xaero's World Map Downloads section has a row for each pairing of Minecraft version and loader. Pick yours and press Download, which hands you over to the file on Modrinth. Fabric files also cover Quilt.

How to Install Xaero's World Map in Minecraft

  1. Prepare a Fabric, NeoForge or Forge profile matching your Minecraft version.
  2. Place the World Map jar in the mods folder, plus Fabric API on Fabric, or XaeroLib with the Forge 1.12.2 and 1.16.5 builds. Every newer file already carries XaeroLib, the library both Xaero mods share, inside the jar.
  3. If you want the minimap too, take it from the Xaero's Minimap Downloads section for the same version and loader. Install the two at the same time, since each refuses an outdated copy of the other.
  4. In singleplayer, optimize older worlds first (Singleplayer, Edit, Optimize World), which makes the first mapping pass much faster.
  5. When updating, replace the old jar instead of adding a second one next to it.
  6. Join a world and press M.

On a server

A server copy is optional: add the jar to a Fabric, NeoForge or Forge server's mods folder. It enables Server map selection and the admin settings screen. Before vanilla players join, switch off status effect registration in config/xaero/world-map on the server and restart it.

First run

An empty map is normal in multiplayer: it fills in as you move. If the map asks you to confirm a map, choose the one for the world you are in, then open map selection from the bottom-left icon and pick a mode that suits the server. On a server running the mod, Server mode stops the question for good.

A crash on start usually comes from a missing Fabric API, the wrong loader's file, or the two Xaero mods being a generation apart. Anything else is covered in fixing mods that will not load. Maps live in the game directory under xaero/world-map, which is the folder to carry over when you change instances.

Download Xaero's World Map

Release status VersionMinecraft version Platform / LoaderReleased Download
forge-26.3-1.46.4Latest versionRelease 26.3 Forge Download
neoforge-26.3-1.46.4Latest versionRelease 26.3 NeoForge Download
fabric-26.3-1.46.4Latest versionRelease 26.3 Fabric, Quilt Download
fabric-26.2-1.46.1Release 26.2 Fabric, Quilt Download
neoforge-26.2-1.46.1Release 26.2 NeoForge Download
forge-26.2-1.46.1Release 26.2 Forge Download
forge-26.1.2-1.46.0Release 26.1.2 Forge Download
neoforge-26.1.2-1.46.0Release 26.1.2 NeoForge Download
fabric-26.1.2-1.46.0Release 26.1.2–26.1 Fabric, Quilt Download
forge-1.21.11-1.46.0Release 1.21.11 Forge Download
neoforge-1.21.11-1.46.0Release 1.21.11 NeoForge Download
fabric-1.21.11-1.46.0Release 1.21.11 Fabric, Quilt Download
forge-1.21.10-1.46.0Release 1.21.10 Forge Download
neoforge-1.21.10-1.46.0Release 1.21.10 NeoForge Download
fabric-1.21.10-1.46.0Release 1.21.10 Fabric, Quilt Download
1.39.18_Forge_1.21.9Release 1.21.9 Forge Download
1.39.17_Fabric_1.21.9Release 1.21.9 Fabric, Quilt Download
1.39.17_NeoForge_1.21.9Release 1.21.9 NeoForge Download
forge-1.21.8-1.46.0Release 1.21.8 Forge Download
neoforge-1.21.8-1.46.0Release 1.21.8 NeoForge Download
fabric-1.21.8-1.46.0Release 1.21.8 Fabric, Quilt Download
1.39.12_Fabric_1.21.7Release 1.21.7 Fabric, Quilt Download
1.39.12_NeoForge_1.21.7Release 1.21.7 NeoForge Download
1.39.12_Forge_1.21.7Release 1.21.7 Forge Download
1.39.11_NeoForge_1.21.6Release 1.21.6 NeoForge Download
1.39.10_Fabric_1.21.6Release 1.21.6 Fabric, Quilt Download
forge-1.21.5-1.46.0Release 1.21.5 Forge Download
neoforge-1.21.5-1.46.0Release 1.21.5 NeoForge Download
fabric-1.21.5-1.46.0Release 1.21.5 Fabric, Quilt Download
forge-1.21.4-1.46.0Release 1.21.4 Forge Download
neoforge-1.21.4-1.46.0Release 1.21.4 NeoForge Download
fabric-1.21.4-1.46.0Release 1.21.4 Fabric, Quilt Download
fabric-1.21.3-1.40.6Release 1.21.3 Fabric, Quilt Download
forge-1.21.3-1.40.6Release 1.21.3 Forge Download
neoforge-1.21.3-1.40.6Release 1.21.3 NeoForge Download
forge-1.21.1-1.46.0Release 1.21.1–1.21 Forge Download
neoforge-1.21.1-1.46.0Release 1.21.1–1.21 NeoForge Download
fabric-1.21.1-1.46.0Release 1.21.1–1.21 Fabric, Quilt Download
1.39.12_Forge_1.20.6Release 1.20.6–1.20.5 Forge Download
1.39.12_Fabric_1.20.6Release 1.20.6 Fabric, Quilt Download
1.39.12_NeoForge_1.20.6Release 1.20.6 NeoForge Download
1.39.4_Fabric_1.20.6Release 1.20.5 Fabric, Quilt Download
1.38.8_NeoForge_1.20.6Release 1.20.5 NeoForge Download
forge-1.20.4-1.46.0Release 1.20.4–1.20.3 Forge Download
neoforge-1.20.4-1.46.0Release 1.20.4–1.20.3 NeoForge Download
fabric-1.20.4-1.46.0Release 1.20.4–1.20.3 Fabric, Quilt Download
1.39.12_Fabric_1.20.2Release 1.20.2 Fabric, Quilt Download
1.39.12_Forge_1.20.2Release 1.20.2 Forge Download
1.39.12_NeoForge_1.20.2Release 1.20.2 NeoForge Download
forge-1.20.1-1.46.0Release 1.20.1–1.20 Forge Download
fabric-1.20.1-1.46.0Release 1.20.1–1.20 Fabric, Quilt Download
1.36.0_Forge_1.20Release 1.20.1 NeoForge Download
1.39.12_Fabric_1.19.4Release 1.19.4 Fabric, Quilt Download
1.39.12_Forge_1.19.4Release 1.19.4 Forge Download
1.37.8_Fabric_1.19.3Release 1.19.3 Fabric, Quilt Download
1.37.8_Forge_1.19.3Release 1.19.3 Forge Download
forge-1.19.2-1.46.0Release 1.19.2–1.19.1 Forge Download
fabric-1.19.2-1.46.0Release 1.19.2–1.19.1 Fabric, Quilt Download
forge-1.18.2-1.46.0Release 1.18.2 Forge Download
fabric-1.18.2-1.46.0Release 1.18.2 Fabric, Quilt Download
1.37.8_Fabric_1.17.1Release 1.17.1–1.17 Fabric, Quilt Download
1.37.8_Forge_1.17.1Release 1.17.1 Forge Download
fabric-1.16.5-1.46.0Release 1.16.5 Fabric, Quilt Download
forge-1.16.5-1.46.0Release 1.16.5 Forge Download
fabric-1.16.5-1.41.2Release 1.16.4–1.16.2 Fabric, Quilt Download
forge-1.16.5-1.41.2Release 1.16.4–1.16.2 Forge Download
1.29.17_Forge_1.15.2Release 1.15.2 Forge Download
1.29.17_Forge_1.14.4Release 1.14.4 Forge Download
forge-1.12.2-1.46.0Release 1.12.2 Forge Download
1.14.1.31_Forge_1.8.9Release 1.8.9 Forge Download
1.14.1.33_Forge_1.7.10Release 1.7.10 Forge Download

FAQ

Do I need Xaero's Minimap to use Xaero's World Map?

No. The World Map works on its own. With the minimap installed, its waypoints appear on the world map and the minimap borrows the terrain the world map has already drawn.

How do I open Xaero's World Map?

Press M in game. Drag with the mouse to move and use the scroll wheel to zoom. The key can be changed in the vanilla Controls menu.

Why is my world map blank on a server?

The map only records chunks your client has loaded, so it starts empty and fills in as you explore. It cannot reveal areas you have not been near.

Why does Xaero's World Map keep asking me to confirm a map?

Manual map selection asks whenever you change world or dimension, because the client cannot tell a server's worlds apart on its own. Switch to another mode in the map selection menu, or use Server mode when the server has the mod.

Can I see the whole world without walking everywhere?

In singleplayer, yes: pre-generate the world, relog and use Reload Regions. On a server, only if you can download the world, map it in singleplayer and use Convert All Regions to make a copy for the server.

Can I export the map as an image?

Yes. The map has a PNG export option. The author notes it may fail for maps that are millions of blocks across.

My world map reset. Is it gone?

Almost certainly not. Check the map selection dropdown first, then the xaero/world-map folder in your game directory, where a changed server address or dimension ID leaves the old map in a differently named folder.

Does Xaero's World Map work with resource packs?

Yes. It draws the map from your current pack's textures, and changing resource packs regenerates the whole map.

Related
Mod · Fabric / NeoForge

Simple Voice Chat

henkelmax's proximity voice chat for Minecraft: Java Edition. Nearby players hear each other with directional audio that fades with distance, and push to talk, voice activation, whispering and password-protected groups cover the rest. Voice runs through the server, so the server and every player need it installed.

Mod · NeoForge / Fabric

Just Enough Items (JEI)

Just Enough Items (JEI) is an item and recipe viewer by mezz. It lists every item in the game, vanilla and modded, in a searchable panel beside your inventory. One key shows the recipes that make an item, another shows what it is used for, and that includes machine recipes from mods that support JEI. Bookmarks and a cheat mode for testing round it out.

Mod · Forge / NeoForge

Xaero's Minimap

xaero96's vanilla-styled minimap: a square or round map in the corner of the screen with an entity radar, automatic cave mode and waypoints you can share, teleport to and sort into sets. It works on any server from your own game, and a server copy adds world identification and admin controls.