轩辕工坊（XuanyuanDecomposition）

此插件为搬运，作者已授权
# 轩辕工坊 (XuanyuanDecomposition)
## 插件概述
轩辕工坊是一款功能完整、性能优异的Minecraft物品分解与自定义合成插件，专为Paper 1.18+服务器设计。插件提供了直观的GUI界面和强大的配方系统，让玩家可以将物品分解为原材料，同时支持创建8种不同类型的自定义合成配方。
插件采用模块化架构设计，包含完整的缓存系统、异步处理机制和性能监控功能，确保在高负载环境下依然流畅运行。支持多种主流自定义物品插件（NeigeItems、MMOItems、ItemsAdder、Oraxen），并提供中英文双语言支持。
## 插件描述
### 核心功能
**物品分解系统**
- 支持原版和自定义物品的分解
- 多产物分解，每个产物独立掉落率控制
- 保底机制，确保玩家不会空手而归
- 三种分解模式：基础、多产物、高级
- 可视化分解GUI，实时预览可能的产物
**自定义合成系统**
- 8种合成类型：有序合成、无序合成、熔炉、高炉、烟熏炉、营火、锻造台、切石机
- 可视化配方编辑器，无需手动编辑YAML
- 支持自定义烹饪时间和经验值
- 烹饪进度条实时显示（熔炉/高炉/烟熏炉/营火）
- 配方模板系统，快速创建常用配方
**配方管理**
- GUI可视化配方浏览和编辑
- 配方标签系统，分类管理配方
- 配方导入/导出功能（JSON格式）
- 配方搜索和过滤
- 配置自动迁移和备份
**经济与等级系统**
- Vault经济集成，支持金币消耗和奖励
- 分解等级系统，等级越高成功率越高
- 完整的统计系统，记录分解次数和成功率
- 冷却时间控制，防止刷物品
**性能优化**
- 智能缓存系统，减少配置文件读取
- 异步数据处理，不影响主线程
- 实时性能监控，查看缓存命中率和处理时间
- 内存优化，自动清理过期数据
**多语言支持**
- 中文/英文语言包
- 支持自定义语言文件
- 一键切换语言
**自定义物品兼容**
- NeigeItems - 支持稀有度读取
- MMOItems - 支持属性读取和绑定检测
- ItemsAdder - 完整支持
- Oraxen - 完整支持
### 技术特点
- **架构设计**: 清晰的分层架构，管理器层、GUI层、监听器层分离
- **代码质量**: 完整的注释、规范的命名、严格的错误处理
- **性能表现**: 缓存优化、异步处理、资源自动释放
- **用户体验**: 直观的GUI、详细的提示、实时反馈
- **可扩展性**: 模块化设计，易于添加新功能
- **稳定性**: 完善的异常处理，不会因配置错误导致崩溃
### 适用场景
- **生存服务器**: 为玩家提供物品回收途径，增加游戏深度
- **RPG服务器**: 配合自定义物品系统，创建独特的装备分解玩法
- **经济服务器**: 通过分解系统调节服务器经济平衡
- **小游戏服务器**: 作为奖励系统的一部分，增加玩法多样性
- **创意服务器**: 自定义合成配方，实现独特的游戏机制
### 命令系统
**基础命令**
| 命令 | 功能 | 权限 | 示例 |
|------|------|------|------|
| `/xd` | 分解手持物品 | `xuanyuan.decompose.use` | 手持物品后执行 |
| `/xd gui` | 打开分解GUI | `xuanyuan.decompose.use` | 最常用的方式 |
| `/xd recipes` | 查看配方列表 | `xuanyuan.decompose.use` | 浏览所有可分解物品 |
| `/xd check` | 检查手持物品配方 | `xuanyuan.decompose.use` | 查看物品是否可分解 |
| `/xd level` | 查看分解等级 | `xuanyuan.decompose.use` | 显示等级和经验 |
| `/xd stats` | 查看分解统计 | `xuanyuan.decompose.use` | 显示统计数据 |
| `/xd help` | 查看帮助 | `xuanyuan.decompose.use` | 显示所有命令 |
| `/xd performance` | 查看性能报告 | `xuanyuan.decompose.admin` | 显示缓存命中率等 |
| `/xd perf reset` | 重置统计数据 | `xuanyuan.decompose.admin` | 清空性能统计 |
| `/xd export decompose` | 导出分解配方 | `xuanyuan.decompose.admin` | 导出为JSON |
| `/xd export craft` | 导出合成配方 | `xuanyuan.decompose.admin` | 导出为JSON |
| `/xd export list` | 列出导出文件 | `xuanyuan.decompose.admin` | 查看所有导出 |
| `/xd import <文件名>` | 导入配方 | `xuanyuan.decompose.admin` | 从JSON导入 |
| `/xd template list` | 列出所有模板 | `xuanyuan.decompose.admin` | 查看配方模板 |
| `/xd template info <名称>` | 查看模板详情 | `xuanyuan.decompose.admin` | 显示模板信息 |
| `/xd language zh_CN` | 切换到中文 | `xuanyuan.decompose.admin` | 切换语言 |
| `/xd lang en_US` | 切换到英文 | `xuanyuan.decompose.admin` | 切换语言 |
**管理员命令**
| 命令 | 功能 | 权限 | 示例 |
|------|------|------|------|
| `/xd editor` | 打开配方编辑器 | `xuanyuan.decompose.admin` | 创建/编辑配方 |
| `/xd create` | 创建新配方 | `xuanyuan.decompose.admin` | 同editor命令 |
| `/xd reload` | 重载配置 | `xuanyuan.decompose.admin` | 重载所有配置文件 |
**命令使用示例**
# 玩家使用
/xd gui # 打开分解界面
/xd recipes # 浏览所有配方
/xd level # 查看我的等级
/xd stats # 查看我的统计
# 管理员使用
/xd editor # 创建/编辑配方
/xd reload # 重载配置
/xd performance # 查看性能
/xd export decompose # 导出配方备份
/xd language zh_CN # 切换到中文
```
### 权限节点
**基础权限**
- `xuanyuan.decompose.use` - 使用分解功能
- `xuanyuan.decompose.basic` - 使用基础配方
- `xuanyuan.decompose.multi_result` - 使用多产物配方
- `xuanyuan.decompose.advanced` - 使用高级配方
**管理员权限**
- `xuanyuan.decompose.admin` - 管理员权限（包含所有功能）
- `xuanyuan.decompose.editor` - 使用配方编辑器
- `xuanyuan.decompose.reload` - 重载配置
**配方类型权限**
- `xuanyuan.decompose.smithing` - 锻造台配方
- `xuanyuan.decompose.stonecutting` - 切石机配方
- `xuanyuan.decompose.furnace` - 熔炉配方
- `xuanyuan.decompose.blasting` - 高炉配方
- `xuanyuan.decompose.smoking` - 烟熏炉配方
- `xuanyuan.decompose.campfire` - 营火配方
**自定义配方权限**
- 可在配方中设置 `permission` 字段
- 例如：`xuanyuan.decompose.netherite` - 下界合金物品分解权限
**通配符权限**
- `xuanyuan.decompose.*` - 所有权限
**轩辕工坊** - 让物品分解和自定义合成变得简单而强大！
QQ群：1064383393