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.2, build 031, migrates development and compatibility testing to Paper 26.3 build 222 stable, with the published API io.papermc.paper:paper-api:26.3.build.222-stable. Java 25 bytecode, plugin identity, commands, permissions, configuration, and visibility behavior are preserved. Builds now leave existing servers untouched. Stable fixture provisioning checks official metadata and SHA-256; regression checks cover release pins, restart persistence, and optional/missing dependencies. See the stable verification record.

Supported Servers

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

Server	BlueMap plugin
Paper 26.3 build 222 stable	bluemap-5.27-paper.jar (runtime 5.27, manifest 5.26)

The generated plugin metadata declares api-version: 26.3, 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:

• Installed Gradle 9.8.0 or newer
• Python 3.11 or newer on PATH
• Installed Oracle JDK 25 for Gradle and compilation, and Oracle JDK 27 for automated tests
• The exact Maven dependency io.papermc.paper:paper-api:26.3.build.222-stable
• The Maven dependencies de.bluecolored:bluemap-api:2.8.0 and me.clip:placeholderapi:2.12.3

A clean checkout builds without a local Paper server. The isolated servers/Paper-26.3-stable-222 fixture is only needed for runtime verification and explicit development deployment.

Build release 031:

./build.sh --no-daemon -PreleaseBuildNumber=031 clean build

Jars are named like:

1MB-BlueMap-MapHide-v2.0.2-031-j25-26.3.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.

build.sh dynamically resolves installed Oracle JDK 25 and Oracle JDK 27 with macOS java_home -F -v, validates their major versions and Oracle vendor, and runs the installed Gradle on JDK 25. All plugin and test sources compile with JDK 25 and --release 25; all Java test tasks and their Java subprocesses use JDK 27. verifyBuildJava checks the actual toolchain paths. No JDKs are downloaded or silently substituted. Explicit installed-home overrides use ONE_MB_BUILD_JAVA_HOME and ONE_MB_TEST_JAVA_HOME; see the build workflow. verifyReleaseMetadata checks source and documentation values. verifyArtifactMetadata checks the generated plugin.yml, build information, jar name, and every class for Java 25 bytecode without preview features. All run as part of check.

build does not deploy. When a development server is stopped, deployServers explicitly copies the artifact to servers/Paper-26.3-stable-222/plugins/ and retains older MapHide JARs as disabled files. Dependency resolution is pinned in gradle.lockfile; refresh locks intentionally when changing dependencies.

Prepare and test the stable fixture (see setup details):

python3 scripts/paper_fixture.py prepare
./build.sh --no-daemon verifyLocalPaperServer
python3 scripts/smoke-test.py

The preparer downloads only the checksum-pinned stable build. It reads accepted EULA files, BlueMap/PlaceholderAPI JARs, and runtime caches from the historical local fixture without importing its worlds, player records, or credentials. Each smoke run creates fresh localhost worlds under servers/verification/ and exercises startup, shutdown, restart, configuration persistence, commands, and dependency failure paths on Oracle JDK 27. Use ONE_MB_TEST_JAVA_HOME or --java-home to select another installed Oracle 27 patch. Existing servers/Paper-26.3 and servers/Paper-26.2 remain historical fixtures.

Installation

1. Stop the Paper server.
2. Put 1MB-BlueMap-MapHide-v2.0.2-031-j25-26.3.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.