一个轻量级的 Fabric 插件,用于 BlueMap,赋予玩家控制其是否在实时地图上显示的权利。
玩家可以通过简单的命令切换自己的可见性,管理员则可以通过 LuckPerms 管理谁拥有访问权限。
? 为什么使用此插件?
默认情况下,BlueMap 会显示所有人的位置——这可能会引发隐私问题。
此插件让玩家能够自行决定是否在地图上显示自己,同时仍让管理员完全掌控权限。
✨ 功能
/maphide — 从 BlueMap 中隐藏自己
/mapshow — 重新让自己在地图上显示
/mapvis get — 查看你当前的状态
与 LuckPerms 集成(通过 Fabric Permissions API)
跨服务器重启记住选择结果
完全服务端运行(无需客户端安装)
? 依赖项
运行此模组所必需的:
Fabric Loader
=0.16.5
Fabric API
=0.105.0+1.21.1
BlueMap (Fabric)
可选/推荐:
LuckPerms (Fabric)
— 权限管理
Fabric Permissions API
— LuckPerms 使用的轻量级权限桥接器
⚙️ 安装方法
在你的服务器上安装 Fabric Loader 和 Fabric API。
下载并安装 BlueMap
。
将 sovern-map-toggle-x.x.x.jar 放入服务器的 mods/ 文件夹中。
(可选)安装 LuckPerms 和 Fabric Permissions API 以实现更精细的控制。
重启服务器——现在命令即可使用了。
? 权限说明
以下权限节点可用(推荐使用 LuckPerms):
sovern.maptoggle.hide → 允许使用 /maphide
sovern.maptoggle.show → 允许使用 /mapshow
sovern.maptoggle.get → 允许使用 /mapvis get
如果在 LuckPerms 编辑器中未显示权限,请在服务器控制台中输入以下命令:
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
这将使所有玩家都能控制自己的可见性。
管理员也可以通过将这些节点分配给特定组来限制或扩展使用范围。
? 数据存储
玩家的可见性偏好存储在:
config/sovern-map-toggle/hidden.json
选择结果会在重启后保留,并在 BlueMap 加载时自动应用。
? 面向开发者
基于 bluemap-api:2.7.5 编译
使用 Fabric Loom 和 Yarn 映射进行 1.21.1 开发
需要 Java 21+
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
评论 0
登录后参与评分
还没有评论,来抢沙发吧