PlayerSettings

插件

· 作者 roguiii

集中化的玩家设置中心,提供简洁的图形界面和开发者 API。玩家可以选择语言并切换偏好;其他插件可以注册自己的设置,并通过它读取每个玩家的设置值。

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

最新 2.1.0+mc26.3 · 26.3 · Paper / Purpur

一键开服(送7天)

PlayerSettings

版本 2.1.0 · Paper/Purpur 26.3 · Java 25

一个集中管理玩家个人偏好的中心枢纽。PlayerSettings 为玩家提供了一个简洁的 GUI,用于选择语言和切换偏好设置;同时为开发者提供了简单的 API,使得每个插件都能在同一菜单中注册自己的设置,而不是在服务器中分散各种命令。

功能特性

  • 单一设置菜单 — /settings 打开分页式 GUI。不再需要为每个偏好设置单独的命令。
  • 语言选择 — 玩家可以从子菜单中选择自己的区域设置(默认提供英语、葡萄牙语、法语);其他插件可以尊重这一选择以显示其自身的消息。
  • 自动检测 — 玩家加入时会自动检测其客户端语言,并将其作为默认语言,直到玩家手动更改为止。
  • 开发者 API — 通过 Bukkit 的 ServicesManager 进行注册。插件可以注册开关、枚举和数值类型设置,将其分组到不同类别中,并通过 UUID 读取每位玩家的设置值。
  • 快速读取 — 设置值缓存在内存中,并采用写穿透持久化机制,因此消费型插件的查询操作开销极低。
  • SQLite 存储 — 使用预编译语句将每位玩家的偏好设置持久化保存。
  • 设计安全 — 所有写入路径均基于玩家自身的 UUID 进行操作;不存在任何命令或路径允许玩家编辑其他玩家的设置。

命令

命令 描述 权限节点
/settings 打开设置菜单 playersettings.use
/settings language <locale> 直接设置你的语言 playersettings.use
/settings reload 重载配置 playersettings.admin

别名:/prefs, /options。

权限

节点 描述 默认值
playersettings.use 打开并使用设置菜单 true
playersettings.admin 重载 PlayerSettings 配置 op

配置

# 新玩家或未选择语言的玩家的默认语言。
# 默认附带 pt_PT —— 若服务器面向英语用户,请在此处设置为 en_US。
default-language: pt_PT

# 玩家在 GUI 中可选的语言列表。
languages:
  en_US:
    display-name: "<white>English"
    material: PAPER
  pt_PT:
    display-name: "<white>Português"
    material: PAPER
  fr_FR:
    display-name: "<white>Français"
    material: PAPER

storage:
  type: sqlite   # 目前仅支持 sqlite
  file: "settings.db"

gui:
  title: "<dark_gray>Settings"
  language-title: "<dark_gray>Select Language"
  toggle-on-material: LIME_WOOL
  toggle-off-material: RED_WOOL
  filler-material: BLACK_STAINED_GLASS_PANE
  close-material: BARRIER

sounds:
  open-menu: "minecraft:ui.button.click"
  toggle: "minecraft:ui.button.click"
  select-language: "minecraft:entity.experience_orb.pickup"

重要键说明:

  • languages — GUI 中提供的区域设置列表。每个消费型插件应为其所支持的这些区域设置提供各自的 lang 文件;PlayerSettings 仅需为其自身 GUI 消息提供 lang 文件。
  • gui.* — 用于渲染菜单的显示名称和项目材质(MiniMessage 格式)。

给开发者

PlayerSettings 通过 Bukkit ServicesManager 暴露了 PlayerSettingsApi。其他插件可以注册分类以及开关/枚举/数值类型设置,并通过 UUID 读取任意玩家的当前值(getBoolean、getString、getLanguage、set)。这使得整个插件套件能够共享同一个设置菜单和同一个按玩家划分的语言选择。

安装

  1. 需要 Paper 或 Purpur 26.3 以及 Java 25(2.0.0 版本运行于 26.2,1.x 版本运行于 1.21.x)。
  2. 将 PlayerSettings-2.0.0.jar 放入服务器的 plugins/ 文件夹中。
  3. 启动服务器并根据需要编辑 plugins/PlayerSettings/config.yml,然后执行 /settings reload。

无需外部依赖。

支持 / 源码

源代码:

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源