MapModCompanion: Seamless Multi-World Support for Xaero’s, JourneyMap, and VoxelMap
Running a Minecraft server with multiple worlds often turns mapping mods into a headache. Your players rely on minimaps and world maps to navigate, but the moment they hop between dimensions or server instances, they get hit with “world not recognized” messages. Waypoints vanish, cached map data breaks, and suddenly everyone is asking you to fix their configuration. MapModCompanion was built to eliminate that frustration entirely—without touching anyone’s in-game progress.
What Exactly Is MapModCompanion?
MapModCompanion is a lightweight server-side plugin that acts as a bridge between your server and the most popular client-side mapping mods. Instead of requiring each player to manually tweak their minimap settings for every world, the plugin simulates the presence of those mods on the server side. This trick tells Xaero’s Minimap, Xaero’s World Map, JourneyMap, and VoxelMap that everything is properly recognized, so they stop complaining about unrecognized dimensions and start working as intended.
The magic happens silently. Once installed, your players won’t need to open config files, rename folders, or fiddle with multi-world detection settings. The plugin handles it all behind the scenes, making the mapping experience feel native and polished even on complex network setups.
Supported Mapping Mods
MapModCompanion covers the four heavy hitters in the minimap and world map scene. Here’s the full compatibility table:
- Xaero’s Minimap — the lightweight, highly customizable minimap used by millions.
- Xaero’s World Map — the full-screen companion that saves explored terrain and waypoints.
- JourneyMap — a real-time mapping mod with web map integration and extensive marker support.
- VoxelMap (Refresh-MC) — a continuation of the classic VoxelMap with updated features and performance improvements.
Because the plugin simulates mod presence generically, it works with all recent versions of these mods and doesn’t require any special configuration files. If a mod is on the list, it’s supported out of the box.
How It Fixes Multi-World Detection
In a standard multiplayer environment, client-side mapping mods look for a server-side handshake that confirms “yes, I’m running this mod too.” When that handshake fails—which it always does on vanilla or lightly modded servers—the mod assumes the world is unrecognized and either disables itself or forces the player into manual setup mode. On a network with BungeeCord or Velocity, the problem multiplies because each backend server can present a different world identity.
MapModCompanion intercepts this detection process by responding to the mod’s network queries on behalf of the server. It doesn’t add any actual mod content or alter gameplay; it simply sends the right acknowledgments so the client-side mods believe they are talking to a fully compatible server. The result: waypoints remain visible across worlds, map caches stay intact, and the dreaded “world not recognized” prompt disappears for good.
Installation Guide
Setting up MapModCompanion is refreshingly simple. There are no configuration files to edit, no permissions to assign, and no commands to learn. Just drop the plugin into the correct folders and restart.
Step-by-Step Installation
- Download the latest release from the official project page (no external links needed—grab the jar from the usual release section).
- Place the jar file into the plugins folder of every Bukkit/Spigot/Paper server in your network.
- Place the same jar file into the plugins folder of your BungeeCord or Velocity proxy.
- Restart all servers and the proxy. That’s it—no configuration required.
If you’re helping your community get set up with the client-side mods themselves, a modern launcher can save everyone a ton of time. For instance, the foxygame.net launcher lets you download and install mapping mods directly from its menu, so your players don’t have to hunt for compatible files or worry about version mismatches—it’s a convenient way to keep everyone on the same page without extra tech support.
A Note on Existing Map Data
It’s strongly recommended to install MapModCompanion on a fresh server. If you add it to an existing world, some players might find that their previously saved waypoints or map caches become invisible. This happens because the mod’s internal world identification changes once the plugin is active. Fortunately, there are documented methods to restore that data—usually by relocating the old map files to the newly recognized folder structure. The plugin itself never deletes or corrupts progress, so nothing is permanently lost.
Why Your Server Needs It
Beyond the obvious quality-of-life improvement, MapModCompanion reduces the support burden on server staff. Instead of walking every new player through a multi-step configuration guide for their preferred mapping mod, you can simply point them to the mod download and let the plugin handle the rest. The experience becomes uniform across Xaero’s, JourneyMap, and VoxelMap users, regardless of which mod they prefer.
Another underrated benefit is stability. Because the plugin doesn’t modify any game mechanics or store extra data, it introduces zero performance overhead. It’s a tiny network listener that fires only when a mapping mod attempts to verify the server. Your TPS, chunk loading, and entity processing remain completely unaffected.
For network owners running minigame hubs, survival worlds, and creative plots behind a proxy, MapModCompanion is practically essential. Without it, players frequently lose their minimap context when moving between servers, leading to confusion and frustration. With it, the transition feels seamless—as if the entire network were a single, cohesive world.
Conclusion
MapModCompanion solves a niche but persistent annoyance that plagues multiplayer Minecraft. By simulating mod presence on the server side, it fixes multi-world detection for the most popular mapping mods and frees your players from manual configuration. The installation takes seconds, requires no maintenance, and works across both backend servers and proxies. Whether you run a small community server or a large BungeeCord network, adding this plugin means your players can focus on exploring, building, and adventuring—without ever seeing another “world not recognized” error. Grab the latest jar, drop it into your plugins folders, and let your maps work the way they were meant to.