Description
Gallery
Changelog
Versions
Companion for map mods
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), JourneyMap and VoxelMap (both old and 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.
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] |
| VoxelMap | v1.7.10 / Minecraft 1.8 | v1.16.6 / Minecraft 26.1.2 | ✅ Supported[2] |
Folia is supported and needs PacketEvents to work properly[3]. 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).
- Download the latest release
- Put each file into the corresponding plugins folder
- 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.
All Versions
+ Add Version
[0.10.0] 0.10.0
by turikhay on Oct 15, 2026
Download
[0.10.0-beta.7] 0.10.0-beta.7
by turikhay on Oct 15, 2026
Download
- Fix api-version by @SrBedrock [(#131)](https://github.com/turikhay/MapModCompanion/pull/131)
Changelog is available on
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.10.0-beta.7)
[0.10.0-beta.6] 0.10.0-beta.6
by turikhay on Oct 15, 2026
Download
- Fixed support for [the new Paper remapper](https://forums.papermc.io/threads/important-dev-psa-future-removal-of-cb-package-relocation.1106/) ([#118](https://github.com/turikhay/MapModCompanion/pull/118))
Changelog is available on
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.10.0-beta.6)
[0.9.0-beta.2] 0.9.0-beta.2
by turikhay on Oct 15, 2026
Download
- Folia support
- Fixes configuration reloading in Folia (#76)
Changelog is available on
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.9.0-beta.2)
[0.8.1] 0.8.1
by turikhay on Oct 15, 2026
Download
ℹ️ This release doesn't support Folia. Folia support was added in [0.9.0](https://modrinth.com/plugin/modmapcompanion/version/0.9.0-beta.2)
Changelog is available on
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.8.1)
- Stop "Received possibly malformed packet" flood (#39)
- Targeting latest Minecraft version (1.20.1)
- Update tests, build process and dependencies
Changelog is available on
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.8.1)
[0.8.0] 0.8.0
by turikhay on Oct 15, 2026
Download
- Velocity support** ([#5](https://github.com/turikhay/MapModCompanion/pull/5))
- Major refactor & QoL improvements ([#3](https://github.com/turikhay/MapModCompanion/pull/3))
- Fix Forge VoxelMap on 1.12.2 ([#9](https://github.com/turikhay/MapModCompanion/pull/9))
- Fix Forge VoxelMap on 1.13.2 - 1.16.3 ([#11](https://github.com/turikhay/MapModCompanion/pull/11)) – **requires ProtocolLib**
- E2E tests ([#6](https://github.com/turikhay/MapModCompanion/pull/6)) on Velocity, BungeeCord, Waterfall and Paper; see [README](https://github.com/turikhay/MapModCompanion/blob/428127c5048ec8f7d7033c0f760cc90dfee57729/tests_e2e/README.md)
Changelog is available on
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.8.0)
[0.8.0-beta.1] 0.8.0-beta.1
by turikhay on Oct 15, 2026
Download
Changelog is available on
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.8.0-beta.1)
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.8.0-beta.1)
[0.8.0-alpha.3] 0.8.0-alpha.3
by turikhay on Oct 15, 2026
Download
From 0.8.0-alpha.3:
From 0.8.0-alpha.1:
Changelog is available on
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.8.0-alpha.3)
- Leave only one download option: unified jar** (
MapModCompanion.jar) - Fix NPE when plugin is reloading
- Xaero: Skip message delivery if player's offline
From 0.8.0-alpha.1:
- Initial Velocity support
- Fix Forge VoxelMap on 1.12.2
- Fix Forge VoxelMap on 1.13.2 - 1.16.3 – **requires ProtocolLib**
- E2E tests on Velocity, BungeeCord, Waterfall and Paper
Changelog is available on
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.8.0-alpha.3)
[0.8.0-alpha.1] 0.8.0-alpha.1
by turikhay on Oct 15, 2026
Download
- Initial Velocity support
- Fix Forge VoxelMap on 1.12.2
- Fix Forge VoxelMap on 1.13.2 - 1.16.3 – **requires ProtocolLib**
- E2E tests on Velocity, BungeeCord, Waterfall and Paper
Changelog is available on
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.8.0-alpha.1)
ℹ️ For your convenience, now we build
MapModCompanion.jar which is compatible with both BungeeCord and Spigot servers. You can still use separate jars.
[0.7.0-beta.2] 0.7.0-beta.2
by turikhay on Oct 15, 2026
Download
Changelog is available on
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.7.0-beta.2)
ℹ️ For your convenience, now we build
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.7.0-beta.2)
ℹ️ For your convenience, now we build
MapModCompanion.jar which is compatible with both BungeeCord and Spigot servers. You can still use separate jars.
[0.6.0] 0.6.0
by turikhay on Oct 15, 2026
Download
- Support older Minecraft versions (1.8 - 1.12.2)
- Improve default world detection
Changelog is available on
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.6.0)
ℹ️ For your convenience, now we build
MapModCompanion.jar which is compatible with both BungeeCord and Spigot servers. You can still use separate jars.
[0.6.0-beta.1] 0.6.0-beta.1
by turikhay on Oct 15, 2026
Download
Changelog is available on
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.6.0-beta.1)
ℹ️ For your convenience, now we build
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.6.0-beta.1)
ℹ️ For your convenience, now we build
MapModCompanion.jar which is compatible with both BungeeCord and Spigot servers. You can still use separate jars.
[0.5.0-beta.3] 0.5.0-beta.3
by turikhay on Oct 15, 2026
Download
Changelog is available on
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.5.0-beta.3)
ℹ️ For your convenience, now we build
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.5.0-beta.3)
ℹ️ For your convenience, now we build
MapModCompanion.jar which is compatible with both BungeeCord and Spigot servers. You can still use separate jars.
[0.5.0-beta.2] 0.5.0-beta.2
by turikhay on Oct 15, 2026
Download
[Fully support legacy world_id packets](https://github.com/turikhay/MapModCompanion/commit/37f36e71d20e798fee60b342a370145315704597) – add support for pre-1.13 VoxelMap builds.
Changelog is available on
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.5.0-beta.2)
ℹ️ For your convenience, now we build
Changelog is available on
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.5.0-beta.2)
ℹ️ For your convenience, now we build
MapModCompanion.jar which is compatible with both BungeeCord and Spigot servers. You can still use separate jars.
[0.5.0-beta.1] 0.5.0-beta.1
by turikhay on Oct 15, 2026
Download
- Target oldest Spigot version (1.8)
Changelog is available on
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.5.0-beta.1)
ℹ️ For your convenience, now we build
MapModCompanion.jar which is compatible with both BungeeCord and Spigot servers. You can still use separate jars.
[0.4.0] 0.4.0
by turikhay on Oct 15, 2026
Download
Adds proper Xaero's Minimap support (when used without Xaero's World Map)
Changelog is available on
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.4.0)
Changelog is available on
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.4.0)
[0.3.1] 0.3.1
by turikhay on Oct 15, 2026
Download
A small update, which may be skipped if you don't have any issues with the plugin
Changelog is available on
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.3.1)
Changelog is available on
[GitHub](https://github.com/turikhay/MapModCompanion/releases/tag/v0.3.1)
[0.3.0] 0.3.0
by turikhay on Oct 15, 2026
Download
