Skip to content

Releases: mrfdev/1MB-MapHide

v2.0.0

26 Apr 06:44

Choose a tag to compare

Since the start of using this add-on for BlueMap (to allow players to hide themselves on the map) I have made customizations to it. But, now with some open issues on this repo, and us switching fully to PaperMC 26.1.2, and Java 25, it's time to try and fix those reported issues, support modern stuff, and put it all together and ask Codex to run a pass over it to help it be a bit more stable. i thought it would be nice to just share this release, so here it is.

Tested on my own servers with:
Java 25 / Java 26 && PaperMC 1.21.11 / 26.1.2

Modernize BlueMap player visibility addon for 1MB

Rework BlueMapPlayerControl into 1MB-MapHide, a Paper-focused BlueMap
addon for controlling player marker visibility on the web map.

Highlights:

  • Rename the plugin to 1MB-MapHide while keeping the runtime data folder at
    plugins/1MB-MapHide/.
  • Move the project from Maven to Gradle and target Java 25 for Paper 26.1.2.
  • Build against the local Paper 26.1.2, BlueMap 5.20, and PlaceholderAPI jars
    while keeping compatibility with the BlueMap API used by BlueMap 5.16 on
    Paper 1.21.11.
  • Add build-numbered jar output:
    1MB-BlueMap-MapHide-v2.0.0--j25-26.1.2.jar.
  • Add packaged build metadata so the plugin can report its own target Java,
    target Paper, version, and build number.
  • Add automatic local deployment to both test server plugin folders and disable
    older active plugin jars by appending .disabled.

Command changes:

  • Keep /bmpc as the main and legacy-compatible command.
  • Support player commands:
    /bmpc
    /bmpc toggle
    /bmpc show
    /bmpc hide
  • Add admin management commands:
    /bmpc toggle
    /bmpc show
    /bmpc hide
    /bmpc status
    /bmpc status
    /bmpc config
    /bmpc config set
    /bmpc reload
  • Add /bmpc status as a server/plugin diagnostic command reporting:
    plugin version, target Java, target Paper, BlueMap version, BlueMap API
    version, server engine, Minecraft/server version, and runtime Java details.
  • Keep /bmpc status for player diagnostics, including:
    visibility, forced state, force mode, world, block coordinates, and active
    timer remaining.
  • Add a configurable self-toggle alias with bmpc-toggle-alias, defaulting to
    /map hide for the 1MoreBlock workflow.
  • Allow disabling the alias by setting bmpc-toggle-alias to an empty string.
  • Ensure the alias path requires the same maphide.player and
    maphide.player.toggle permissions as /bmpc toggle.

Permission changes:

  • Replace the legacy bmpc.* permission model with maphide.* nodes.
  • Add player permissions:
    maphide.player
    maphide.player.toggle
    maphide.player.show
    maphide.player.hide
  • Add admin permissions:
    maphide.admin
    maphide.admin.toggle
    maphide.admin.show
    maphide.admin.hide
    maphide.admin.status
    maphide.admin.config
    maphide.admin.set
    maphide.admin.reload
  • Add force permissions:
    maphide.forcehide
    maphide.forceshow
  • Resolve the upstream-style issue where disabled self permissions could still
    allow self commands by checking each action-specific maphide.player.* node.

Configuration and translations:

  • Add plugins/1MB-MapHide/config.yml.
  • Add plugins/1MB-MapHide/Translations/Locale_EN.yml.
  • Replace legacy color-code output with MiniMessage messages.
  • Add configurable language selection with language: EN.
  • Add bmpc-toggle-alias for the /map hide -> /bmpc toggle workflow.
  • Add default-visibility with show/hide support for join defaults.
  • Add apply-default-visibility-on-first-join-only.
  • Add toggle-back-after-seconds for optional timed self toggles.
  • Add forced-permissions settings with forcehide/forceshow nodes.
  • Keep forced-permissions disabled by default.
  • Keep repeating forced-permission checks disabled by default and document when
    to enable them.

PlaceholderAPI:

  • Register an optional PlaceholderAPI expansion when PlaceholderAPI is present.
  • Add placeholders:
    %maphide_visible%
    %maphide_state%
    %maphide_forced%
    %maphide_force_mode%
    %maphide_default_visibility%
    %maphide_toggle_back_seconds%
    %maphide_toggle_back_remaining%
    %maphide_language%

Documentation:

  • Rewrite README.md for the 1MB-MapHide fork.
  • Document supported Paper and BlueMap versions.
  • Document config keys, commands, permissions, placeholders, build/deploy flow,
    installation notes, and credits.
  • Add a changelog summary to the README.
  • Credit TechnicJelle, BlueMap, mrfloris, and OpenAI assistance.