CustomRecipes (1.8.x-1.21.x) - CustomRecipes

使用 CustomRecipes，你可以为任何物品创建自定义合成配方。无论是原版物品还是来自其他插件的自定义物品，你都可以通过直观的 GUI 或配置文件，自由设计数百种独特的配方，彻底释放你的想象力。

💡核心特性

全面的配方支持

• 支持有序合成与无序合成。
• 支持多种工作台类型：熔炉、高炉、烟熏炉、锻造台、切石机、砂轮、酿造台、营火等。
• 支持每世界独立配方，可在特定世界禁用配方。
• 支持禁用或覆盖原版合成配方。
• 支持为配方添加合成冷却时间。

强大的物品与条件系统

• 完整支持自定义物品插件：ItemsAdder、Oraxen、MythicMobs、ExecutableItems、Nexo、MMOItems。
• 支持完整的 NBT 数据，包括自定义名称、描述、自定义模型数据、药水效果、属性修饰符等。
• 可为配方设置合成条件，例如生物群系、时间、月相、天气、世界或玩家进度。
• 支持 PlaceholderAPI，可在物品描述中使用变量。
• 可为配方设置权限，并配置无权限时的提示信息。
• 支持定义残留物品，合成后所需材料不会被消耗。

便捷的管理与使用

• 提供直观的 游戏内 GUI (/cr gui) 来创建、编辑和管理配方。
• 所有配方存储在独立的 recipes 文件夹中，便于管理。
• 集成玩家配方手册 (GUI)，玩家可查看所有有权合成的配方及合成方法。
• 支持游戏内物品编辑器 (/edititem)，实时修改物品以测试配方。
• 完整的指令补全和重载指令 (/crecipe reload)。

🎮指令列表

主要指令：

• /crecipe 或 /cr - 显示帮助页面。
• /crecipe gui - 打开配方管理 GUI。
• /crecipe create <type> <id> [权限] - 创建一个新配方。
• /crecipe remove <id> - 移除一个配方。
• /crecipe show <id> - 显示一个配方的详情。
• /crecipe book 或 /recipes - 打开玩家配方手册。
• /crecipe reload - 重载插件配置与所有配方。
• /crecipe give <玩家> <配方名> - 给予玩家一个自定义配方物品。
• /crecipe debug - 启用/禁用调试模式。
• /crecipe list - 列出所有活跃的自定义配方。
• /crecipe items - 列出所有独立的自定义物品。
• /edititem - 游戏内物品编辑与管理帮助。

指令别名： crecipes, customrecipe, customrecipes, customr, cr

🔧权限节点

每个自定义配方都可以在配置中设置独立的权限。通用指令权限如下：

• crecipe.help - 使用 /crecipe
• crecipe.gui - 使用 /crecipe gui
• crecipe.create - 使用 /crecipe create
• crecipe.remove - 使用 /crecipe remove
• crecipe.show - 使用 /crecipe show
• crecipe.book - 使用 /crecipe book
• crecipe.reload - 使用 /crecipe reload
• crecipe.give - 使用 /crecipe give
• crecipe.debug - 使用 /crecipe debug

✨安装与快速开始

前置需求

• 必需： Spigot 或 Paper 服务端 (支持 1.8.x 至最新版本)。
• 可选但推荐：
• PlaceholderAPI
• 自定义物品插件 (如 ItemsAdder, Oraxen, MythicMobs 等)

创建第一个配方

• 将 CustomRecipes 插件放入服务器的 plugins 文件夹并重启服务器。
• 在插件生成的 plugins/CustomRecipes/recipes/ 文件夹内，创建一个新的 .yml 文件 (例如 MyRecipe.yml)。
• 参考下方示例或 Wiki 中的模板，在文件中编写你的配方。
• 在游戏中输入 /crecipe reload 或重启服务器以加载新配方。
• 在工作台中尝试合成你的新物品！

重要提示

• 如果你想使用普通的原版材料，只需在配方文件中移除该材料下的 Name 和自定义元数据部分。
• 详细配置说明请查阅官方 Wiki。

❓配置示例

示例：有序合成 (CursedPick.yml)

CursedPick:
  Enabled: true
  Shapeless: false
  Identifier: 'CURSED_PICKAXE'
  Permission: 'crecipe.recipe.cursedpick'
  Result:
    Item: 'DIAMOND_PICKAXE'
    Name: '&4&lCursed Pick'
    Lore:
      - '&c&lThe Cursed Pickaxe'
    Enchantments:
      - 'DURABILITY:255'
  ItemCrafting:
    - 'EEE'
    - 'XIX'
    - 'XIX'
  Ingredients:
    E:
      Material: EMERALD
      Amount: 1
      Name: 'Emerald Essence'
    I:
      Material: IRON_INGOT
      Amount: 1
      Name: 'Iron Essence'

示例：熔炉配方 (WheatSand.yml)

WheatSand:
  Enabled: true
  Item: SAND
  Amount: 1
  Identifier: WHEATSAND
  Converter: FURNACE
  Cooktime: 20
  Experience: 1
  ItemCrafting:
    - 'WXX'
    - 'XXX'
    - 'XXX'
  Ingredients:
    W:
      Material: WHEAT_SEEDS
      Amount: 1

示例：HavenBag 合成支持

插件与 Valorless 合作，支持为 HavenBags 创建自定义合成配方。你可以在配方中定义背包的纹理、大小和绑定属性。

⭐PlaceholderAPI 支持

安装 PlaceholderAPI 后，可在物品描述中使用以下变量（将 recipeName 替换为你的配方文件名，slot 替换为合成格 1-9）：

• %customrecipes_recipeName_ingredient_slot% - 返回指定格材料的类型。
• %customrecipes_recipeName_ingredient_name_slot% - 返回指定格材料的名称。
• %customrecipes_recipeName_ingredient_amount_slot% - 返回指定格材料的所需数量。
• %customrecipes_recipeName_ingredient_identifier_slot% - 返回指定格材料的标识符。

💡注意事项与支持

• 报告问题： 请通过 GitHub、私信 (PM) 或加入 Discord 服务器反馈 Bug。请勿在评论区发布 Bug 报告。
• 多语言： 插件部分支持英文与俄文。
• 兼容性： 支持从 1.8.x 到最新版本的所有 Paper 和 Spigot 服务端。
• 开发活跃： 插件持续更新并积极维护。

即将到来的功能： 等级插件支持、多语言支持、配方菜单分类、配方合成次数限制等。

---

友情链接服务器： FAIRHAVEN.NETHERRAIN.NET | VIBEMC.XYZ | ALPHABOXCORE.FALIXSRV.ME

赞助商： Kinetic Hosting - 使用优惠码 BOSS 可享受首月 15% 折扣。