跳到主要内容

EMC 自定义饰品

EMC 自定义饰品（EMCAccessoryLib）是 EMC RPG 生态的装备扩展插件，提供 9 个饰品槽位、7 级稀有度、套装系统、强化系统、被动/触发效果 和 元素抗性，为服务器打造完整的饰品养成体系。

核心特性​

  • 9 个装备槽位 — 头饰、项链、耳饰、戒指(左/右)、手镯、腰带、护符、徽章，可按需解锁
  • 7 级稀有度 — 粗糙/普通/精良/稀有/史诗/传说/神话，影响属性倍率和最大词缀数
  • 14+ 属性加成 — 生命、防御、魔抗、攻击、魔伤、移速、暴击率、暴击伤害、吸血、闪避、格挡、荆棘、经验加成、掉落加成
  • 元素伤害与抗性 — 火焰、冰霜、雷电、剧毒、虚空元素的伤害和抗性加成
  • 被动效果 — 持续药水效果（夜视、急迫、生命恢复等），每 10 秒自动刷新
  • 触发效果 — 攻击/受伤/击杀/暴击/低血量/周期 6 种触发时机，5 种效果类型
  • +15 强化系统 — 每级 +3% 属性加成，高级强化有概率失败降级
  • 套装系统 — 多件饰品组成套装，集齐不同件数解锁阶段性加成
  • GUI 面板 — 可视化饰品面板，右键交互装备/卸下/强化
  • 物品库联动 — 饰品外观物品来自 EMC 高级物品库
  • 玩家属性联动 — 向 EMC 玩家属性注册属性提供者和伤害处理器
  • 开放 API — EMCAccessoryAPI 供其他插件查询饰品信息

环境要求​

项目要求
服务端Paper/Spigot 1.8+
JavaJava 8+
必需依赖EMC 物品库、EMC 玩家属性
推荐依赖EMC 自定义武器（武器联动）

安装步骤​

  1. 确保已安装 EMC 物品库和 EMC 玩家属性
  2. 将 EMC自定义饰品.jar 放入 plugins/ 目录
  3. 启动服务器，插件自动生成：
    • config.yml — 全局配置（默认槽位、强化设置）
    • accessories/example.yml — 示例饰品配置
    • sets/example.yml — 示例套装配置
  4. 在 accessories/ 和 sets/ 目录创建自定义配置
  5. 执行 /emcacc reload 重载

架构概览​

EMCAccessoryLib
├── 饰品管理器 (AccessoryManager)      — YAML 饰品定义加载与缓存
├── 玩家数据管理器 (PlayerDataManager) — 玩家饰品装备数据持久化
├── 套装管理器 (SetManager)            — 套装定义加载与加成计算
├── 效果管理器 (EffectManager)         — 被动/触发效果管理
├── GUI 管理器 (GUIManager)            — 饰品面板 GUI
├── 战斗监听器 (CombatListener)        — 触发效果与伤害处理
├── 玩家监听器 (PlayerListener)        — 登入/登出数据管理
├── 桥接层 (bridge)                     — 向 EMC 玩家属性注册属性提供者
├── 物品源 (AccessoryItemSource)       — 向 EMC 物品库注册饰品物品源
├── NBT 工具 (NBTUtil)                  — 跨版本 NBT/PDC 读写
└── 命令系统 (EMCAccessoryCommand)     — open/give/remove/list/reload/unlock

插件依赖关系​

EMC 物品库 ←─── EMC 自定义饰品 ───→ EMC 玩家属性
                      ↕
               EMC 自定义武器（可选）

饰品插件启动时会：

  1. 向 EMC 物品库注册 accessory 物品源
  2. 向 EMC 玩家属性注册属性提供者（饰品属性加成）和伤害处理器
  3. 检测 EMC 自定义武器并启用武器联动