基于 Spigot API 1.20.1 构建、适用于 Spigot 1.20+ 的称号插件，支持 SQLite/MySQL、TrMenu 风格可配置 GUI、自定义语言、称号商城、自定义称号、PlaceholderAPI、原版药水 Buff、AttributePlus 与 SX-Attribute 属性。
源码按生命周期编排、命令模块、称号目录、业务服务、GUI、外部插件适配和存储契约分层；数据库实现仍由 SQLite/MySQL JDBC 适配器提供，业务层不直接拼接存储类型。
- 执行
./gradlew build，成品位于build/libs/CloudTitle-2.3.jar。 - 将 JAR 放入服务端
plugins目录。 - MiniMessage、HikariCP、SQLite JDBC 与 MySQL Connector/J 由 Spigot LibraryLoader 在首次启动时从 Maven Central 加载，不会打包进插件 JAR。Vault、PlayerPoints、PlaceholderAPI、CraftEngine、AttributePlus 与 SX-Attribute 均为按需安装的软依赖。
- 首次启动后编辑
plugins/CloudTitle下的配置，使用/cloudtitle reload重载。存储类型切换需要重启服务端。
config.yml：服务器标识、自定义称号价格、币种、名称格式、豁免权限、属性联动和 Buff 刷新间隔。storage.yml：SQLite 或 MySQL 连接参数、配置版本和自定义表名。titles.yml：称号名称、描述、图标、药水 Buff、AP/SX 属性与商城条件。gui/warehouse.yml：称号仓库界面。gui/shop.yml：称号商城界面。gui/custom.yml：称号工坊界面。lang/zh_cn.yml：中文通用消息（兼容旧的lang/zh_CN.yml）。lang/en_us.yml：英文通用消息；可通过default-language和language-fallback选择。
每个 GUI 文件均由 Title、Layout、Icons 组成。Layout 每行固定 9 个字符，共 1 至 6 行，字符会读取 Icons 中同名节点：
Title: "<aqua>示例菜单"
Layout:
- "#########"
- "#TTTTTTT#"
- "#########"
Icons:
'#':
Display:
Material: BLACK_STAINED_GLASS_PANE
Name: " "
'T':
Type: title
Display:
Material: "%title_material%"
Name: "%title_name%"
Lore: ["%title_description%"]
Actions:
all: ["title: select"]每个 GUI 可通过 Options.Click-Cooldown-Millis 单独设置按钮点击冷却，范围为 0-5000 毫秒，0 表示关闭限制。插件重载或卸载时会自动关闭所有由本插件打开的 GUI，并取消未完成的自定义称号输入。
显示项支持 Material、Amount、Name、Lore、Glow、Custom-Model-Data 和 Item-Flags。动作支持 all、left、right、shift-left、shift-right。
内置动作包括：
menu: previous、menu: next、menu: warehouse、menu: shop、menu: customtitle: select、title: buy、title: clearcustom: edit-name、custom: edit-description、custom: createclose、message: <MiniMessage>、player: <命令>、console: <命令>、sound: <音效> [音量] [音调]
图标还可配置 Conditions：Permission/Permissions 用于权限门槛，或用 Placeholder、Operator、Value 判断 PlaceholderAPI 数值；条件不满足时图标不会渲染。
常用变量包括 %player%、%page%、%max_page%、%owned_count%、%title_id%、%title_name%、%title_material%、%title_description%、%title_buffs%、%title_attributes%、%title_cost%、%title_status%、%custom_name%、%custom_description% 与 %custom_cost%。
称号名称支持直接输入颜色代码，例如 &a[勇者]&r、§b探险家、7FFFF云旅者 或 &x&5&5&F&F&F&F彩色称号。插件会将传统颜色代码转换为 MiniMessage；custom-title.allow-minimessage: true 时还会保留名称中的 MiniMessage 标签。描述字段仍按该配置决定是否允许 MiniMessage。
单服默认使用 SQLite。跨服网络应让所有子服连接同一个 MySQL 数据库，并给每台子服设置唯一的 server-id。
四张数据表可在 storage.yml -> tables 中分别修改：players、owned、custom-titles、item-progress。表名必须以字母开头，只能包含字母、数字和下划线。修改表名会创建新表，不会自动迁移旧表中的数据。
插件会持久化自己施加的药水类型、等级和负责服务器。玩家进入新服时先清除上一服记录的同等级效果，再施加当前称号效果；旧服延迟到达的退出事件不会覆盖新服状态。插件不会删除其他系统后来施加的更高等级效果。
titles.yml 中的 shop.type 支持：
money：Vault 金币points：PlayerPoints 点券permission：拥有指定权限即可领取item：提交原版或 CraftEngine 物品，支持跨重启、跨服分段提交papi：读取 PlaceholderAPI 变量并进行数值比较free：免费领取
物品兑换示例：
shop:
type: item
items:
- source: vanilla
id: DIRT
amount: 1000
display: "<white>泥土</white>"
# CraftEngine 物品：
# - source: craftengine
# id: your_namespace:your_item
# amount: 100
# display: "<aqua>自定义物品</aqua>"玩家每次点击商城称号时会提交背包中当前可用的物品，进度持久化在 item-progress 表。原版物品按 Material 精确识别，并排除底层材质相同的 CraftEngine 自定义物品；CraftEngine 物品按完整 namespace:id 识别。
PAPI 数值条件示例：
shop:
type: papi
papi-conditions:
- placeholder: "%player_level%"
operator: ">="
value: 30
display: "<white>玩家等级达到 30 级</white>"支持的运算符为 >、>=、<、<=、==、!=。配置多条 papi-conditions 时必须全部满足。变量结果必须能解析为数值，支持整数、小数和带千分位逗号的数值。商城 GUI 会实时显示当前值、目标值和判断结果；requirement-display 中可使用 %papi_conditions%。
shop.enabled 控制该称号能否通过商城购买，shop.display 单独控制是否在商城 GUI 中显示。隐藏的称号仍可由管理员发放。requirement-display 可覆盖 GUI 中的获取条件文案，留空则按照商城类型自动生成中文文案。
配置文件带有 config-version。插件升级时只补齐缺失字段并保留现有注释；存储类型、数据库连接、server-id 和 Buff 定时周期修改后需要完整重启。
bypass-permission 可让指定权限跳过费用或领取条件。Buff 名称支持现代 Minecraft 名称（例如 HASTE），在 Spigot 1.20.1 中会自动兼容旧 Bukkit 名称 FAST_DIGGING；amplifier: 0 表示 I 级。GUI 名称和显示格式可在 lang/zh_cn.yml 或 lang/en_us.yml 的 potion-effects 与 buff-display 中修改。
称号可分别配置两套属性插件的原生 Lore 词条：
attributes:
attribute-plus:
- "物理伤害:5"
- "生命上限:20"
sx-attribute:
- "攻击力: 5"
- "生命上限: 20"词条名称与格式由对应属性插件决定。CloudTitle 通过运行时 API 创建独立属性来源，不会将 AP/SX 打包进插件，也不会通过 LibraryLoader 下载它们。AttributePlus 支持 3.3.x 属性源 API；SX-Attribute 同时兼容 3.9+ 命名来源 API 与 3.5 等旧版 Class 分源 API。
玩家登录、佩戴、切换和重载时会重新应用当前称号来源；卸下、回收当前称号、退出或插件卸载时会清理。切换时先删除旧来源，因此不会重复叠加。buffs.refresh-ticks 只刷新原版药水效果，不会重复添加第三方属性。GUI 属性显示可在 lang/zh_cn.yml -> attribute-display 修改。
/cloudtitle：打开称号仓库（兼容旧用法）/cloudtitle help：显示分组美化的命令帮助/cloudtitle menu [warehouse|shop|custom]：打开指定菜单/cloudtitle shop：打开称号商城/cloudtitle custom：打开称号工坊/cloudtitle set <id>、/cloudtitle clear：佩戴或卸下/cloudtitle delete <id>：删除自己创建的自定义称号/cloudtitle grant|revoke <玩家> <id>：管理员发放或回收/cloudtitle delete <玩家> <id>：管理员删除指定玩家的自定义称号/cloudtitle reload：重载配置
基础权限为 cloudtitle.use，管理权限为 cloudtitle.admin，自定义权限为 cloudtitle.custom，默认自定义费用豁免权限为 cloudtitle.custom.bypass。
帮助页面由语言文件中的 command-help-header、command-help-title、command-help-player、command-help-admin 和 command-help-footer 控制，可直接调整颜色、分隔线与命令说明。旧版只包含 command-help 列表的语言文件仍会自动套用页眉页脚。
命令路由仅保留帮助页列出的入口；自定义称号删除统一使用 /cloudtitle delete，不再提供未列出的旧别名。
%cloudtitle_title%：当前称号，传统颜色代码格式%cloudtitle_title_minimessage%：当前称号 MiniMessage 原文%cloudtitle_title_plain%：当前称号纯文本%cloudtitle_description%：当前称号描述%cloudtitle_selected_id%：当前称号 ID%cloudtitle_owned_count%：仓库称号数量
PAPI 查询只读取登录时异步加载的缓存，不会在聊天或计分板刷新时访问数据库。
玩家未佩戴称号时，显示变量会回退到 config.yml -> default-title.id 指定的称号。默认示例为 resident（云世界居民）。该回退只影响显示，不会授予称号、写入数据库，也不会施加 Buff 或 AP/SX 属性。%cloudtitle_selected_id% 返回真实佩戴 ID，%cloudtitle_displayed_id% 返回最终显示 ID。
作者：MoutainSeaL ｜ QQ：3643203568 ｜ QQ 群：342097496
源码以 Java 17 编译，可运行于使用 Java 17 的 Spigot 1.20.1-1.20.4。Minecraft 1.20.5 及更高版本的服务端本身要求 Java 21，请按对应服务端要求选择 Java。