HubBasics - 基础大厅管理插件

HubBasics 是一款专为大厅/枢纽服务器设计的综合性插件。它将众多常用功能整合为一体，避免了因安装过多单一功能插件而导致的服务器臃肿、信息格式混乱和性能下降问题，让你能轻松定制和管理服务器出生点区域。

💡重要提示

• 如果你运行的是 1.18 或更高版本 的 Minecraft，请务必同时安装 NBTAPI，HubBasics 在新版本中需要此依赖。

🎮核心功能

HubBasics 集成了以下功能，所有配置均支持按世界设置和权限控制：

• 消息管理：自定义玩家加入/离开服务器的提示消息。
• 双段跳：为玩家赋予双段跳能力。
• 固定天气：锁定服务器天气。
• 防虚空坠落：防止玩家从世界边缘掉落。
• 状态保持：保持玩家的饱食度与生命值始终为满。
• 弹射板：设置可将玩家弹射到空中的特殊踏板。
• 聊天公告：可自定义的周期性聊天栏公告系统。
• Boss 血条公告：在屏幕上方通过 Boss 血条显示公告。
• 自定义全息字：使用 /holograms 命令创建和管理全息文字。
• 传送系统：包含 /hub (或 /lobby) 命令，用于返回大厅或连接至 BungeeCord 网络中的大厅服务器。
• 地标传送 (Warp)：创建和管理传送点。
• 加入物品：设置玩家加入时获得的特定物品。
• 自定义菜单：通过 YAML 文件创建基于物品栏的交互菜单。
• BungeeCord 支持：提供独立的 Bungee 版本以实现跨服功能。
• PlaceholderAPI 支持：兼容 PlaceholderAPI，可在消息中使用变量。

开发中功能 (WIP)

以下功能正在开发中，尚未发布

• 扩展 MOTD 设置
• 命令覆写系统
• 基础信息告示牌
• Stacker 小游戏
• 名牌编辑系统

🔧命令列表

• 返回大厅：/hub (别名：/lobby)
• 管理全息字：/hb-holo
• 使用地标传送：/hb-warp tp <名称>
• 创建地标：/hb-warp create <名称>
• 删除地标：/hb-warp delete <名称>
• 列出所有地标：/hb-warp list
• 重载插件：/hb reload
• 设置大厅位置：/sethub

✨权限节点

• hubbasics.admin.warp：管理所有地标传送相关操作。
• hubbasics.holograms：管理所有全息字相关操作。
• hubbasics.admin：拥有所有其他管理权限 (包括 /hb 命令)。
• hubbasics.lobby：允许使用 /hub 或 /lobby 命令传送自己。
• hubbasics.lobby.others：允许将其他玩家传送至大厅。
• hubbasics.sethub：允许使用 /sethub 命令设置大厅位置。

⭐安装与配置

所有配置文件均有详细注释，请安装后直接查看 plugins/HubBasics/ 目录下的文件进行配置。

Spigot/Paper 服务器安装

• 从本页面下载 HubBasics-Spigot.jar。
• 将其放入服务器的 plugins 文件夹。
• 启动或重启服务器。
• 在 plugins/HubBasics/ 目录中按需修改配置文件。
• 保存配置并重启服务器使更改生效。

BungeeCord 网络安装

• 从本页面下载 HubBasics-Bungee.jar 和 HubBasics-Spigot.jar。
• 将 HubBasics-Bungee.jar 放入 BungeeCord 代理端 的 plugins 文件夹。
• 将 HubBasics-Spigot.jar 放入 大厅服务器 的 plugins 文件夹。
• 启动或重启整个网络。
• 分别在代理端和子服务器的 plugins/HubBasics/ 目录中配置。

❓常见问题 (FAQ)

Q：我的配置文件总是被重置！怎么办？

A：请在报告问题前，先查看 此链接 中的说明。

Q：下一个更新什么时候发布？

A：将在开发者有时间时进行更新。没有固定的发布时间表。

🔧数据统计 (Metrics) 说明

自 2.0 版本起，HubBasics 集成了由 BStats 提供的数据统计服务。

这是什么？

Metrics 是一项匿名数据统计服务，用于帮助开发者了解插件的使用情况。更多信息请见 这里。

收集哪些数据？

仅收集基础匿名信息，例如

• 插件版本
• 服务器软件版本
• 在线玩家数量（非最大人数）

绝不收集的数据：

• 任何重要数据（如密码）
• 服务器 IP 地址
• 任何玩家或管理员的用户名

如何确认其安全性？

HubBasics 是开源插件，你可以在 GitHub 仓库 中查看 Metrics.java 源码以核实其行为。

如何禁用数据统计？

进入服务器目录下的 /plugins/bstats/ 文件夹，将 config.yml 中的 opt-out 设置为 true 即可。

为什么需要这个？

作为开发者，我希望了解有多少服务器在使用此插件，以判断其是否真正有用，并指导未来的开发方向。

💡其他信息

• 版本兼容：兼容 1.7 及以上 的所有 Minecraft 版本。带星号 (*) 的版本可能功能受限。
• 开发计划：功能开发计划（待办清单）可在 此处 查看。如果你想提出新功能建议，请在 GitHub 上提交标记为 “Enhancement/Idea” 的议题。
• 源码仓库：插件完全开源，源码位于 GitHub。
• 问题反馈：发现 Bug？请在 GitHub 上 提交问题 或在讨论区发帖。
• 支持开发：如果你喜欢这个插件并希望支持其持续开发，可以通过 Patreon 进行捐助，任何支持都意义重大。