BetterSettings

插件

· 作者 mattbaconz

可靠的 Paper 玩家设置,支持自定义 YAML、切换和选择值、安全重载,以及经典或甜甜圈风格的 GUI。

0 本站下载 0 关注 更新于 1 个月前

最新 1.1.0 · 26.2 · Paper

一键开服(送7天)

⚙️ BetterSettings

适用于 Paper 的可靠玩家设置——一个图形界面、自定义定义、可选值以及安全的重载机制。

BetterSettings 1.1 Chat choices

一个设置菜单,两种布局

BetterSettings 为玩家提供了一个集中管理服务器偏好的地方,同时为管理员和插件开发者提供了稳定的扩展点。

  • 经典预设: 保留了现有的分类菜单工作流程。
  • 甜甜圈灵感预设: 一个可选的包含 54 个槽位的标签式库存,设有聊天、通知、PvP、视觉、隐私、记分板和常规等标签页。
  • 清晰的控制: 左键点击切换或推进选项,右键点击选择上一个选项,Shift+左键点击恢复配置的默认值。
  • 能力感知: 基于提供者的条目在实现它们的插件注册行为之前保持隐藏。空标签页也会被隐藏。

BetterSettings 1.1 tab tour

“甜甜圈灵感”预设在一个标准的 Paper 库存内重现了有用的设置组织结构。它与 DonutSMP 无关,也不复制其暂停屏幕界面。

开关和选项设置

版本 1.1 添加了类型化的值,同时不会破坏原始的布尔 API。

  • 开关(Toggles)仍为 YAML 布尔值。
  • 选项(Choices)以字符串形式持久化,可以双向循环切换。
  • 无效的存储选项会安全地回退到配置的默认值。
  • 布尔值更改会继续触发旧版事件以及新的类型化值事件。

Choice setting cycle

上图显示的选项是一个自定义演示定义,并非捆绑的服务器功能。

可随重载保留的自定义设置

自定义 YAML 支持:

  • settings/*.yml 根目录下的单个设置;
  • 一个文件中的多个命名设置;或
  • 一个命名块(如 Test:),带有可选的显式 id。

未知的分类将显示在 Uncategorized(未分类)下并附带警告。无效的材料将回退到 PAPER 并通过验证报告。重复的 ID 和无效的定义将在验证阶段失败,而不是静默替换另一个设置。

重载是原子的:有问题的候选者不会干扰当前运行的实时菜单。由其他插件注册的设置和行为在 YAML 重载后得以保留。

动作与集成

自定义设置可以运行经过验证的提交后动作:

  • 发送玩家消息;
  • 执行玩家命令;或
  • 执行控制台命令。

命令的效果尽最大努力执行,因为目标插件拥有其行为逻辑。

“甜甜圈灵感”目录包括用于拍卖警报、赏金警报、支付政策、物品价值描述、显示等级、快速水晶和记分板行的通用基于提供者的条目。只有在提供者注册了匹配的行为后,BetterSettings 才会显示它们。

原生行为

BetterSettings 拥有的行为包括聊天和玩家可见性、个人时间与天气、保护偏好、移动和药水风格模式、自动重生、物品拾取、碰撞以及相关 Paper 原生控制。活动目录和可用性计数是根据您服务器上加载的定义动态生成的,而非固定的营销数字。

命令

命令 用途 权限
/settings 打开设置菜单 bettersettings.use
/settings reload 验证并原子重载 bettersettings.reload
/settings info 显示活动预设和注册表计数 bettersettings.info
/settings validate 显示已加载、不可用、跳过、重复和无效的数量 bettersettings.validate

开发者 API

原始的 Setting、SettingsRegistry.registerSetting(...)、布尔数据方法和布尔事件仍然可用。版本 1.1 新增了 ValueSetting、SettingType、SettingOption、SettingBehavior、字符串值方法、类型化注册以及 PlayerSettingValueChangeEvent。

SettingsRegistry.getInstance().registerSetting(new MyCustomSetting());

要求与兼容性

  • Java 21 或更高版本
  • Paper 1.20.5 或更高版本
  • 无需第三方插件

相同的 Java 21 制品已在 Java 21 环境下的 Paper 1.20.5 以及 Java 25 环境下的稳定版 Paper 26.2 上进行了测试。由于 Folia 的完整运行时旅程尚未得到验证,因此 1.1 版本未宣传对其支持。Paper 26.3 目前仅作为实验性的冒烟测试目标,而非宣传的稳定支持。

从 1.0 升级

  1. 按照正常的操作规范备份 plugins/BetterSettings/ 目录。
  2. 用 BetterSettings-1.1.0.jar 替换旧的 JAR 文件。
  3. 保持现有的配置文件和玩家数据文件不变。
  4. 重启服务器并运行 /settings validate。

现有文件不会被覆盖。现有的布尔型玩家值保持为布尔值,活动预设默认为 classic,新捆绑的文件仅在缺失时进行复制。


支持

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源