- 版权类型
- 原创
- 插件中文名称
- luckxa饰品
- 插件英文名称
- luckxaccessories
- 原帖地址
- #
- 支持的核心（服务端）
- Paper
- 语言支持
- 中文（简体）
- 前置组件
- PlaceholderAPI[必要]
CraneAttribute
AttributePlus
SX-Attribute
- 适配版本（Java）
- 1.21
插件介绍
一个完全由YAML 驱动的饰品（饰品栏/装备）系统。玩家在饰品背包界面里装备饰品后，插件会把饰品上的属性传给属性插件（AttributePlus / SX-Attribute/CraneAttribute）实时生效，并支持套装加成、权限解锁槽位、一键装满/卸下、属性对比预览等，一套基础饰品链路的完整实现。它不是“多几个展示栏”，而是一整套可落地的养成模块。界面、槽位、适配、套装、交互，全部由配置文件驱动，无需改代码。
核心特色
- 完全配置驱动：每格可自设饰品槽 / 隔行板 / 功能按钮（summary/close），留空为深色玻璃。- 多饰品栏：1号 / 2号 / 3号 / 4号 独立面板，`currentPage` 可设默认页。
- 属性实时生效：装备/卸下即更新，与装备属性同源。
- 套装加成：`suit.yml` 按 Lore 标识 + 件数喂给属性系统，进度条直观显示。
- 属性对比预览：手持可装入的饰品时，预览装备前后的每项属性差值。
- 权限解锁槽位：`permission: luckxa.slot.x`，未解锁显示锁定图标，不可放入/换/卸。
- 一键装满 / 一键卸下：`autofill` / `clear`，GUI 内也有对应按钮。
- 顺手交互：左键手持匹配饰品直接交换、右键手持直接打开对应饰品栏、支持拖拽放入。
- 交互反馈：装备/卸下/拒绝音效 + 粒子，config 可配。
- 物品类别限制：禁止武器/工具/护甲/食物入槽。
- PlaceholderAPI 占位符：`%luckxa_equipped_count%`、`%luckxa_active_sets%`、`%luckxa_total_<属性名>%`、`%luckxa_set_<key>_count|max%`。
- 持久：Bukkit 对象流 Base64（不碰 NMS，跨版本稳定），5 分钟异步自动保存。
指令
/luckxa [面板名] 打开默认或指定饰品栏（如 /luckxa 1号、/luckxa 2号）/luckxa autofill [面板名] 一键把背包里匹配饰品放入空槽
/luckxa clear [面板名] 一键卸下该面板全部饰品
/luckxa see <玩家> [面板名] 查看玩家饰品（管理员）
/luckxa reload 重载插件数据（管理员）
/luckxa test [类型] 发放指定类型测试饰品（管理员）
/luckxa suit 发放套装测试饰品（管理员）
权限节点
luckxa.use 玩家使用权限（默认 true）luckxa.admin 管理员权限（默认 op）
luckxa.slot.<面板>_<槽位> 单个槽位解锁（如 luckxa.slot.2_10），配在槽位 permission 项
配置文件
代码：
config.yml（节选，完全 YAML 驱动）
```yaml
Source: Crane # 属性源：Crane | AttributePlus | SX-Attribute
Title: "&6&l饰品系统"
match: lore
vague: false
currentPage: "1号" # 默认打开的饰品栏
Glass:
Empty: BLACK_STAINED_GLASS_PANE
Separator: BLACK_STAINED_GLASS_PANE
Locked: BARRIER # 未解锁槽位图标
Restrictions:
DenyCategories: [WEAPON, TOOL, ARMOR, FOOD]
Pages:
"1号":
Title: "&6&l1号饰品栏"
Settings:
0: {type: 古遗物, info: ["&7此处放置 古遗物"]}
4: {function: summary}
49: {function: close}
```
suit.yml（套装）
```yaml
# 每个套装 = lore 标识 + 多个件数的属性加成
# 饰品 Lore 含该标识即计入该套装；达到件数生效加成，喂给属性系统
WastelandSoul:
id: "&6荒原之魂"
effects:
2:
- "&6物理攻击: +50"
4:
- "&6生命值: +200"
```
兼容版本 / 前置
- 支持：Paper 1.21.11（1.21.x，api-version 1.21），Java 21。- 无硬依赖；属性系统三选一，一个都不装则只显示不加属性。
- PlaceholderAPI：可选，装了才有 `%luckxa_*%` 占位符。
- 非 Paper 专属 API（不用 NMS），理论上 Spigot 1.21.x 也能跑，但推荐 Paper 1.21.11。
使用提示
- 饰品物品建议用 MythicMobs 生成，Lore 写属性行（鹤合法属性名）+ 匹配标识（如 `&7&n古遗物`）。- 面板用指令直接打开（取消翻页），默认页由 `currentPage` 指定。
- 2号之类带权限专属槽位的面板，需授予对应 `luckxa.slot.*` 才能放入。
截图
反馈 / 问题：请在主题内回复或私信。
