MapModCompanion

Companion for map mods

[

](github.com/turikhay/MapModCompanion/blob/main/L…)
[

](github.com/turikhay/MapModCompanion/actions/wor…)
[

](buymeacoffee.com/turikhay)

With this plugin your minimap will never be confused which world you're in. A more in-depth explanation can be found in the wiki.

How it should look like

Mod · Screenshot
Xaero's World Map
VoxelMap
Xaero's Minimap · See Xaero's WorldMap
JourneyMap · It just works 😄

Companion plugin for
[Xaero's Minimap]
(and their [World Map][Xaero's World Map]),
[JourneyMap] and
VoxelMap (both [old][VoxelMap (old)] and [updated][VoxelMap-Updated]).
Provides a way for these mods to identify worlds on BungeeCord/Velocity servers.

It's recommended to install this plugin on a fresh server, otherwise existing map data
(waypoints, map cache, etc.) may no longer be visible to some players. Fortunately,
there are ways to restore it.
It's worth mentioning that the plugin doesn't affect in-game progress.

This plugin was inspired by @kosma's [worldnamepacket],
which supported Velocity, Fabric and Spigot at the time of writing.

If you have any questions, please [join my Discord][Discord].

Support table

Mod · Oldest version · Latest version · Status
[Xaero's Minimap] · v20.20.0 / Minecraft 1.8.9 · v25.3.14 / Minecraft 26.1.2 · ✅ Supported
[Xaero's World Map] · v1.10.0 / Minecraft 1.8.9 · v1.40.17 / Minecraft 26.1.2 · ✅ Supported
| [JourneyMap] | v5.7.1 / Minecraft 1.16.5 | v6.0.0-beta.76 / Minecraft 26.1.2 | ☑️ Supported
[JourneyMap-Paper] is available since 26.1[[1]](github.com/turikhay/MapModCompanion/issues/252) |
VoxelMap · [v1.7.10][VoxelMap (old)] / Minecraft 1.8 · [v1.16.6][VoxelMap-Updated] / Minecraft 26.1.2 · ✅ Supported[[2]](github.com/turikhay/MapModCompanion/issues/8)

Folia is supported and needs PacketEvents to work properly[[3]](github.com/turikhay/MapModCompanion/pull/251). Please report if support is broken.

Installation

ℹ️ Plugin must be installed on every downstream (backend) server in your network. Simply installing it on the proxy side (BungeeCord/Velocity) isn't enough. To ensure compatibility, you need to install the plugin on both the proxy server (BungeeCord/Velocity) and each of the backend servers (Spigot/Paper/Folia).

1. Download the latest release
2. Put each file into the corresponding plugins folder
3. That's it. No configuration is required. You can restart your servers now.

Configuration

The configuration file is stored at plugins/MapModCompanion/config.yml for both Spigot and BungeeCord.
Velocity uses plugins/mapmodcompanion/config.toml.

The configuration file reloads automatically if it's modified.

[Discord]: discord.gg/H9ACHEqBrg
[Xaero's Minimap]: modrinth.com/mod/xaeros-minimap
[Xaero's World Map]: modrinth.com/mod/xaeros-world-map
[JourneyMap]: modrinth.com/mod/journeymap
[JourneyMap-Paper]: teamjm.github.io/journeymap-docs/latest/server/…
[VoxelMap (old)]: curseforge.com/minecraft/mc-mods/voxelmap
[VoxelMap-Updated]: modrinth.com/mod/voxelmap-updated
[worldnamepacket]: github.com/kosma/worldnamepacket