UltiRecipe

Minecraft 服务器自定义配方插件 - 通过 YAML 配置轻松创建自定义合成配方，无需编写代码。

✨ 功能特性

🔧 核心功能

• YAML 配置 - 使用简单的 YAML 格式定义配方，无需编写 Java 代码
• 有序配方 - 支持 3x3 工作台有序合成配方 (ShapedRecipe)
• 自定义物品 - 支持自定义产出物品的名称、描述和数量
• 颜色代码 - 支持 & 颜色代码，让物品名称和描述更加个性化

🚀 易用性

• 热重载 - 使用 /recipe reload 无需重启服务器即可重载配方
• 配方列表 - 使用 /recipe list 查看所有已注册的配方
• 即插即用 - 放入插件文件夹，自动生成配置文件（enabled: true、recipes: {}）。首次启动不会生成示例配方： 下文的 golden_egg、custom_sword 等都是配方写法示例，需要自行写入 recipes.yml （「随插件附带一份示例配方」由 #23 跟踪）

🔒 兼容性

• UltiTools 生态 - 完美集成 UltiTools-API 6.3.0+ 框架
• 原版材料 - 支持所有 Minecraft 原版材料作为配方材料

📦 安装

1. 确保已安装 UltiTools-API 6.3.0 或更高版本。本模块声明 api-version: 630， 更早的框架会拒绝加载它
2. 下载最新版本的 UltiRecipe
3. 将 JAR 文件放入 plugins/UltiTools/plugins/ 目录
4. 重启服务器（/ul reload 只重载配置，不会加载新的模块 JAR）
5. 编辑 plugins/UltiTools/pluginConfig/UltiRecipe/config/recipes.yml 添加自定义配方

🎮 命令

命令	权限	描述
/recipe list	ultirecipe.admin	列出所有已注册的配方
/recipe reload	ultirecipe.admin	重载配方配置
/recipe count	ultirecipe.admin	显示已注册的配方数量

/recipe deliberately takes over the vanilla /recipe command of the same name (the maintainer's decision); the vanilla command that grants and takes recipes stays reachable as minecraft:recipe. /ultirecipe is the same command as /recipe.

/recipe 有意接管同名的原版 /recipe 命令（维护者的决定）；用于授予和收回配方的原版命令仍可通过 minecraft:recipe 调用。 /ultirecipe 与 /recipe 是同一个命令。

⚙️ 配置

配置文件结构

配置文件位于 plugins/UltiTools/pluginConfig/UltiRecipe/config/recipes.yml：

enabled: true  # 是否启用自定义配方

recipes:
  # 配方名称（唯一标识符）
  golden_egg:
    # 产出物品配置
    output:
      material: EGG           # 物品材料
      amount: 1               # 产出数量
      name: "&e&l金苹果蛋"     # 自定义名称（支持颜色代码）
      lore:                   # 自定义描述
        - "&7由苹果和木头合成的神奇蛋"
    
    # 配方形状（3行，每行3个字符）
    shape:
      - "xxx"
      - "xyx"
      - "y y"
    
    # 材料映射（字符 -> 材料名称）
    ingredients:
      x: APPLE
      y: DARK_OAK_WOOD

配方形状说明

• 形状由 3 行字符串组成，每行 3 个字符
• 空格 表示该位置不需要放置物品
• 其他字符在 ingredients 中定义对应的材料；形状里用到、却没有在 ingredients 中定义的字母会让该配方不注册，控制台警告会点名配方和这个字母（Every other character must be defined under ingredients; a shape letter with no entry there keeps the recipe unregistered, and a console warning names the recipe and the letter.）

示例配方

钻石剑配方：

recipes:
  custom_sword:
    output:
      material: DIAMOND_SWORD
      amount: 1
      name: "&b&l神圣之剑"
      lore:
        - "&7传说中的神器"
        - "&7攻击力 +100"
    shape:
      - " D "
      - " D "
      - " S "
    ingredients:
      D: DIAMOND
      S: STICK

压缩铁块配方：

recipes:
  compressed_iron:
    output:
      material: IRON_BLOCK
      amount: 9
    shape:
      - "III"
      - "III"
      - "III"
    ingredients:
      I: IRON_INGOT

🛠️ 开发者信息

UltiRecipe 使用 UltiTools-API 框架开发，充分利用了以下特性：

• @UltiToolsModule - 模块自动扫描和注册
• @Service - IoC 容器管理的服务类
• @ConfigEntity - 配置文件自动加载和保存
• @CmdExecutor - 命令自动注册
• @Autowired - 依赖自动注入

项目结构

UltiRecipe/
├── pom.xml
├── README.md
└── src/main/
    ├── java/com/ultikits/plugins/recipe/
    │   ├── UltiRecipe.java         # 主类
    │   ├── config/
    │   │   └── RecipeConfig.java   # 配置实体
    │   ├── service/
    │   │   └── RecipeService.java  # 配方服务
    │   └── commands/
    │       └── RecipeCommand.java  # 命令
    └── resources/
        ├── plugin.yml
        └── lang/
            ├── zh.json             # 中文语言文件
            └── en.json             # 英文语言文件

📄 许可证

本项目是 UltiKits 生态系统的一部分，遵循 MIT 许可证。

🤝 贡献

欢迎提交 Issue 和 Pull Request！

• 报告问题：GitHub Issues
• 参与开发：Fork 仓库并提交 PR

📞 支持

• 文档：UltiKits Wiki
• QQ 群：246078389
• Discord：UltiKits Server