Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Links
Creators
Details
A lightweight Fabric addon for BlueMap that gives players control over whether they appear on the live map. Players can toggle their own visibility with simple commands, and admins can manage who has access via LuckPerms.
💡 Why use this? By default, BlueMap shows everyone’s location — which can raise privacy concerns. This addon empowers players to decide for themselves whether they want to appear on the map, while still giving admins full control over permissions.
✨ Features
/maphide — hide yourself from BlueMap
/mapshow — show yourself again
/mapvis get — check your current status
Integrates with LuckPerms (via Fabric Permissions API)
Remembers choices across server restarts
Fully server-side (no client installation needed)
📦 Dependencies
Required for the mod to run:
Fabric Loader
=0.16.5
Fabric API
=0.105.0+1.21.1
BlueMap (Fabric)
Optional / Recommended:
LuckPerms (Fabric) — permission management
Fabric Permissions API — lightweight permissions bridge used by LuckPerms
⚙️ Installation
Install Fabric Loader and Fabric API on your server.
Download and install BlueMap .
Place the sovern-map-toggle-x.x.x.jar into your server’s mods/ folder.
(Optional) Install LuckPerms and Fabric Permissions API for fine-grained control.
Restart the server — the commands will now be available.
📝 Permissions
The following permission nodes are available (LuckPerms recommended):
sovern.maptoggle.hide → allows /maphide
sovern.maptoggle.show → allows /mapshow
sovern.maptoggle.get → allows /mapvis get
If Permissions are not showing on LuckPerms editor, type the following commands into the server console:
lp group default permission set sovern.maptoggle.hide true
lp group default permission set sovern.maptoggle.show true
lp group default permission set sovern.maptoggle.get true
This gives all players the ability to control their own visibility. Admins can also restrict or expand usage by assigning these nodes to specific groups.
📂 Data Storage
Player visibility preferences are stored in:
config/sovern-map-toggle/hidden.json
Choices persist across restarts and are automatically applied when BlueMap loads.
🔧 For Developers
Compiles against bluemap-api:2.7.5
Uses Fabric Loom with Yarn mappings for 1.21.1
Java 21+ required



