1MB-MapHide

1MB-MapHide is a Paper addon for BlueMap that lets players control whether their live marker is shown on the map. It is a 1MB-customized fork of TechnicJelle's BlueMapPlayerControl.

The main command is /bmpc. Players can use /bmpc, /bmpc toggle, /bmpc show, and /bmpc hide; admins can use target, status, config, and reload subcommands. /map hide is a configurable alias that runs the same self-toggle logic as /bmpc toggle.

Canonical player docs URL:

https://docs.1moreblock.com/custom-server-plugins/maphide/

Documentation

• Player guide
• Commands
• Permissions
• Placeholders
• Configuration
• Installation and building
• Integrations
• Troubleshooting

Changelog Summary

Version 2.0.1 is the Paper 26.2 stable compatibility and housekeeping release. It pins io.papermc.paper:paper-api:26.2.build.84-stable, keeps Java 25 bytecode, adds the /bmpc version compatibility alias, reports the exact compiled Paper API in diagnostics, makes release-build retries deterministic, validates generated metadata and documented jar names, and deploys only to the maintained Paper 26.2 test server. The existing /bmpc, /map hide, MiniMessage translations, comment-preserving configuration, permissions, timers, default visibility, admin tools, and PlaceholderAPI behavior remain intact.

Supported Servers

This build targets Java 25 bytecode and the exact stable Paper API coordinate io.papermc.paper:paper-api:26.2.build.84-stable. Paper 26.2 build 84 stable is the maintained release-test server:

Server	BlueMap plugin
Paper 26.2 build 84 stable	bluemap-5.22-paper.jar

The generated plugin metadata declares api-version: 26.2, so this release is not intended for older Paper versions. Use an older MapHide build for Paper 26.1.2 or 1.21.11.

Configuration

The Paper plugin name is 1MB-MapHide, so the data folder is:

plugins/1MB-MapHide/

Default files:

• plugins/1MB-MapHide/config.yml
• plugins/1MB-MapHide/Translations/Locale_EN.yml

Set language: EN in config.yml. To add French, create Translations/Locale_FR.yml, set language: FR, then restart or run /bmpc reload.

Important settings:

Key	Default	Description
language	EN	Translation file suffix.
bmpc-toggle-alias	/map hide	Alias command that runs /bmpc toggle; set to "" to disable.
default-visibility	show	show or hide for newly handled joins.
apply-default-visibility-on-first-join-only	true	Applies default only to first joins when true.
toggle-back-after-seconds	0	Seconds after a self toggle before toggling again. 0 disables it.
forced-permissions.enabled	false	Enables forced visibility permission handling.
forced-permissions.hide-node	maphide.forcehide	Permission that forces a player hidden.
forced-permissions.show-node	maphide.forceshow	Permission that forces a player visible.
forced-permissions.conflict-priority	hide	Winner if a player has both force permissions.
forced-permissions.check-interval-seconds	0	Optional repeating force-permission check; only raise it if forced visibility is being undone.

Commands

Command	Description	Permission
/bmpc	Legacy self toggle.	maphide.player, maphide.player.toggle
/bmpc help [page]	Shows paged command help.	maphide.player, maphide.player.help
/bmpc info	Shows plugin info, starting commands, version/build, and docs URL.	maphide.player, maphide.player.info
/bmpc version	Alias for /bmpc info.	maphide.player, maphide.player.info
/bmpc toggle	Toggles your own BlueMap visibility.	maphide.player, maphide.player.toggle
/bmpc show	Shows your own BlueMap marker.	maphide.player, maphide.player.show
/bmpc hide	Hides your own BlueMap marker.	maphide.player, maphide.player.hide
/map hide	Configurable alias for /bmpc toggle.	maphide.player, maphide.player.toggle
/bmpc toggle <player>	Toggles another online player.	maphide.admin.toggle
/bmpc show <player>	Shows another online player.	maphide.admin.show
/bmpc hide <player>	Hides another online player.	maphide.admin.hide
/bmpc status	Shows plugin version, build number, BlueMap, server, Java, and target build information.	maphide.admin.status
/bmpc status <player>	Shows visibility, forced state, world, coordinates, and timer.	maphide.admin.status
/bmpc config [page]	Lists config values with pagination.	maphide.admin.config
/bmpc config set <key> <value>	Updates a config key and reloads.	maphide.admin.set
/bmpc debug [page]	Lists debug categories with pagination.	maphide.admin.debug
/bmpc debug status	Shows server, plugin, and MapHide setting diagnostics.	maphide.admin.debug.status
/bmpc debug commands [page]	Lists command routes and permission gates.	maphide.admin.debug.commands
/bmpc debug permissions [page]	Lists permission nodes, defaults, descriptions, and sender state.	maphide.admin.debug.permissions
/bmpc debug placeholders [page]	Lists PlaceholderAPI state and placeholders.	maphide.admin.debug.placeholders
/bmpc reload	Reloads config and translations.	maphide.admin.reload

Player arguments support exact online player names. Selector arguments @a, @p, @r, and @s are available to admins.

Permissions

Permission	Default	Description
maphide.player	true	Allows access to /bmpc player commands.
maphide.player.help	true	Allows /bmpc help.
maphide.player.info	true	Allows /bmpc info and /bmpc version.
maphide.player.toggle	true	Allows /bmpc, /bmpc toggle, and the configured alias.
maphide.player.show	true	Allows /bmpc show.
maphide.player.hide	true	Allows /bmpc hide.
maphide.forcehide	false	Forces the player hidden regardless of commands.
maphide.forceshow	false	Forces the player visible regardless of commands.
maphide.admin	op	Parent admin permission.
maphide.admin.toggle	op	Allows /bmpc toggle <player>.
maphide.admin.show	op	Allows /bmpc show <player>.
maphide.admin.hide	op	Allows /bmpc hide <player>.
maphide.admin.status	op	Allows /bmpc status and /bmpc status <player>.
maphide.admin.config	op	Allows /bmpc config.
maphide.admin.set	op	Allows /bmpc config set <key> <value>.
maphide.admin.reload	op	Allows /bmpc reload.
maphide.admin.debug	op	Parent debug permission for /bmpc debug.
maphide.admin.debug.status	op	Allows /bmpc debug status.
maphide.admin.debug.commands	op	Allows /bmpc debug commands.
maphide.admin.debug.permissions	op	Allows /bmpc debug permissions.
maphide.admin.debug.placeholders	op	Allows /bmpc debug placeholders.

Placeholders

PlaceholderAPI is optional. When installed, 1MB-MapHide registers:

Placeholder	Description
%maphide_visible%	true, false, or unknown.
%maphide_state%	visible, hidden, or unknown.
%maphide_forced%	Whether the player has a force permission.
%maphide_force_mode%	hide, show, or none.
%maphide_default_visibility%	Current configured default: visible or hidden.
%maphide_toggle_back_seconds%	Configured auto-toggle seconds.
%maphide_toggle_back_remaining%	Seconds left on the player's active timer.
%maphide_language%	Active language code.

Building

Requirements:

• Gradle 9.6.1 or newer
• JDK 25.0.4 at /Library/Java/JavaVirtualMachines/jdk-25.0.4.jdk/Contents/Home
• The exact Maven dependency io.papermc.paper:paper-api:26.2.build.84-stable
• The local servers/Paper-26.2 folder with plugins/bluemap-5.22-paper.jar and optional plugins/PlaceholderAPI-2.12.3.jar

Build release 028 and deploy it to the maintained Paper 26.2 test server:

JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-25.0.4.jdk/Contents/Home \
  gradle --no-daemon -PreleaseBuildNumber=028 clean build

Jars are named like:

1MB-BlueMap-MapHide-v2.0.1-028-j25-26.2.jar

The plugin version comes from gradle.properties. The three-digit build number is stored in build-number.txt and advances for a new unpinned jar build. Pin releaseBuildNumber when repeating a release build so retries reuse the intended number instead of incrementing it again. The Java and Paper parts of the jar name are target identifiers, not the semantic plugin version.

verifyReleaseMetadata checks source and documentation values. verifyArtifactMetadata checks the generated plugin.yml, build information, jar name, and Java 25 class version. Both run as part of check.

After a successful build, deployServers copies the jar into servers/Paper-26.2/plugins/. Before copying, it renames active older MapHide jars in that folder by appending .disabled.

Installation

1. Stop the Paper server.
2. Put 1MB-BlueMap-MapHide-v2.0.1-028-j25-26.2.jar in plugins/.
3. Make sure BlueMap is also in plugins/.
4. Remove or disable old BlueMapPlayerControl-*.jar copies.
5. Start the server.
6. Configure plugins/1MB-MapHide/config.yml.
7. In game, run /bmpc or /map hide to toggle your marker.

Credits

• Original addon: BlueMapPlayerControl by TechnicJelle.
• Map plugin: BlueMap by the BlueMap project.
• 1MB customization and /map hide workflow: mrfloris.
• Development assistance: OpenAI.