跳到主要内容

配置与武器定义

全局配置 (config.yml)​

# EMC自定义武器 全局配置

# 插件前缀（支持颜色码）
prefix: "&8[&c EMC武器 &8] "

# 调试模式
debug: false

# 成长系统全局设置
growth:
  # 击杀怪物获得经验
  kill-exp:
    enabled: true
    default: 10
    # 按怪物类型调整经验倍率
    mob-multiplier:
      ENDER_DRAGON: 100.0
      WITHER: 80.0
      WARDEN: 50.0
      ELDER_GUARDIAN: 30.0
      RAVAGER: 5.0
      EVOKER: 3.0
      GHAST: 3.0
      BLAZE: 2.5
      SHULKER: 2.5
      ENDERMAN: 2.0
      # ... 更多怪物

  # 攻击获得经验（每次命中）
  hit-exp:
    enabled: true
    default: 1

  # 升级时是否全服广播
  broadcast-levelup: false

  # 升级消息（发送给持有者）
  levelup-message: "&a你的武器 &e{weapon_name} &a升级到了 &6Lv.{level}&a！"

# 暴击设置
crit:
  enabled: true
  message: "&c✦ 暴击！ &e{damage} &c伤害"
  particle: true

# 攻击源特效全局开关
attack-effects:
  slash-aoe: true          # 斩击范围伤害
  thrust-penetrate: true   # 刺击穿透
  blunt-knockback: true    # 钝击击退
  hidden-poison: true      # 暗器毒伤
  devour-lifesteal: true   # 吞噬吸血
  sonic-armor-ignore: true # 音波穿甲

# 锻造强化系统 (星级 ★1~★10)
forge:
  max-star: 10
  rates: [0.9, 0.85, 0.7, 0.6, 0.5, 0.4, 0.3, 0.2, 0.15, 0.1]
  fail-penalty: [0, 0, 0, 1, 1, 1, 2, 2, 2, 3]
  per-star-bonus: [0.03, 0.03, 0.03, 0.05, 0.05, 0.05, 0.07, 0.07, 0.07, 0.10]
  materials:
    1:
      IRON_INGOT: 5
    4:
      GOLD_INGOT: 10
      DIAMOND: 1
    7:
      DIAMOND: 5
      EMERALD: 3
    10:
      DIAMOND_BLOCK: 1
      NETHER_STAR: 1

# 重铸系统
reforge:
  exp-cost: 10
  max-count: 100
  materials:
    GOLD_INGOT: 5
    DIAMOND: 1

参数说明​

参数说明
growth.kill-exp.default击杀怪物的默认经验值
growth.kill-exp.mob-multiplier各怪物类型的经验倍率
growth.hit-exp.default每次命中获得的经验值
growth.broadcast-levelup升级时是否全服广播
crit.enabled是否启用暴击消息
crit.particle是否显示暴击粒子效果
attack-effects.*各攻击源特效的全局开关
forge.max-star锻造最高星级（默认 10）
forge.rates每颗星的成功率数组
forge.fail-penalty失败时降多少星（0=无惩罚）
forge.per-star-bonus每颗星的属性加成比例
forge.materials不同星级段的材料消耗
reforge.exp-cost每次重铸消耗的经验等级
reforge.max-count最大重铸次数
reforge.materials重铸消耗的材料

武器定义文件​

武器配置位于 plugins/EMC自定义武器/weapons/ 目录，支持多个 .yml 文件。

文件结构​

plugins/EMC自定义武器/
├── config.yml
└── weapons/
    ├── example.yml     ← 示例（首次启动自动生成）
    ├── swords.yml      ← 自定义：刀剑类
    ├── ranged.yml      ← 自定义：远程类
    └── magic.yml       ← 自定义：魔法类

完整武器配置格式​

weapon_id:
  # 武器名称（支持颜色码）
  name: "&c&l屠龙刀"

  # 物品库引用（来源:物品ID），留空使用默认钻石剑
  item: "config:example_sword"

  # 攻击源（18种之一）
  attack-source: SLASH

  # 武器子类型（可选，中文名或英文枚举名）
  weapon-type: "大刀"

  # 武器属性
  attributes:
    base-damage: 12.0        # 基础伤害
    attack-speed: 0.8         # 攻击速度
    crit-chance: 0.15         # 暴击率（0~1）
    crit-multiplier: 2.0      # 暴击倍率
    attack-range: 3.5         # 攻击范围
    armor-penetration: 5.0    # 穿甲值
    knockback: 0.3            # 击退力度
    lifesteal: 0.0            # 吸血率（0~1）

  # 元素伤害（可选，fire/ice/lightning/poison/void）
  elemental-damage:
    fire: 3.0

  # 成长配置（可选）
  growth:
    enabled: true
    max-level: 50
    exp-formula: "100 * level ^ 1.5"
    per-level:
      base-damage: 0.5
      crit-chance: 0.002
      crit-multiplier: 0.01
      attack-range: 0.02
      armor-penetration: 0.1
      knockback: 0.005
      lifesteal: 0.002
      attack-speed: 0.005

  # 额外描述文本（可选）
  lore:
    - "&7传说中斩杀巨龙的神兵"
    - "&7斩击带有炽热的龙焰"

属性说明​

属性默认值说明
base-damage5.0基础伤害值
attack-speed1.0攻击速度（值越高攻击越快）
crit-chance0.05暴击率，范围 0~1（0.15 = 15%）
crit-multiplier1.5暴击伤害倍率
attack-range3.0攻击范围（格）
armor-penetration0.0穿甲值（忽略的护甲点数）
knockback0.0击退力度
lifesteal0.0吸血率，范围 0~1（0.2 = 回复伤害的 20%）

元素伤害​

5 种元素类型：

元素键名效果
火焰fire点燃目标
冰霜ice减速目标
雷电lightning雷击效果
剧毒poison中毒持续伤害
虚空void虚空侵蚀
elemental-damage:
  fire: 3.0       # 附加 3.0 火焰伤害
  lightning: 5.0   # 附加 5.0 雷电伤害

一把武器可以同时拥有多种元素伤害。

经验公式​

成长系统的 exp-formula 使用数学表达式，level 为当前等级变量：

exp-formula: "100 * level ^ 1.5"    # Lv.1 需 100, Lv.10 需 3162
exp-formula: "50 * level ^ 2"       # Lv.1 需 50, Lv.10 需 5000
exp-formula: "80 * level ^ 1.3"     # Lv.1 需 80, Lv.10 需 1594

示例武器​

高暴击匕首​

shadow_dagger:
  name: "&8&l暗影匕首"
  attack-source: THRUST
  weapon-type: "匕首"
  attributes:
    base-damage: 5.0
    attack-speed: 2.2
    crit-chance: 0.35
    crit-multiplier: 2.5
    attack-range: 2.0
    armor-penetration: 12.0
  growth:
    enabled: true
    max-level: 35
    exp-formula: "70 * level ^ 1.3"
    per-level:
      base-damage: 0.2
      crit-chance: 0.005
      armor-penetration: 0.3

吸血魔剑​

blood_blade:
  name: "&4&l血饮魔剑"
  attack-source: DEVOUR
  weapon-type: "魔剑"
  attributes:
    base-damage: 10.0
    attack-speed: 1.0
    crit-chance: 0.12
    crit-multiplier: 1.8
    attack-range: 3.0
    lifesteal: 0.2
  growth:
    enabled: true
    max-level: 40
    exp-formula: "100 * level ^ 1.5"
    per-level:
      base-damage: 0.4
      lifesteal: 0.005
  lore:
    - "&7嗜血的魔剑"
    - "&7每次攻击汲取敌人生命"

多元素法书​

forbidden_tome:
  name: "&5&l禁忌魔导书"
  attack-source: TOME
  weapon-type: "魔导书"
  attributes:
    base-damage: 6.0
    attack-speed: 0.8
    attack-range: 10.0
    armor-penetration: 5.0
  elemental-damage:
    void: 4.0
    fire: 2.0
  growth:
    enabled: true
    max-level: 40
    exp-formula: "110 * level ^ 1.5"
    per-level:
      base-damage: 0.35
      armor-penetration: 0.15