Xaero's World Map

<p><img src="https://chocolateminecraft.com/images/worldmapbanner.png" width="965" height="643" /></p>

Do not use XaeroPlus with this mod! It is not affiliated with me and causes critical untrackable bugs/crashes. It is also allegedly affiliated with a server griefing group, which can put your server builds at risk.

<p>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. <strong>This mod is mostly client-sided. Installing it on the server side is optional for some additional features like world identification.</strong></p> <p>The mod is still in development! Please report any bugs that you encounter or otherwise they probably won't get fixed.&nbsp;</p> <p><strong>Make sure your world is optimized (<em>Singleplayer - Edit - Optimize World</em>) 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.</strong></p>

Follow me on Mastodon (Twitter alternative)? <a href="https://mas.to/@xaero96" target="_blank" rel="nofollow noopener noreferrer">mas.to/@xaero96</a>

Support me on Patreon? <a href="https://bit.ly/PatreonXaero96" target="_blank" rel="nofollow noopener noreferrer"><span style="text-decoration: underline;">patreon.com/xaero96</span></a>

<p>Thank you!</p>

Features

<ul> <li>A self-writing world map (as opposed to manual paper maps). You can create multiple maps on the same server address and switch between them either manually or automatically.</li> <li>Works in Singleplayer, Multiplayer and on Realms.</li> <li>Intuitive interface. Open the map screen by&nbsp;<strong class="bbc">pressing M</strong>. Move the map around with your mouse and zoom in/out using the&nbsp;<strong class="bbc">mouse wheel</strong>, similar to Google Maps. All relevant controls are listed in a tooltip on the map screen and you can customize a lot of them.</li> <li>Optional automatic multiple world detection on servers.</li> <li>Server-sided configs with an in-game UI screen that let you control in real time how players on your server are able to use the mod. You can base it on ranks/permission (xaero.world_map.enforced_server_profile). Supports FTB Ranks, Odyssey Roles, LuckPerms and general permission APIs.</li> <li>Displays chunk claims and ally players from the <a href="https://modrinth.com/mod/open-parties-and-claims" target="_blank" rel="noopener noreferrer">Open Parties and Claims</a> mod. Lets you claim or forceload chunks directly from the map.</li> <li>Resource pack support. Changing the resource packs causes the whole world map to regenerate.</li> <li>Cave dimensions support (for example the Nether).</li> <li>Optional vanilla maps mode, which makes the world map look like the vanilla paper maps.</li> <li>Terrain shading customization.</li> <li>"Footsteps" that show you your most recent path taken.</li> <li>Settings that can help improve the performance of the mod when necessary. Although in most cases the mod should perform great by default.</li> <li><a href="https://modrinth.com/mod/xaeros-minimap" target="_blank" rel="noopener noreferrer">Xaero's Minimap</a>&nbsp;integration. The minimap mod will display chunks provided by the world map. The world map mod will display waypoints from the Xaero's Minimap mod. Also works with the&nbsp;<a href="https://www.planetminecraft.com/mod/164-better-pvp-v10/" target="_blank" rel="noopener noreferrer">Better PVP mod</a>. You can create, edit and&nbsp;<strong class="bbc">teleport to the waypoints</strong>&nbsp;without leaving the map interface.</li> <li>Potion effects to control the usage of the world map for the players on your server/map. The following potion effects exist as of writing this:&nbsp;<em class="bbc">xaeroworldmap:no_world_map.&nbsp;</em>The effects are of the neutral type by default, but you can also specify a harmful type by appending&nbsp;<em class="bbc">_harmful</em>&nbsp;to the end of the effect ID, for example&nbsp;<em class="bbc">xaeroworldmap:no_world_map_harmful</em>.</li> <li><strong class="bbc">Since version 1.14.0</strong>&nbsp;of the mod, you can open an on-map waypoint menu by clicking the icon in the bottom right corner of the map screen. In the waypoint menu, you can see a list of all your map waypoints from the rendered sets, interact with them with the mouse cursor, filter them by name in a text field. The menu also lets you toggle the visibility of disabled waypoints, toggle rendering all sets and change the current waypoint set. Hovering over the waypoints in the menu also acts as hovering over them on the map: they are highlighted on the map and you can use the right-click or hover controls to interact with them.</li> <li>An option to export a map as a PNG image file. The mod tries to export the whole map, so it might not work, if the map is millions of blocks in length. I'm planning to give more options for exporting the map in the future!</li> <li>Option to limit your map access by binding it to an item required in your hotbar or to be equipped. For example, add&nbsp;<em>mapItemId:minecraft:compass&nbsp;</em>anywhere in the config file to bind it to the compass item. This way the map will not work unless you have the compass in your hotbar or equipped.&nbsp;</li> </ul> <p><a href="https://modrinth.com/mod/xaeros-minimap" target="_blank" rel="noopener noreferrer"><span style="font-size: 24px; text-decoration: underline;">Get Xaero's Minimap</span></a></p>

FAQ

How do I restore pre 1.30 update Nether maps in multiplayer to be displayed in the "full" cave mode type?

<p>First, exit the server and locate the Minecraft game directory that you're using to play on the server. In the game directory, go into&nbsp;<em>xaero/world-map/Multiplayer_[server_address]/DIM-1/[map_folder]</em>. In older versions, <em>xaero/world-map</em> is simply <em>XaeroWorldMap</em>. If such doesn't exist already, create a folder called "<strong>caves</strong>", without the quotation marks, and go into it. Inside the caves folder, create a folder called "<strong>-2147483648</strong>", without the quotation marks, if such doesn't exist already. Go back into the folder that contains the "<strong>caves</strong>" folder and move all "<strong>.zip</strong>" files to the&nbsp;<strong><em>caves/-2147483648</em></strong>&nbsp;folder. Feel free to delete the cache folders or also move them with the "<strong>.zip</strong>" files.</p>

How do I set up cave mode to behave like it used to pre 1.30 before cave mode was introduced?

<p>You can fully achieve this only when using the normal version of the minimap or no minimap at all. The fair-play version of the minimap now disables world map cave mode in the Nether and you can't toggle that, so it won't be exactly like it used to be.</p> <p>If you have Nether map data from before 1.30, please start by moving it in the correct folder as explained under "<em>How do I restore pre 1.30 update Nether maps in multiplayer to be displayed in the "full" cave mode type?</em>" on this page.<br />After you're done with that, join a world/server and open the world map settings. Locate "Default Cave Mode Type" and set it to OFF and then set "Legible Cave Maps" to ON. Next, open the world map screen and click the cave icon in the bottom left of the screen. In the menu that opens, set the "Cave Mode Top Y" to absolutely any number. If you are in the overworld, set the "Cave Mode Type" to OFF. When you are in the Nether later, set&nbsp;"Cave Mode Type" to Full. The cave mode type is stored per dimension, so you can set it to Full for any nether-like dimension and keep it on OFF for anything else. You can also switch between displaying below and above bedrock roof by toggling it.</p>

Why does right-click teleportation not work for me?

The mod sends a chat command to teleport you to specific coordinates, which is /tp @s x y z by default, so appropriate permission is necessary. The vanilla /tp command requires OP status (cheats enabled) but it's possible to have separate permissions for commands on a non-vanilla server with certain plugins installed. The used command can be changed in the world map settings with "Map Teleport Command". Non-vanilla teleportation commands often don't support the selectors such as @s, so you might have to remove it from the configured command. There is also an option called "Player Teleport Command" which is used when you right click tracked players (e.g. your party from Open Parties and Claims). Teleportation to waypoints uses its own setting in the minimap mod. You can read about it on the minimap description page under FAQ.

How do I discover the map without manually walking?

<p>In singleplayer, the map is loaded directly from the world save. This means that you can pregenerate the world using whatever tools you prefer, relog and use the "Reload Regions" option in the world map settings to fix any conflicts in the map cache. In multiplayer, it isn't as simple. However, if you can download the server world save and enter the world in singleplayer, then you can pregenerate the world using a method of your choice, relog and then use the "Convert All Regions" in the world map settings to convert the whole world save to a multiplayer-compatible map instance saved to <i>xaero->world-map->World->null->cm$converted</i>. In older versions, <em>xaero/world-map</em> is simply <em>XaeroWorldMap</em>. You can copy/move that map instance folder to your server map instances in the xaero/world-map folder.</p>

Why are multiple worlds on the same server address/IP using and writing to the same map?

<p>This mod lets you have multiple maps on the same server address. You can freely switch between maps and create new ones at any time. Map overwriting can be prevented by choosing the right "Map