原创 开源 工具 娱乐 LoveBossBar | 像Hypixel大厅那样向玩家展示顶部公告！ 1.0.0

[MD] # LoveBossBar | 请使用Java17或更高版本运行 > 专为 **Spigot / PandaSpigot 1.8.8** 打造的顶部循环 BossBar 插件， > 一比一复刻 Hypixel 大厅那种"欢迎语 → 服务器介绍 → 在线人数"轮播效果。 --- ## ✨ 插件亮点 - 🎯 **纯数据包实现，零性能开销** 没有真实实体生成、没有 AI、没有寻路计算。BossBar 全程通过手工构造的 数据包（生成/元数据/传送/销毁）发送给客户端，实体从不进入真实世界， 服务端 TPS 几乎感受不到它的存在，1000 人同服也不虚。 - 🔁 **文字循环轮播，间隔随意调** 支持配置任意条数的文字轮播内容，切换间隔精确到 tick 级别， 想做 0.5 秒快闪还是 5 秒慢悠悠切换都可以。 - 🎨 **完整支持颜色/格式代码** `&c &a &l &n &o &k` 等全部原版颜色与格式代码悉数支持， 想做渐变、加粗、下划线、混乱字效果随你发挥。 - 📊 **血条填充比例自定义** 可以固定填充百分比，也可以开启内置的正弦波"呼吸"动画， 让血条本身也跟着律动，不再是死板的一条杠。 - 🧩 **内置占位符** `%player_name%` `%online%` `%max_players%` `%world%` 开箱即用，不需要额外接 PlaceholderAPI 也能显示动态信息。 - 👤 **玩家可自主开关** `/lbb toggle` 一键关闭/开启，个人选择持久化保存，不打扰不想看的玩家。 - ⚙️ **完整的管理指令** 在线增删轮播内容、调整间隔、调整血条比例，全程无需重启服务器。 --- ## 📸 效果预览 > （建议在这里插入你自己录制的 GIF/视频，展示文字轮播效果） ``` ❤ LOVE BOSSBAR ← 第 1 帧 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 欢迎 Nachen ← 第 2 帧（切换后） ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ``` --- ## 📦 安装方法 1. 下载 `LoveBossBar.jar`，丢进服务器 `plugins/` 目录 2. 重启服务器（或用 PlugMan 之类的插件热加载） 3. 首次启动会自动生成 `config.yml`，按需修改后 `/lbb reload` 即可生效 **服务端要求：** | 项目 | 要求 | |---|---| | Minecraft 版本 | 1.8.8（craftbukkit 包名需为 `v1_8_R*`） | | 核心 | Spigot / PandaSpigot / Paper-1.8 fork 等兼容核心 | | 运行环境 | Java 8 及以上（具体以你下载的构建版本为准） | | 依赖插件 | 无，纯净可用 | > ⚠️ 本插件利用的是 1.8.8 客户端"看到附近有凋灵/末影龙就在屏幕顶部显示 > 血条"这一特性来实现 BossBar，因此**仅支持 1.8.8**。1.9 及以上版本 > 客户端有原生 BossBar 协议，没有必要也不建议在新版本使用本插件的实现方式。 --- ## 🛠️ 配置文件说明（config.yml） ```yaml settings: enabled: true # 总开关 disabled-worlds: [] # 禁用 BossBar 的世界名单 change-interval: 60 # 文字切换间隔（tick，20=1秒） keepalive-interval: 100 # 假实体保活间隔（一般不用改） percent: 100 # 血条填充百分比 0-100 animate-percent: false # 是否开启血条呼吸动画 texts: - "&d&l❤ &f&lLOVE &d&lBOSSBAR" - "&b&l欢迎 &f%player_name%" - "&a&l在线人数: &f%online%&7/&f%max_players%" - "&e&l祝你游戏愉快！" ``` 支持的占位符：`%player_name%` `%online%` `%max_players%` `%world%` --- ## 💻 命令列表 主命令：`/lovebossbar`，别名：`/lbb`、`/lovebb` | 命令 | 说明 | 所需权限 | |---|---|---| | `/lbb` 或 `/lbb help` | 查看帮助 | 无 | | `/lbb toggle` | 为自己开关 BossBar | `lovebossbar.toggle` | | `/lbb reload` | 重新加载 config.yml | `lovebossbar.admin` | | `/lbb on` / `/lbb off` | 全局启用 / 关闭 | `lovebossbar.admin` | | `/lbb setinterval <tick>` | 设置切换间隔 | `lovebossbar.admin` | | `/lbb setpercent <0-100>` | 设置血条填充比例 | `lovebossbar.admin` | | `/lbb addline <文本>` | 增加一条轮播文本 | `lovebossbar.admin` | | `/lbb removeline <序号>` | 删除一条轮播文本 | `lovebossbar.admin` | | `/lbb lines` | 列出当前所有轮播文本 | `lovebossbar.admin` | --- ## 🔑 权限节点 | 权限 | 默认 | 说明 | |---|---|---| | `lovebossbar.use` | 所有人 | 是否能看到 BossBar（可用来做 VIP 专属内容） | | `lovebossbar.toggle` | 所有人 | 是否能自己开关 BossBar | | `lovebossbar.admin` | OP | 是否能使用管理类指令 | --- ## ❓ 常见问题 **Q: 为什么我的 1.16 服务器装了没反应？** A: 本插件专为 1.8.8 设计，利用的是老版本客户端的特殊显示机制， 不兼容 1.9 及以上版本。1.9+ 请使用原生 BossBar API 相关插件。 **Q: 会不会跟其他也用凋灵/末影龙做效果的插件冲突？** A: 一般不会。本插件的假实体只对单个客户端可见、且使用独立的实体 ID， 不会污染服务端真实的实体列表，和记分板、Tab 列表、公告板类插件都能共存。 **Q: 能不能做成只有特定权限组才能看到的"隐藏彩蛋"效果？** A: 可以，把 `lovebossbar.use` 的默认权限改成 false，再用权限插件 （LuckPerms 等）单独给需要的组授权即可。 **Q: 换了世界/传送之后 BossBar 会消失吗？** A: 不会，插件监听了世界切换和重生事件，会自动重新定位显示。 --- ## 📮 反馈与支持 使用中遇到问题、报错日志、功能建议，欢迎在本帖下方回复， 会尽量跟进解答和维护更新。 --- *LoveBossBar —— 让你的服务器大厅也拥有 Hypixel 同款质感。* [/MD]