Firefly

插件

· 作者 MDWGames

在 Minecraft 1.21.6+ 的定位栏中隐藏并重新着色你的圆点。实现真正的玩家位置隐私保护,管理员可绕过查看全部位置,并提供全面自定义选项。服务端运行,无需客户端模组。支持 Paper、Spigot 和 Folia。

0 本站下载 0 关注 更新于 4 周前

需要前置:PacketEvents

最新 1.1.4 · 26.3 · Folia / Paper

一键开服(送7天)

Firefly

重新夺回对 Minecraft 定位栏的控制权。
隐藏你的位置、重绘你的圆点,为玩家提供真正的隐私。无需安装客户端模组。


什么是定位栏?

Minecraft 1.21.6 引入了定位栏:屏幕顶部的一条横条,以彩色圆点(路标)的形式显示其他所有玩家的方向和距离。它非常适合与朋友聚会,但当你不想被追踪时,它就成了一个问题。

Firefly 将这种可见性交还给你的玩家。 任何人都可以让自己对其他玩家的定位栏不可见,或者重绘自己的圆点。管理员则拥有“全视”覆盖权限以及管理工具。

100% 服务端插件。 玩家使用普通的原版客户端即可加入。他们无需安装任何东西:不需要资源包,也不需要模组。Firefly 完全通过在服务端重写定位栏数据包来实现所有功能。

✨ 特性

  • ? 隐藏你的位置。 使用 /firefly hide 从其他所有玩家的定位栏中消失。 你的位置将不再被广播。
  • ? 重绘你的圆点。 选择 16 种 Minecraft 命名颜色之一 或 一个完整的 #RRGGBB 十六进制代码 来脱颖而出、融入环境或协调团队。
  • ?️ 管理员全视绕过。 工作人员可以揭示隐藏的玩家以进行管理。每个管理员的开/关选择会在登录之间保存,并设有你控制的服务器全局默认值。
  • ? 查看谁在隐藏。 /firefly showhidden 列出当前隐藏其圆点的每位玩家。
  • ? 持久的玩家偏好设置。 隐藏状态、颜色和绕过选择在重新连接和重启后依然存在。可存储于 YAML、嵌入式 H2 或共享的 MySQL 中。
  • ? 完全支持翻译。 每条消息都位于 messages.yml 中;编辑文本,使用传统的 & 代码进行着色,并通过 /firefly reload 实时重载。
  • ⚡ Folia 兼容 & 轻量级。 专为现代高性能服务器构建,当没有人隐藏或重绘圆点时完全空闲。
  • ? 免费且开源。 GPL-3.0 许可,附带签名且经过构建溯源验证的发布 jar 包。

? 适用场景

  • 生存 & SMP 服务器。 在共享地图上给予玩家真正的安全感和隐私感。
  • PvP、无政府 & 阵营服务器。 防止定位栏让每个人都成为被追踪的目标。 旅行、突袭和伏击时,无需向整个服务器广播你的坐标。
  • 角色扮演 & 冒险地图。 保持沉浸感;并非每个角色都应该是一个发光的圆点。
  • 小游戏。 让捉迷藏、猎杀、刺客和潜行模式再次变得可玩。

⌨️ 命令

基础命令:/firefly(别名 /ff)。

命令 权限 功能
/firefly hide firefly.use 对其他玩家的定位栏隐藏你的圆点。
/firefly show firefly.use 再次显示你的圆点。
/firefly toggle firefly.use 切换你的隐藏状态。
/firefly color <name|#RRGGBB> firefly.use 重绘你的圆点(他人所见颜色)。
/firefly color reset firefly.use 将你的圆点重置为原版颜色。
/firefly bypass <on|off|toggle> firefly.admin 全视:揭示正在隐藏的玩家。
/firefly showhidden firefly.admin 列出当前隐藏其圆点的玩家。
/firefly reload firefly.admin 重载 config.yml 和 messages.yml。

颜色: black, dark_blue, dark_green, dark_aqua, dark_red, dark_purple, gold, gray, dark_gray, blue, green, aqua, red, light_purple, yellow, white,或任何 #RRGGBB 十六进制值,例如 /ff color #FF8800。

? 权限

权限 默认分配 授予
firefly.use 所有人 隐藏 / 显示 / 切换并重绘自己的圆点。
firefly.admin ops 绕过隐藏、列出隐藏的玩家、重载配置。

? 快速开始

  1. 安装 packetevents (2.10.1+; 26.1 - 26.2 版本需 2.13.0+; 26.3 版本需 2.14.0+) 到你的 plugins/ 文件夹中。 这是一个必需的依赖项(Firefly 通过它驱动定位栏,没有它将无法启用)。
  2. 下载 Firefly 并将 .jar 文件放入 plugins/。
  3. 重启服务器。搞定:Firefly 开箱即用,无需任何配置。

⚙️ 配置

Firefly 会在 plugins/Firefly/ 目录下生成 config.yml 和 messages.yml(在默认后端下还会生成 playerdata.yml)。

管理员绕过默认值。 决定管理员加入时是否默认开启全视。管理员显式的 /firefly bypass 选择会被持久化,并在未来的登录中始终优先;如果他们带着激活的绕过权限登录,Firefly 会提醒他们。

存储后端。 选择玩家偏好设置的存储位置:

  • yaml (默认):平面文件,零设置。
  • h2:嵌入式、基于文件的 SQL 数据库;无需运行外部服务器。
  • mysql:外部服务器,使用 HikariCP 连接池,因此你可以在整个服务器网络中共享隐藏/颜色偏好。

所有数据库 I/O 都在专用的后台线程上运行,切换后端不会破坏数据,如果无法访问数据库,Firefly 会自动回退到 YAML,以确保插件继续工作。

本地化。 所有面向玩家的文本均可在 messages.yml 中编辑和翻译。您未修改的键将回退到内置的英文默认值,因此该文件在更新后绝不会出错。

✅ 兼容性

  • Minecraft 1.21.6 - 1.21.11 与 26.1 - 26.3。定位栏自 1.21.6 起存在,Firefly 已验证兼容至 26.3。
  • Paper、Spigot 或 Folia。Folia 完全支持。
  • Java 21+。
  • 需要安装 packetevents 插件:
    • 在 1.21.6 - 1.21.11 上:版本 2.10.1 或更高。
    • 在 26.1 - 26.2 上:版本 2.13.0 或更高(首个知晓 26.2 协议的版本)。
    • 在 26.3 上:版本 2.14.0 或更高(首个知晓 26.3 协议的版本)。
  • 原版客户端。无需客户端模组或资源包。

?️ 性能与安全

  • 闲置时无开销。当没有任何玩家处于隐藏或变色状态时,数据包热路径会立即短路,因此在常规情况下实际上零开销。
  • 绝不阻塞服务器线程。所有存储 I/O 均在专用的工作线程上运行。
  • 设计即兼容 Folia。Firefly 仅操作玩家 UUID、内存状态和数据包,从不触及区域锁定的世界或实体状态。
  • 加固存储。仅使用参数化查询,H2 文件名经过清理,MySQL 通过环境变量密码间接方式实现 TLS 加密连接。
  • 可信构建。每个发行版均附带 CycloneDX SBOM 和 GitHub 构建来源证明,可供验证。

❓ 常见问题

玩家需要安装模组或资源包吗?

不需要。Firefly 完全是服务端插件。玩家使用普通原版客户端连接即可正常工作。

隐藏功能会影响指南针、地图或其他内容吗?

不会。Firefly 仅更改定位栏(屏幕上的玩家方向点)。指南针、游戏内地图、记分板和标签列表均不受影响。

管理员是否仍能看到隐藏的玩家?

是的。拥有 firefly.admin 权限的管理员可以开启绕过模式(/firefly bypass on)以显示隐藏玩家,并使用 /firefly showhidden 列出当前所有隐藏的确切人员。

玩家的隐藏和颜色选择会被保存吗?

会。偏好设置按玩家独立保存,并在重新登录和服务端重启后保留,数据存储于 YAML、H2 或 MySQL 中。

为什么需要 packetevents?

Bukkit API 没有提供针对每位查看者的定位栏控制接口,因此 Firefly 通过 packetevents 拦截服务器到客户端的 WAYPOINT 数据包来实现功能。这是必需的依赖项。

它在 Folia 上能工作吗?

可以。Folia 完全受支持且是首要目标平台,而非事后补充。


源代码与问题追踪: github.com/GooberCraft/Firefly
发现错误或有任何功能请求?请在 GitHub 上提交 Issue。Firefly 基于 GPL-3.0 开源。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源