// RecipesRedone - RecipesRedone

💡简介

RecipesRedone 是一款彻底改造 Minecraft 合成系统的插件。它突破了原版合成在材料、产出、功能上的诸多限制，允许服主通过简单的文本文件或开发者通过 API 来创建功能强大的自定义合成配方。你可以制作多产出、带权限、使用自定义材质，甚至能作为其他配方材料的物品，为服务器经济、装备升级等玩法带来无限可能。

🎮核心特性

ModernRecipe 格式

使用 ModernRecipe 格式创建的配方，将拥有原版系统无法实现的高级功能。

• 方向合成，而非固定位置：配方会自动适配所有可能的摆放方向（只要创建时尽可能靠左上角）。
• 自定义产出物品位置：可以精确控制合成产物在输出栏的哪个槽位出现。
• 多物品产出：一个配方可以同时产出多个不同的物品。
• 材料数量控制：可以要求每个材料槽位放入指定数量（不止1个）的物品。
• 权限集成：可以为每个配方设置独立的权限要求。
• 配方教程 GUI：配方会自动加入教程界面（可关闭），支持多页面分类浏览。
• 自定义材质物品：可以合成带有完全自定义模型/材质的物品。

图形界面 (GUI) 特性

• 更大的合成空间：输入和输出区域均升级为 3x6 的网格，支持更复杂的配方。
• 完全可自定义的界面：可以修改 GUI 标题、背景、按钮等所有界面元素。
• 可自定义的打开命令：默认命令 /recipesredone 可在配置中修改。
• 可要求工作台：可配置为玩家必须看向工作台才能打开合成界面。

服主与管理员特性

• 文本文件配方：无需编程，仅用记事本编辑 .txt 文件即可创建配方。
• 游戏内配方创建器：使用 /createrecipe 命令通过 GUI 直观地创建配方，并复制物品的所有信息。

API 开发者特性

• API 创建配方：其他插件可以通过 API 动态注册配方。
• RecipeRedoneCraftEvent：监听合成事件，以添加自定义条件或取消合成。
• 自定义菜单检测：使用 isCraftingGui 方法判断点击是否发生在自定义合成界面内。
• 自定义 GUI 菜单：通过 getCustomGui 方法创建并打开完全自定义的合成界面。

🔧命令与权限

所有命令均可在配置文件中修改，以下是默认设置。

可用命令

• /recipesredone - 打开自定义合成 GUI。
• /recipestutorial - 打开配方教程 GUI，查看所有自定义配方的合成方法。
• /createrecipe - 打开游戏内配方创建菜单。需要权限 recipesredone.admin。
• /reloadrecipes - 重新加载自定义配方配置文件。需要权限 recipesredone.admin。

✨配方创建教程

所有配方文件都放置在 plugins/RecipesRedone/recipes/ 文件夹中。插件自带4个示例配方，理解后可以删除。

基础结构

每个配方文件必须包含三个部分：permission、recipe 和 reward。

• permission：配方所需的权限。如果不需要权限，则设置为 ""。
• recipe：合成所需的材料及其位置。
• reward：合成产出的物品及其位置。

槽位编号

输入（recipe）和输出（reward）区域各有 18 个槽位，编号从 0 到 17。编号代表该物品必须放置的槽位。创建配方时，请将材料尽可能靠近左上角摆放，插件会自动处理所有可能的方向变换。

材料与产出格式

在 recipe 和 reward 中，每个槽位下的物品可以配置以下选项（仅 id 为必填项）：

• id: MATERIAL - 物品的材质ID，必须全大写（如 DIAMOND）。
• amount: 1 - 物品数量。
• name: '&c自定义名称' - 物品的显示名称，支持颜色代码。
• lore: - 物品描述文本列表，每行以 - '文本' 格式书写。
• enchantments: - 附魔列表，格式为 - 附魔名:等级。
• tags: - 特殊标签列表（详见下文）。
• flags: - 物品标志列表（用于隐藏属性等）。

分类与教程

• category: 分类名 - 将此配方归入教程 GUI 的特定分类中。
• tutorial: false - 设置此项可使该配方不在教程 GUI 中显示。

物品格式选项详解

id: DIRT - （必填）

可选参数

• amount: 1
• name: "Dirt"
• lore:
• "Lore Line 1"
• "Lore Line 2"
• enchantments: （完整附魔列表请查阅 Spigot 文档）
• "aquaaffinity:1"
• "sharpness:5"
• tags:
• "textureskull:SKINVALUE" - 自定义头颅材质值
• "playerskull:\PLAYERNAME" - 玩家头颅
• "vanilladurability:256" - 设置耐久度
• "unbreakable:true" - 物品无法破坏
• "custommodeldata:1234567" - 自定义模型数据
• "enchantglow:true" - 附魔光效（无需实际附魔）
• flags:
• "HIDE_ATTRIBUTES"
• "HIDE_UNBREAKABLE"
• attributes: （属性修饰符）
• "ATTRIBUTE:VALUE:OPERATION"
• "ATTRIBUTE:VALUE:OPERATION:SLOT"
• custompersistentdata:
• "namespace:key:value" - 自定义持久化数据

自定义头颅材质

• 在 minecraft-heads.com 等网站找到喜欢的头颅。
• 找到 Other -> Minecraft-URL 并复制其文本值。
• 在配方文件中使用标签：textureskull: 你复制的值。

⭐示例配方

简单示例

产出名为“Papa's Whipping Stick”的附魔木棍。

permission: simpleExample
recipe:
  '0':
    id: STICK
reward:
  '0':
    id: STICK
    amount: 1
    name: '&c&lPapa''s Whipping Stick'
    lore:
      - '&r&7Don''t f*ck with papa'
      - '&r&7or you get the whip.'
    enchantments:
      - damage:5
      - knockback:20
      - fireaspect:1

进阶示例

使用自定义配方产出的“魔法水晶”作为材料，合成一把“魔法铲”。

# 配方一：制作魔法水晶
category: Magic Tools
permission: complicatedExample1
recipe:
  '0':
    id: REDSTONE
    amount: 2
  '1':
    id: IRON_INGOT
  '2':
    id: REDSTONE
    amount: 2
  '3':
    id: IRON_INGOT
  '4':
    id: DIAMOND
  '5':
    id: IRON_INGOT
  '6':
    id: REDSTONE
    amount: 2
  '7':
    id: IRON_INGOT
  '8':
    id: REDSTONE
    amount: 2
reward:
  '0':
    id: DIAMOND
    amount: 1
    name: '&c&lMagical Crystal'
    lore:
      - '&r&7This crystal is rumored to forge magical tools...'
    tags:
      - fakeenchant:true

# 配方二：使用魔法水晶制作魔法铲
category: Magic Tools
permission: complicatedExample2
recipe:
  '0':
    id: DIAMOND
    amount: 1
    name: '&c&lMagical Crystal'
    lore:
      - '&r&7This crystal is rumored to forge magical tools...'
    tags:
      - fakeenchant:true
  '3':
    id: STICK
  '6':
    id: STICK
reward:
  '0':
    id: DIAMOND_SHOVEL
    amount: 1
    name: '&c&lMagical Shovel'
    lore:
      - '&r&7Where did this come from?!'
    enchantments:
      - digspeed:20

❓API 使用简例

首先，确保你的 plugin.yml 正确设置了依赖或软依赖。

public void whateverMethod(){
    // 获取 RecipesRedone 插件实例
    RecipesRedone plugin = (RecipesRedone) Bukkit.getPluginManager().getPlugin("RecipesRedone");

    // 创建材料与产出的字符映射
    Map<Character, ItemStack> recipeMap = new HashMap<>();
    recipeMap.put('i', new ItemStack(Material.IRON_INGOT));
    recipeMap.put('g', new ItemStack(Material.GOLD_INGOT));
    recipeMap.put('d', new ItemStack(Material.DIAMOND));
    recipeMap.put('X', null); // 代表空位

    Map<Character, ItemStack> rewardsMap = new HashMap<>();
    rewardsMap.put('e', new ItemStack(Material.EMERALD));
    rewardsMap.put('X', null);

    // 创建新配方
    // 参数：6行输入形状，材料映射，6行输出形状，产出映射，权限，固定为false
    ModernRecipe mr = new ModernRecipe(
        "iii", "XXX", "ggg", "XXX", "ddd", "",
        recipeMap,
        "eXX", "XXX", "XXX", "XXX", "XXX", "",
        rewardsMap,
        "", // 无权限要求
        false
    );
    // 配方在 ModernRecipe 对象创建时即自动注册

    // 取消注册配方
    plugin.unregisterRecipe(mr);
    // 重新注册配方
    plugin.registerRecipe(mr);
}

🔧更新日志摘要

• 1.3：新增批量合成（1x, 16x, 32x, 64x）支持。API 有变更，需更新相关代码。
• 1.4：新增配方教程系统 (/recipestutorial)、UI 音效、自定义材质合成、物品伤害值标签。
• 1.5：新增游戏内配方创建器 (/createrecipe) 和重载命令 (/reloadrecipes)。
• 1.6：新增自定义头颅合成支持，无需资源包。
• 1.20.1.a.1：支持 Minecraft 1.20，新增 custommodeldata、playerskulls、textureskulls 标签及无附魔发光效果。

💡注意事项与已知问题

• 本插件并非取代原版合成，你仍然需要原版系统来处理原版配方。
• 无法通过拖拽放置最后一个材料，必须使用左键或右键单击，配方检测才会运行。
• 在 1.3 版本之前，无法一次性合成多个物品，此问题已在 1.3 版本修复。
• 创建配方时，请务必遵循“左上角对齐”原则，以确保方向变换正常工作。
• 对于更直观的图形化配方配置工具，可以查看 MCG RR Maker by mmuziek。

---

开发者注：我是一名大学生，开发插件是业余爱好。如果你愿意支持我的学业，可以访问 https://paypal.me/AaronSkeels 。非常感谢！