QySuits – 套装

简介

QySuits 是一款基于 DragonCore 的套装系统插件，提供套装属性加成、技能系统、图鉴收集、HUD 显示等功能。

依赖

插件	类型	说明
DragonCore	必须	龙核客户端框架
AttributePlus	必须	属性系统
QySQL	可选	数据库前置(开启套装图鉴需要)
MythicMobs	可选	技能释放（开启技能模块时需要）
PlaceholderAPI	可选	PAPI 变量支持

目录结构

plugins/QySuits/
├── config.yml          # 主配置
├── message.yml         # 消息配置
├── suits/              # 套装定义（每个yml可含多个套装）
│   └── example.yml
├── skills/             # 技能定义（每个yml可含多个技能）
│   └── example.yml
└── graphical/          # 龙核界面配置（自动生成，勿删）
    ├── suit-collection.yml
    └── suit-hud.yml

---

模块开关

在 config.yml 的 modules 节点控制各功能模块：

modules:
  database: true      # 数据库（关闭则图鉴不可用）
  collection: true    # 图鉴收集（需要 database）
  hud: true           # HUD 显示（套装BUFF + 技能栏）
  skill: true         # 技能系统（需要 MythicMobs）
  itemtip: true       # 物品悬浮提示

---

套装配置

在 suits/ 目录下创建 yml 文件，每个文件可包含多个套装，以主节点名作为套装ID。

凛冬王权:
  name: "&b凛冬王权"
  quality: "&3卓越"
  icon: "http://your-server.com/textures/frost_suit.png"
  description:
    - "&7来自北境的远古寒冰铸就"

  # 激活条件（可选）
  # 格式: papi,PAPI变量,比较符,目标值
  conditions:
    - 'papi,%player_level%,>=,10'

  # 装备部件: '展示名<->匹配标识<->槽位(可选)'
  parts:
    - '冰封头盔<->frost_helmet<->[MC]Helmet'
    - '冰封胸甲<->frost_chestplate<->[MC]Chestplate'
    - '冰封护腿<->frost_leggings<->[MC]Leggings'
    - '冰封靴子<->frost_boots<->[MC]Boots'
    - '冰封之刃<->frost_sword<->[MC]MainHand'

  # 分阶效果
  effects:
    2:
      attributes:
        - "生命上限: 80"
      display:
        activated:
          - "&f生命上限 &a+80"
        inactivated:
          - "&7激活后显示详细属性"
      passive-skills: []
      active-skills: []
    4:
      attributes:
        - "生命上限: 200"
        - "普通防御: 25"
      display:
        activated:
          - "&f生命上限 &a+200"
          - "&f普通防御 &a+25"
        inactivated:
          - "&7激活后显示详细属性"
      passive-skills:
        - "冰霜护盾"
      active-skills:
        - "冰霜新星"

  # 图鉴收集属性（集齐全部部件后永久生效）
  collection:
    attributes:
      - "生命上限: 30"
    display:
      - "&f生命上限 &a+30"

  # 集齐奖励（只能领取一次）
  # %player% 替换为玩家名
  collection-reward:
    - "give %player% diamond 5"

部件格式说明

'展示名<->匹配标识<->槽位'

• 展示名：图鉴界面显示的名称
• 匹配标识：根据 config.yml 的 match.mode 决定含义

• • nbt 模式：物品 NBT 中 qysuits_part 的值
  • lore 模式：物品 Lore 中需包含的文本
  • name 模式：物品显示名需包含的文本

• 槽位（可选）：不填则任意已配置槽位均可，填写则只有对应槽位才生效

物品匹配模式

NBT 模式下，物品需要包含以下 NBT 标签：

• qysuits_id: 套装ID（与配置主节点名一致）
• qysuits_part: 部件标识（与 parts 中 <-> 后的值一致）

---

技能配置

在 skills/ 目录下创建 yml 文件，每个文件可包含多个技能。技能可被多个套装共享引用。

主动技能

冰霜新星:
  type: "active"
  name: "&b冰霜新星"
  icon: "http://your-server.com/textures/frost_nova.png"
  description:
    - "&7释放冰霜能量"
  cooldown: 15
  mythic-skill: "FrostNova"

被动技能（受伤触发）

冰霜护盾:
  type: "passive"
  name: "&b冰霜护盾"
  icon: "http://your-server.com/textures/frost_shield.png"
  description:
    - "&7受击时概率冻结攻击者"
  trigger:
    type: "on_hurt"
    chance: 10
    cooldown: 5
  mythic-skill: "FrostShield"

被动技能（周期触发）

生命回复:
  type: "passive"
  name: "&a生命回复"
  icon: "http://your-server.com/textures/heal.png"
  description:
    - "&7每5秒恢复生命"
  trigger:
    type: "periodic"
    interval: 100
  mythic-skill: "HealAura"

技能释放通过 MythicMobs API 执行，mythic-skill 填写 MM 中定义的技能ID。

---

槽位配置

slots:
  - '[MC]Helmet'
  - '[MC]Chestplate'
  - '[MC]Leggings'
  - '[MC]Boots'
  - '[MC]MainHand'
  - '[MC]OffHand'
  - '戒指槽位'        # 龙核自定义槽位

只有在此列表中的槽位才会被检测。原版槽位使用 [MC] 前缀，龙核槽位直接填写槽位名。

---

属性配置

attribute:
  overlay: false          # 多阶属性是否叠加（false=只取最高阶）
  allow-duplicate: false  # 重复装备是否计入件数
  check-interval: 20     # 检测间隔（tick）

---

命令

命令	权限	说明
/qysuits reload	qysuits.admin	重载配置
/qysuits check [玩家]	–	查看套装激活状态
/qysuits open [玩家]	–	打开图鉴界面
/qysuits give <玩家> <套装ID> [部件ID]	qysuits.admin	解锁图鉴（不填部件则解锁整套）
/qysuits reset <玩家> [套装ID]	qysuits.admin	重置图鉴数据（含奖励领取记录）

---

PlaceholderAPI 变量

前缀：%qysuits_

变量	说明
%qysuits_suit_count%	当前激活套装数量
%qysuits_suit_<套装ID>_count%	指定套装激活件数
%qysuits_suit_<套装ID>_max%	指定套装最大件数
%qysuits_suit_<套装ID>_name%	指定套装名称
%qysuits_suit_<套装ID>_active%	是否激活（true/false）
%qysuits_skill_count%	当前激活主动技能数量
%qysuits_skill_<索引>_name%	技能名称（索引从0开始）
%qysuits_skill_<索引>_type%	技能类型（active/passive）
%qysuits_skill_<索引>_cd%	当前剩余冷却秒数（精确到0.1）
%qysuits_skill_<索引>_maxcd%	最大冷却秒数（精确到0.1）

---

ItemTip 对接

在龙核 ItemTip 界面的 Functions 中添加：

Functions:
  open: |-
    界面变量.物品 = 方法.序列化物品(方法.取物品('mouse'));
    方法.发包('QySuits','suititemtip',方法.取玩家名,界面变量.物品);

服务端会将对应套装信息同步到客户端变量 QySuits_Info，在界面中使用：

方法.取变量('QySuits_Info')

---

HUD 说明

开启 modules.hud 后，玩家进入服务器会自动显示 HUD（右上角）：

• 上方：当前激活套装的 BUFF 图标
• 下方：主动技能栏图标（点击释放技能）

HUD 会在以下时机自动更新：

• 套装激活/失效时
• 技能释放后
• 龙核重载后自动恢复

---

图鉴系统

开启 modules.database + modules.collection 后：

• 玩家穿戴套装部件时自动记录到图鉴
• 通过 /qysuits open 或指令打开图鉴界面
• 左侧显示所有套装列表（支持翻页）
• 右侧显示选中套装的详情（部件收集状态、套装效果、收集属性）
• 集齐全部部件后：

• • 收集属性永久生效（无需穿戴）
  • 可领取一次性奖励

---

权限

权限	默认	说明
qysuits.admin	OP	管理员命令（reload/give/reset）
qysuits.use	所有人	基础使用权限