EmakiForge

EmakiForge 负责锻造流程：玩家放入目标装备、图纸和材料后，模块检查配方、容量和条件，再改造目标装备或生成新装备。品质、材料贡献和结果展示都在这里配置。

基本信息

项目	值
模块版本	4.1.0
主命令	/emakiforge
别名	/eforge、/ef
硬依赖	EmakiCoreLib
软依赖	EmakiAttribute、PlaceholderAPI
主要权限	emakiforge.use、emakiforge.book、emakiforge.reload、emakiforge.admin

核心概念

概念	说明
图纸	控制玩家是否能执行某个锻造配方。
材料	玩家投入的资源，可以影响成功、品质或最终属性。
配方	定义输入要求、容量、条件、结果和动作。
容量	限制可投入材料数量或权重。
品质	锻造结果的随机或保底等级。
目标输入模式	不直接生成新物品，而是在玩家放入的目标装备上重建锻造层。
配方书	玩家查看可用配方的 GUI。
编辑器	管理员在运行时编辑部分资源的工具。

默认配置目录

plugins/EmakiForge/
├── config.yml
├── recipes/
├── gui/
│   ├── forge_gui.yml
│   ├── recipe_book.yml
│   └── editor_gui.yml
├── lang/
├── blueprints/
├── materials/
├── data/
└── backups/

先改 recipes/。它决定锻造玩法的输入、容量、条件、结果和动作。blueprints/、materials/、data/、backups/ 可能由运行时编辑器或服务维护。

功能页面

页面	内容
命令与权限	锻造、配方书、重载、列表和调试命令。
配方系统	输入、图纸、结果、动作和配方匹配。
材料系统	材料贡献、容量、品质修正和效果写入。
品质系统	品质池、保底、物品元数据和确定性算法。
锻造历史记录	历史记录、自动保存和异常排查。
GUI	锻造界面、配方书和编辑器。
审计	配置检查、输入输出和运行风险。
占位符	PlaceholderAPI 输出。

典型锻造流程

1. 玩家打开锻造 GUI。
2. 放入目标装备、图纸和材料。
3. 模块检查配方、权限、条件、容量和材料数量。
4. 执行 action.pre。
5. 计算品质、保底、材料贡献和结果。
6. 如果 result.output_item 为空，则对目标装备写入 forge layer。
7. 如果配置了输出物品，则生成指定结果。
8. 执行成功或失败动作。
9. CoreLib 重建物品展示。
10. Attribute 可选读取或接收锻造属性。

与 Attribute 的关系

Forge 可以不安装 Attribute 运行基础锻造功能。但如果你希望锻造结果提供属性，则建议安装 Attribute，并让 Forge 写入属性 payload。这样属性会参与真实计算，而不是只显示在 Lore 中。