原创 娱乐 [1.20.1-1.21.5] SagaAccessories 饰品背包属性插件 1.0.0

SagaAccessories​

SagaAccessories 是一个功能强大的 Minecraft 饰品插件，为玩家提供额外的装备槽位和属性加成系统。

功能特性​

• 双重饰品系统：支持背包栏位饰品和专用GUI饰品栏
• 实时属性更新：与 SagaLoreStats 深度集成，提供流畅的属性体验
• 数据持久化：使用 SQLite MySQL数据库安全存储玩家饰品数据
• 完全可定制：所有界面、消息、配置均可自定义

依赖要求​

• 必需依赖：SagaLoreStats - 提供属性系统支持
• 服务器版本：Bukkit 1.20.1 - 1.21.5
• Java版本：Java 17+

安装方法​

1. 确保服务器已安装 SagaLoreStats 插件
2. 将 SagaAccessories.jar 放入服务器的 plugins 文件夹
3. 重启服务器或使用 /reload 命令
4. 插件将自动生成配置文件

核心功能​

背包栏位饰品系统​

在指定的背包槽位放置特定类型的饰品，即可获得属性加成：

• 戒指：快捷栏第1格 (槽位0)
• 手环：快捷栏第2格 (槽位1)
• 护符：快捷栏第9格 (槽位8)
• 徽章：主背包右下角 (槽位35)

GUI饰品栏系统​

通过专用的饰品GUI管理额外的饰品：

• 项链、耳环、宝玉 等类型
• 5个专用饰品槽位 (槽位20-24)
• 装备展示区域，可查看当前装备
• 支持查看其他玩家的饰品

属性系统集成​

• 自动识别物品Lore中的属性信息
• 支持所有 SagaLoreStats 兼容的属性格式
• 实时属性计算和应用
• 智能属性源管理，避免冲突
  
  
  
  
• [MD]
  [*]## 指令系统
  ### 主指令：`/sagaaccessories` (别名: `/sacc`, `/acc`)
  | 子指令 | 权限 | 描述 |
  |--------|------|------|
  | `open` | `sagaaccessories.open` | 打开自己的饰品GUI |
  | `view <玩家名>` | `sagaaccessories.view` | 查看指定玩家的饰品 |
  | `reload` | `sagaaccessories.reload` | 重载插件配置 |
  ### 使用示例
  ```bash
  /sacc open # 打开饰品栏
  /sacc view Steve # 查看Steve的饰品
  /sacc reload # 重载配置
  ```
  ## 权限节点
  | 权限 | 默认 | 描述 |
  |------|------|------|
  | `sagaaccessories.open` | `true` | 允许打开自己的饰品GUI |
  | `sagaaccessories.view` | `op` | 允许查看其他玩家的饰品 |
  | `sagaaccessories.reload` | `op` | 允许重载插件配置 |
  ## 配置文件详解
  ### config.yml - 主配置
  ```yaml
  # 是否开启Debug模式
  debug: false
  # 属性更新延迟(tick)，防止频繁操作导致的性能问题
  update-delay-ticks: 3
  ```
  ### accessories.yml - 饰品配置
  ```yaml
  # 饰品配置文件
  # 饰品Lore识别格式
  # {type} 会被替换为饰品类型 (如 "戒指", "手环", "项链", "耳环" 等)
  # 示例Lore: "饰品：戒指"
  lore-format: "饰品: {type}"
  # 饰品槽位限制
  # 格式: "饰品类型": 槽位编号
  # 槽位编号从1开始，1=第一行左边第一个，9=第一行右边最后一个，54=第六行右边最后一个
  # 只有放在指定槽位的对应类型饰品才会属性生效
  accessory-slots:
  "戒指": 1 # 戒指只能放在第1格生效
  "项链": 2 # 项链只能放在第2格生效
  "耳环": 3 # 耳环只能放在第3格生效
  "手环": 4 # 手环只能放在第4格生效
  "护符": 5 # 护符只能放在第5格生效
  ```
  ### gui.yml - 界面配置
  ```yaml
  # 饰品GUI配置文件
  # GUI标题，支持颜色代码 (&)
  title: "&8[&6&l饰品栏&8]"
  # GUI大小，必须是9的倍数 (9, 18, 27, 36, 45, 54)
  size: 9
  ```
  ### message.yml - 消息配置
  ```yaml
  # 消息配置文件
  prefix: "&8[&6SagaAccessories&8] &r"
  # 指令相关消息
  no-permission: "&c你没有权限执行此操作。"
  reload-success: "&a插件配置已成功重载！"
  reload-error: "&c重载配置时发生错误，请查看控制台获取详细信息。"
  player-only-command: "&c该指令只能由玩家执行。"
  player-not-found: "&c未找到名为 &e{player} &c的玩家。"
  usage:
  open: "&e用法: /sacc open"
  view: "&e用法: /sacc view <玩家名>"
  reload: "&e用法: /sacc reload"
  # GUI相关消息
  view-gui-title: "&8{player} 的饰品"
  # 数据库相关消息
  database:
  sqlite-connected: "&a成功连接到SQLite数据库。"
  mysql-connected: "&a成功连接到MySQL数据库。"
  connection-failed: "&c无法连接到数据库: {error}"
  table-initialized: "&a数据库表 {table} 初始化完成。"
  table-creation-failed: "&c创建数据库表时出错: {error}"
  disconnected: "&a已断开与{type}数据库的连接。"
  close-failed: "&c关闭数据库连接时出错: {error}"
  ```
  ## 饰品制作指南
  ### 创建背包饰品
  1. 准备任意物品
  2. 添加识别Lore：`饰品：戒指`
  3. 添加属性Lore：`物理伤害: +10`
  4. 将物品放入对应槽位即可生效
  ### 创建GUI饰品
  1. 准备任意物品
  2. 添加识别Lore：`饰品：项链`
  3. 添加属性Lore：`生命值: +50`
  4. 通过 `/sacc open` 打开GUI并放入饰品槽位
  [*][/MD]