EMC 自定义武器

EMC 自定义武器（EMCWeaponLib）是 EMC RPG 生态的战斗核心插件，提供 18 种攻击源、70+ 武器子类型、6 级稀有度、武器成长、锻造强化、重铸、宝石镶嵌和 5 种元素伤害，为服务器打造完整的 RPG 武器养成体系。

核心特性

• 18 种攻击源 — 近战（斩击/刺击/劈砍/钝击/长柄/鞭索）、远程（弓射/弩射/投掷/暗器）、魔法（法术/法书/召唤/音波）、特殊（爆破/盾击/吞噬/元素）
• 70+ 武器子类型 — 刀、剑、斧、锤、枪、戟、弓、弩、法杖、魔导书等，每种攻击源下有多种具体武器形态
• 6 级稀有度 — 普通/优秀/精良/史诗/传说/神话，影响属性浮动、成长浮动和宝石槽位数
• 武器成长 — 击杀/命中获得经验，升级后 8 项属性自动成长
• 锻造强化 — ★１～★10 星级系统，成功率递减，失败可降星，最高 +55% 属性加成
• 重铸系统 — 重新随机武器的属性浮动系数，追求完美词条
• 宝石镶嵌 — 5 种宝石类型 × 5 级品质，插槽数由稀有度决定
• 元素伤害 — 火焰、冰霜、雷电、剧毒、虚空 5 种元素附加伤害
• 暴击系统 — 可配置暴击率、暴击倍率、暴击消息和粒子特效
• 物品库联动 — 通过反射对接 EMC 高级物品库，武器外观来自任意物品源
• JSON 数据存储 — 稀有度、浮动系数、星级、宝石等全部序列化到物品 NBT/PDC
• 开放 API — EMCWeaponAPI 供其他生态插件查询武器信息、注册攻击处理器

环境要求

项目	要求
服务端	Paper/Spigot 1.8+
Java	Java 8+
必需依赖	无
推荐依赖	EMC 高级物品库（提供武器外观物品）

安装步骤

1. 从下载页面获取 EMC自定义武器.jar
2. 将 jar 文件放入服务器的 plugins/ 目录
3. （推荐）同时安装 EMC 高级物品库插件
4. 启动服务器，插件自动生成：
   • config.yml — 全局配置（成长、暴击、攻击特效、锻造、重铸）
   • weapons/example.yml — 示例武器配置（18 种攻击源各一把示例武器）
   • gems/ — 宝石配置目录
5. 在 weapons/ 和 gems/ 文件夹中创建自定义配置
6. 执行 /emcweapon reload 重载

架构概览

EMCWeaponLib
├── 武器管理器 (WeaponManager)       — YAML 武器定义加载与缓存
├── 攻击管理器 (AttackManager)       — 18 种攻击源处理器注册
├── 成长管理器 (GrowthManager)       — 经验计算与升级逻辑
├── 锻造管理器 (ForgeManager)       — ★1~★10 星级强化，成功率/失败惩罚/材料
├── 重铸管理器 (ReforgeManager)     — 属性浮动重随机
├── 宝石管理器 (GemManager)         — 宝石加载、镶嵌、拆卸
├── 攻击监听器 (WeaponAttackListener)  — 拦截伤害事件，应用武器属性
├── 成长监听器 (WeaponGrowthListener)  — 击杀/命中经验发放
├── 交互监听器 (WeaponInteractListener) — 右键交互特殊效果
├── NBT 工具 (NBTUtil)               — 跨版本 NBT/PDC 读写
├── 公开 API (EMCWeaponAPI)          — 供生态插件调用
└── 命令系统 (EMCWeaponCommand)      — give/list/info/sources/reload

与物品库的关系

EMC 自定义武器的外观物品来源于 EMC 高级物品库。武器配置中的 item 字段引用物品库的物品 ID：

dragon_slayer:
  name: "&c&l屠龙刀"
  item: "config:example_sword"    # ← 引用物品库中的物品
  attack-source: SLASH

如果未安装物品库或引用的物品不存在，武器将使用默认钻石剑作为外观。