跳到主要内容

配置与饰品定义

全局配置 (config.yml)​

# EMC自定义饰品 全局配置

# 插件前缀（支持颜色码）
prefix: "&8[&d饰品&8] "

# 调试模式
debug: false

# 默认解锁的槽位（新玩家自动解锁）
# 可选: head, necklace, earring, ring_left, ring_right, bracelet, belt, charm, badge
default-unlocked-slots:
  - necklace
  - ring_left
  - belt

# 强化系统配置
enhance:
  # 每级强化属性提升百分比
  bonus-per-level: 0.03
  # 最大强化等级
  max-level: 15
  # 强化成功率 (等级 -> 成功率)
  success-rate:
    1: 1.0
    2: 1.0
    3: 1.0
    4: 1.0
    5: 1.0
    6: 0.8
    7: 0.7
    8: 0.6
    9: 0.5
    10: 0.4
    11: 0.3
    12: 0.2
    13: 0.15
    14: 0.1
    15: 0.05
  # 强化失败惩罚: NONE(无), DOWNGRADE(降级), DESTROY(销毁)
  fail-penalty: DOWNGRADE

参数说明​

参数说明
default-unlocked-slots新玩家默认解锁的槽位列表
enhance.bonus-per-level每级强化提升的属性百分比（默认 3%）
enhance.max-level最大强化等级（默认 15）
enhance.success-rate各等级的强化成功率
enhance.fail-penalty失败惩罚模式

饰品定义文件​

饰品配置位于 plugins/EMC自定义饰品/accessories/ 目录，支持多个 .yml 文件。

文件结构​

plugins/EMC自定义饰品/
├── config.yml
├── accessories/
│   ├── example.yml
│   ├── necklaces.yml
│   └── rings.yml
└── sets/
    └── example.yml

完整饰品配置示例​

dragon_necklace:
  name: "&6&l龙魂项链"
  item: "config:dragon_pendant"       # 物品库引用（可选）
  slot: necklace                       # 槽位类型
  rarity: EPIC                         # 固定稀有度（可选，不指定则由give命令决定）
  set: dragon_set                      # 所属套装ID（可选）

  # 基础属性
  attributes:
    health: 50.0
    defense: 15.0
    magic-defense: 10.0
    attack-damage: 5.0
    magic-damage: 3.0
    move-speed: 0.01
    crit-chance: 0.05
    crit-damage: 0.1

  # 特殊属性
  special:
    lifesteal: 0.03
    dodge: 0.02
    block: 0.0
    thorns: 0.05
    exp-bonus: 0.1
    drop-bonus: 0.05

  # 元素伤害
  elemental-damage:
    fire: 3.0
    ice: 0.0

  # 元素抗性
  elemental-resist:
    fire: 0.1
    poison: 0.05

  # 被动效果（持续药水效果）
  passive-effects:
    - type: NIGHT_VISION
      amplifier: 0
    - type: SPEED
      amplifier: 1

  # 触发效果
  trigger-effects:
    - trigger: ON_ATTACK      # 触发时机
      effect: DAMAGE           # 效果类型
      value: 5.0               # 效果值
      chance: 0.2              # 触发概率 (0.0-1.0)
      cooldown: 100            # 冷却时间（tick）
    - trigger: LOW_HEALTH
      effect: HEAL
      value: 10.0
      chance: 1.0
      cooldown: 600

  # 装备条件
  required-level: 20           # 需要玩家等级
  required-permission: vip     # 需要权限节点（可选）

  # 是否可强化
  enhanceable: true

  # 自定义 Lore 模板（可选）
  lore:
    - "&7远古龙族遗留的神秘项链"
    - "&7蕴含强大的龙魂之力"

槽位类型​

槽位配置键说明
头饰head头部饰品
项链necklace颈部饰品
耳饰earring耳部饰品
戒指(左)ring_left左手戒指
戒指(右)ring_right右手戒指
手镯bracelet手腕饰品
腰带belt腰部饰品
护符charm护符饰品
徽章badge胸前徽章

稀有度​

稀有度中文颜色属性倍率最大词缀
CRUDE粗糙&7 灰×0.51
COMMON普通&f 白×1.02
FINE精良&a 绿×1.33
RARE稀有&9 蓝×1.64
EPIC史诗&5 紫×2.05
LEGENDARY传说&6 金×2.56
MYTHIC神话&c 红×3.08

属性说明​

属性键名效果
health增加最大生命值
defense增加物理防御
magic-defense增加魔法防御
attack-damage增加物理攻击
magic-damage增加魔法伤害
move-speed增加移动速度
crit-chance增加暴击率
crit-damage增加暴击伤害倍率
lifesteal物理吸血百分比
dodge闪避率
block格挡率
thorns荆棘反伤百分比
exp-bonus经验获取加成
drop-bonus掉落加成

触发时机​

触发说明
ON_ATTACK攻击时触发
ON_HURT受伤时触发
ON_KILL击杀时触发
ON_CRIT暴击时触发
LOW_HEALTH低血量时触发
PERIODIC周期性触发

效果类型​

效果说明
DAMAGE额外伤害
HEAL治疗效果
POTION施加药水效果
SHIELD获得护盾
LIGHTNING雷击效果