BlueMap Visability Toggle - Fabric

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