NewForge 锻造系统插件
插件简介
NewForge 是一个功能强大且高度可配置的 Minecraft 锻造系统插件，基于 Paper 1.20.1 API 开发。它为玩家提供了一个全新的物品制作体验，通过图纸、材料和锻造队列系统，让物品制作变得更加有趣和富有挑战性。

✨ 核心特色

• ️ 图纸许可系统: 通过图纸许可解锁物品配方，支持持久化存储
• 锻造锤系统: 提升锻造效率和成功率
• ⏱️ 队列系统: 支持多个锻造任务同时进行
• 进度显示: 实时查看锻造进度和剩余时间
• 成功率机制: 锻造有成功失败概率，增加游戏挑战性
• 动态配方管理: 支持管理员通过命令或GUI创建和管理配方
• 完整GUI界面: 直观易用的图形化操作界面
• 权限控制: 精细的图纸许可管理，支持授予和撤销

快速开始
安装步骤

1. 下载插件: 将 NewForge.jar 放入服务器的 plugins 文件夹
2. 启动服务器: 重启或重载服务器以生成配置文件
3. 配置权限: 根据需要为玩家分配相应权限
4. 自定义配置: 编辑配置文件以适应您的服务器需求

基本命令
/newforge - 打开锻造界面或显示帮助信息
/newforge open - 打开配方选择界面
/newforge forge <配方ID> - 直接打开指定配方的锻造界面
/newforge mailbox - 打开邮箱界面
/newforge mail - 打开邮箱界面 (简写)
/newforge help - 查看帮助信息
/newforge reload - 重载配置文件 (管理员)
/newforge stats [玩家] - 查看锻造统计信息

玩家使用指南
基础使用流程

1. 获取图纸许可: 由管理员授予特定配方的使用许可
2. 选择配方: 使用 /newforge open 命令打开配方选择界面
3. 进入锻造: 从许可配方列表中选择要锻造的物品
4. 锁定图纸: 选择配方后图纸将自动锁定在槽位中
5. 添加材料: 点击材料槽位从背包中选择所需材料
6. 开始锻造: 点击开始按钮启动锻造过程
7. 等待完成: 在队列中查看锻造进度
8. 获取成品: 锻造完成后自动发送至邮箱，使用 /newforge mailbox 查看和领取

界面说明
配方选择界面

• 配方列表: 显示所有已授权的配方图纸
• 配方信息: 显示锻造时间、成功率、所需材料等详细信息
• 搜索功能: 支持按关键词搜索配方
• 分类过滤: 可按配方分类筛选显示
• 分页浏览: 支持翻页查看更多配方

主锻造界面

• 图纸槽位: 自动锁定的锻造图纸位置（锁定状态不可更换）
• 材料槽位: 放置所需材料的5个槽位
• 锻造锤槽位: 可选的锻造锤位置，提升效率
• 信息显示: 显示当前配方的详细信息
• 开始按钮: 启动锻造过程
• 输出槽位: 获取完成的锻造物品
• 队列显示: 查看当前锻造任务进度

操作方式

• 选择配方: 在配方列表中点击选择要锻造的配方
• 放置物品: 点击槽位后从背包选择物品
• 取出物品: 再次点击已有物品的槽位取出（图纸除外）
• 查看进度: 队列区域显示所有进行中的任务
• 翻页浏览: 当队列任务较多时可以翻页查看

锻造机制详解
成功率系统

• 基础成功率: 每个配方都有基础成功率
• 锻造锤加成: 使用锻造锤可以提升成功率
• 等级加成: 锻造等级越高，成功率越高
• 失败处理: 失败时有概率返还部分材料

时间系统

• 基础时间: 每个配方都有固定的锻造时间
• 锻造锤缩减: 锻造锤可以缩短锻造时间
• 等级加成: 等级提升可以减少锻造时间
• 队列管理: 支持多个任务同时进行

经验系统

• 获得经验: 锻造成功或失败都会获得经验
• 等级提升: 经验积累到一定程度会提升等级
• 首次奖励: 首次完成某个配方有额外经验奖励
• 等级效果: 等级提升会增加成功率和减少时间

管理员指南
配方管理
GUI方式创建配方
/newforge recipe edit
打开可视化配方编辑界面，通过拖拽方式创建配方。

命令方式创建配方
# 1. 创建新配方 (手持图纸)
/newforge recipe create <配方ID>

# 2. 设置材料 (手持材料)
/newforge recipe setmaterial <槽位编号>
# 槽位编号为1-9，对应3x3的工作台布局

# 3. 设置输出 (手持成品)
/newforge recipe setoutput
# 可以多次使用此命令添加多个输出物品

# 4. 保存配方
/newforge recipe save
配方管理命令
/newforge recipe list - 列出所有配方
/newforge recipe info <配方ID> - 查看配方详情
/newforge recipe delete <配方ID> - 删除配方
/newforge recipe reload - 重载配方
/newforge recipe search <关键词> - 搜索配方
/newforge recipe categories - 查看配方分类
/newforge recipe stats [配方ID] - 查看配方使用统计
图纸许可管理
/newforge recipe give <玩家> <配方ID> - 授予玩家配方使用许可
/newforge recipe revoke <玩家> <配方ID> - 撤销玩家配方使用许可
配方分类和权限
/newforge recipe setcategory <配方ID> <分类> - 设置配方分类
/newforge recipe addtag <配方ID> <标签> - 添加配方标签
/newforge recipe removetag <配方ID> <标签> - 移除配方标签
/newforge recipe setpermission <配方ID> <权限> - 设置配方权限
配方导入导出
/newforge recipe export <配方ID> - 导出配方为JSON
/newforge recipe import <文件路径> - 从JSON导入配方
系统管理
玩家数据管理
/newforge player info <玩家> - 查看玩家信息
/newforge player setlevel <玩家> <等级> - 设置玩家等级
/newforge player addexp <玩家> <经验> - 给予玩家经验
/newforge player reset <玩家> - 重置玩家数据
系统统计
/newforge stats global - 查看全局统计
/newforge stats top [类型] - 查看排行榜
/newforge stats recipe <配方ID> - 查看配方统计
⚙️ 配置说明
基础设置

• 成功率: 调整锻造的基础成功率
• 失败返还: 配置失败时材料返还比例
• 队列容量: 设置玩家可同时进行的锻造数量
• 权限分级: 通过权限解锁更多队列槽位

锻造锤设置

• 物品类型: 定义哪些物品可作为锻造锤
• 耐久消耗: 每次锻造消耗的耐久度
• 效果加成: 时间缩减和成功率提升

GUI界面设置

• 槽位布局: 自定义各功能槽位的位置
• 显示物品: 配置界面中各种提示物品的外观
• 翻页功能: 队列显示的分页设置

音效和粒子

• 音效系统: 为各种操作配置音效反馈
• 粒子效果: 锻造过程中的视觉效果
• 开关控制: 可独立开启或关闭音效和粒子

经验系统

• 经验奖励: 成功和失败时的经验获得
• 等级设置: 升级所需经验和最大等级
• 等级效果: 等级对锻造的加成效果

权限系统
基础权限

• newforge.use - 使用锻造系统 (默认: true)
• newforge.admin - 管理员权限 (默认: op)
• newforge.reload - 重载配置权限 (默认: op)

队列权限

• newforge.queue.extra - 解锁额外队列槽位
• newforge.queue.vip - VIP队列权限 (更多槽位和并发数)

配方权限

• newforge.recipe.* - 所有配方管理权限（包含以下所有权限）
• newforge.recipe.create - 创建配方权限
• newforge.recipe.delete - 删除配方权限
• newforge.recipe.edit - 编辑配方权限
• newforge.recipe.give - 授予图纸许可权限
• newforge.recipe.revoke - 撤销图纸许可权限
• newforge.recipe.list - 查看配方列表权限
• newforge.recipe.info - 查看配方详情权限
• newforge.recipe.search - 搜索配方权限
• newforge.recipe.filter - 过滤配方权限
• newforge.recipe.categories - 查看配方分类权限
• newforge.recipe.stats - 查看配方统计权限
• newforge.recipe.export - 导出配方权限
• newforge.recipe.import - 导入配方权限
• newforge.recipe.reload - 重载配方权限
• newforge.recipe.setpermission - 设置配方权限权限
• newforge.recipe.setcategory - 设置配方分类权限
• newforge.recipe.addtag - 添加配方标签权限
• newforge.recipe.removetag - 移除配方标签权限

图纸许可系统

• 玩家只能使用已获得许可的配方
• 图纸许可数据持久化存储在数据库中
• 管理员可以动态授予或撤销玩家的配方使用权限
• 每个配方可以设置独立的权限节点作为额外验证

统计系统
个人统计

• 锻造成功/失败次数
• 使用材料总量
• 产出物品总量
• 当前等级和经验
• 已获得的图纸许可数量
• 配方使用频率统计

全局统计

• 服务器总锻造次数
• 最受欢迎的配方
• 玩家等级排行榜
• 配方使用频率统计

使用技巧
玩家技巧

1. 合理使用锻造锤: 重要物品建议使用锻造锤提升成功率
2. 材料管理: 准备充足的材料，因为失败可能消耗材料
3. 队列规划: 合理安排锻造队列，优先制作重要物品
4. 等级提升: 通过大量锻造提升等级获得永久加成

管理员技巧

1. 配方平衡: 合理设置配方的时间和成功率保持游戏平衡
2. 权限分级: 通过权限系统为不同等级玩家提供差异化体验
3. 定期统计: 查看配方使用统计，及时调整游戏平衡性
4. 备份数据: 定期备份配方和玩家数据

常见问题
Q: 为什么我的锻造总是失败？
A: 检查配方的成功率设置，使用锻造锤或提升等级可以增加成功率。

Q: 队列已满怎么办？
A: 等待当前任务完成，或联系管理员申请队列扩容权限。

Q: 如何获得图纸许可？
A: 图纸许可由服务器管理员通过命令授予，使用 /newforge recipe give <玩家> <配方ID> 命令。

Q: 锻造锤损坏了还能用吗？
A: 锻造锤耐久为0时无法继续使用，需要修复或更换。

Q: 配方权限如何设置？
A: 使用 /newforge recipe setpermission <配方ID> <权限节点> 命令设置。

Q: 为什么我看不到某个配方？
A: 你可能没有该配方的使用许可，请联系管理员授予许可。

Q: 图纸为什么无法取出？
A: 当通过配方选择界面进入锻造时，图纸会自动锁定无法取出，这是为了确保配方的正确性。

更新日志
v1.2.0 (Latest)

• ✅ 安全邮箱系统：实现原子性物品流转，完全解决物品丢失和复制问题
• ✅ 事务性GUI架构：引入TransactionalClickHandler，确保所有GUI操作的安全性
• ✅ 防复制机制：严格的物品验证和超时回滚机制，防止一切形式的物品复制
• ✅ 邮件通知系统：玩家上线自动提醒新邮件，完整的音效和消息反馈
• ✅ 锻造流程重构：完成品自动发送到邮箱，彻底解决背包满和离线问题
• ✅ 数据库优化：新增邮箱表结构，支持物品序列化和原子性操作
• ✅ 并发安全：玩家级别锁机制，确保多线程环境下的数据一致性

v1.1.0

• ✅ 图纸许可系统：替换实物图纸为许可制度
• ✅ 配方选择界面：只显示已授权的配方
• ✅ 图纸锁定功能：选择配方后自动锁定在锻造槽位
• ✅ 许可管理命令：支持授予和撤销配方使用权限
• ✅ 数据持久化：图纸许可信息存储在数据库中
• ✅ 权限验证：双重验证确保配方使用安全

v1.0.0

• ✅ 完整的锻造系统实现
• ✅ 图纸和材料管理
• ✅ 队列系统和进度显示
• ✅ 锻造锤系统
• ✅ 动态配方管理
• ✅ 权限和统计系统
• ✅ 音效和粒子效果
• ✅ 经验等级系统

注意事项

1. 服务器兼容性: 本插件专为 Paper 1.20.1+ 设计，其他服务端可能存在兼容性问题
2. 数据安全: 插件使用 SQLite 数据库存储数据，建议定期备份
3. 性能考虑: 大量并发锻造可能影响服务器性能，建议合理配置队列限制
4. 配方设计: 建议管理员仔细设计配方的平衡性，避免游戏体验过于简单或困难