快速开始
环境要求
| 项目 | 要求 |
|---|---|
| Java | 25 或更高（推荐 GraalVM） |
| 服务端 | Spigot 1.21+（或兼容分支如 Paper） |
| 运行库 | Adventure、exp4j、BoostedYaml（由 CoreLib 通过 plugin.yml libraries 自动加载） |
提示
首次部署 EmakiCoreLib 3.4.0 时，确认服务端允许通过 plugin.yml libraries 下载运行库。部分服务端或网络环境可能会阻止自动下载——如果遇到这种情况，需要提前把对应的运行库 jar 放到服务端的 libraries/ 缓存目录里。
推荐启用顺序
模块之间有依赖关系，一次性全部丢进去虽然也能跑，但出了问题很难定位。建议按下面的顺序逐步启用，每一步确认没问题再往下走：
第一步：基础设施与属性层
- EmakiCoreLib — 所有模块的强依赖，必须最先装
- EmakiAttribute — 属性与战斗系统，后续的锻造、强化、宝石都会往物品上写属性，Attribute 负责读取和计算这些数值
验证要点：CoreLib 正常加载（控制台无报错），Attribute 的属性定义能被识别、战斗伤害计算正常。
第二步：装备成长闭环
- EmakiForge — 锻造系统
- EmakiStrengthen — 强化系统
这两个模块构成装备的"制造 → 强化"闭环。验证要点：锻造配方能正常执行并产出物品，强化流程和星级成长正常运作。
第三步：世界交互与镶嵌成长线
- EmakiGem — 宝石系统
- EmakiCooking — 烹饪系统
验证要点：宝石的镶嵌、提取、升级流程跑通，烹饪工位在世界中可正常交互。
第四步：主动技能线
- EmakiSkills + MythicMobs 内容包
注意
EmakiSkills 只负责技能的管理（解锁、槽位、触发、施法模式），技能的实际效果由 MythicMobs 配置定义。没装 MythicMobs 的话 Skills 本身能启动，但玩家释放技能时不会有任何效果。
模块依赖矩阵
| 模块 | 强依赖 | 软依赖 |
|---|---|---|
| EmakiCoreLib | — | Vault, ExcellentEconomy, PlaceholderAPI, MMOItems, ItemsAdder, Nexo, NeigeItems, CraftEngine |
| EmakiAttribute | EmakiCoreLib | MythicMobs, PlaceholderAPI, MMOItems |
| EmakiForge | EmakiCoreLib | EmakiAttribute, PlaceholderAPI |
| EmakiStrengthen | EmakiCoreLib | EmakiAttribute, PlaceholderAPI |
| EmakiCooking | EmakiCoreLib | CraftEngine, ItemsAdder, Nexo |
| EmakiGem | EmakiCoreLib | EmakiAttribute, PlaceholderAPI |
| EmakiSkills | EmakiCoreLib | MythicMobs, EmakiAttribute, PlaceholderAPI |
强依赖意味着没装就无法启动；软依赖是"有就用，没有也能跑"——比如不装 EmakiAttribute，Forge 照样能锻造物品，只是产物不会携带属性数据。
命令速查
| 模块 | 根命令 | 别名 |
|---|---|---|
| EmakiAttribute | /emakiattribute | /eattribute, /ea |
| EmakiForge | /emakiforge | /eforge, /ef |
| EmakiStrengthen | /emakistrengthen | /estrengthen |
| EmakiCooking | /ecooking | /ec |
| EmakiGem | /emakigem | /egem, /eg |
| EmakiSkills | /emakiskills | /eskills |
提示
所有模块的根命令都支持 reload 子命令来热重载配置。重载时会刷新在线玩家的物品数据和 GUI 会话，不需要重启服务端。
默认资源定位
各模块首次启动时会自动把默认配置和资源文件释放到 plugins/<模块名>/ 目录下。如果你需要自定义，直接在这些文件上改就行——重载时会读取你修改后的版本，不会覆盖。
| 模块 | 主要资源目录 |
|---|---|
| EmakiCoreLib | config.yml, lang/ |
| EmakiAttribute | attributes/, conditions/, damage_types/, lore_formats/, profiles/, config.yml |
| EmakiForge | recipes/, gui/, lang/, config.yml |
| EmakiStrengthen | recipes/, gui/, lang/, config.yml |
| EmakiCooking | recipes/, gui/, lang/, item_adjustments/, config.yml |
| EmakiGem | gems/, items/, gui/, conditions/, lang/, config.yml |
| EmakiSkills | skills/, resources/, gui/, lang/, config.yml |
升级注意事项
- 升级前务必备份自定义配置、语言文件和默认资源副本
- 所有自定义的原版物品/方块来源需要迁移到
minecraft-xxx、mc-xxx、v-xxx或裸 ID 写法（旧的minecraft:xxx格式不再被识别） - 自定义展示需要迁移到
structured_presentation（旧的presentation、name_operations、lore_operations等已不再是受支持的主路径） - 详细的版本变更和迁移指南见 更新日志