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)。这使得整个插件套件能够共享同一个设置菜单和同一个按玩家划分的语言选择。
安装
- 需要 Paper 或 Purpur 26.3 以及 Java 25(2.0.0 版本运行于 26.2,1.x 版本运行于 1.21.x)。
- 将
PlayerSettings-2.0.0.jar 放入服务器的 plugins/ 文件夹中。
- 启动服务器并根据需要编辑
plugins/PlayerSettings/config.yml,然后执行 /settings reload。
无需外部依赖。
支持 / 源码
源代码:
PlayerSettings
Version 2.1.0 · Paper/Purpur 26.3 · Java 25
A central hub for per-player preferences. PlayerSettings gives players one clean GUI to pick
their language and toggle preferences, and gives developers a simple API so every plugin can
register its own settings in the same menu instead of scattering commands across the server.
Features
- One settings menu —
/settings opens a paginated GUI. No more one command per preference.
- Language selection — players choose their locale (English, Portuguese, French out of the
box) from a sub-menu; other plugins can honour that choice for their own messages.
- Auto-detection — a player's client language is detected on join and used as their default
until they choose otherwise.
- Developer API — registered via Bukkit's
ServicesManager. Plugins can register toggle,
enum and numeric settings, group them into categories, and read per-player values by UUID.
- Fast reads — values are cached in memory with write-through persistence, so lookups from
consumer plugins are cheap.
- SQLite storage — preferences are persisted per player with prepared statements.
- Safe by design — every write path operates on the player's own UUID; there is no command
or path for a player to edit another player's settings.
Commands
| Command |
Description |
Permission |
/settings |
Open the settings menu |
playersettings.use |
/settings language <locale> |
Set your language directly |
playersettings.use |
/settings reload |
Reload the configuration |
playersettings.admin |
Aliases: /prefs, /options.
Permissions
| Node |
Description |
Default |
playersettings.use |
Open and use the settings menu |
true |
playersettings.admin |
Reload the PlayerSettings configuration |
op |
Configuration
# Default language for new players / players who haven't chosen.
# Ships as pt_PT — set en_US here for English-speaking servers.
default-language: pt_PT
# Languages players can choose from in the 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 only for now
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"
Notable keys:
languages — the locales offered in the GUI. Each consumer plugin should ship its own
lang files for these locales; PlayerSettings only needs lang files for its own GUI messages.
gui.* — display names and item materials used to render the menus (MiniMessage format).
For developers
PlayerSettings exposes PlayerSettingsApi through the Bukkit ServicesManager. Other plugins
can register categories and toggle/enum/numeric settings, and read the current value for any
player by UUID (getBoolean, getString, getLanguage, set). This lets a whole plugin
suite share a single settings menu and a single per-player language choice.
Installation
- Requires Paper or Purpur 26.3 and Java 25 (2.0.0 runs on 26.2, 1.x on 1.21.x).
- Drop
PlayerSettings-2.0.0.jar into your server's plugins/ folder.
- Start the server and edit
plugins/PlayerSettings/config.yml as needed, then /settings reload.
No external dependencies are required.
Support / Source
Source code:
评论 0
登录后参与评分
还没有评论,来抢沙发吧