CustomRecipeAPI - 自定义配方插件

💡简介

Custom Recipe API (CRAPI) 是一款让创建自定义合成配方变得极其简单的 API。它需要一定的编程知识，但如果你熟悉流程，下载后五分钟内即可开始制作配方。与 ItemCreatorPlus 搭配使用效果更佳。

🎮快速开始

• 下载 CRAPI。
• 将其作为依赖库添加到你的插件中。
• 开始创建自定义合成配方！

注意

现在可以通过指令 /crapi new 在游戏内通过一个易于使用的图形界面来创建配方。

🔧指令列表

• /crapi book - 打开配方书。
• /crapi new - 打开配方创建界面。
• /crapi setworkbench - 编辑工作台配方。
• /crapi workbench - 查看工作台配方。
• /crapi give <player> <item> <amount> - 给予玩家一个自定义物品。
• /crapi items - 查看所有可给予的物品。

✨权限列表

• crapi.command
• 描述：允许使用 CRAPI 指令。
• 默认：op
• crapi.book
• 描述：允许使用 CRAPI 配方书。
• 默认：op
• crapi.giveitem
• 描述：允许使用 CRAPI 配方书给予物品。
• 默认：op
• crapi.new
• 描述：允许用户在游戏内创建新配方。
• 默认：op
• crapi.setworkbench
• 描述：允许用户更新工作台配方。
• 默认：op
• crapi.viewworkbench
• 描述：允许用户查看工作台配方。
• 默认：op
• crapi.craft
• 描述：允许用户合成自定义配方。
• 默认：true
• crapi.craft.item_permission
• 描述：基于单个物品的权限。要查看物品的权限名，需拥有 crapi.op 权限并查看 /crapi book。
• crapi.craftall
• 描述：允许用户合成所有自定义配方。
• 默认：op
• crapi.give
• 描述：允许用户使用 /crapi give 和 /crapi items 指令。
• 默认：op
• crapi.op
• 描述：允许用户查看每个配方的权限名称。
• 默认：op

⭐配置文件 (config.yml)

workbenchtitle: "&e&lSpecial Crafting"
recipebook: "&e&lRecipe Book"
nextpage: "&e&lNext Page"
currentpage: "Current page"
previouspage: "&e&lPrevious Page"
customrecipeview: "&e&lCustom Recipe View"
customrecipecreator: "&e&lCustom Recipe Creator"
fullinv: "&cInventory is full. Cannot craft item."
invalidrecipe: "&cInvalid Recipe"
createrecipe: "&aCreate Custom Recipe"
toggleshapeless: "&9Toggle Shapeless Recipe"
shaped: "Shaped"
leftclicktoview: "&7Left click to view recipe."
rightclicktogive: "&7Right click to give yourself this item."
permission: "Permission"
backtomenu: "&cBack to Menu"
deleterecipe: "&cDelete Recipe"
cannotbeundone: "&7cannot be undone"
recipeview: "&7Recipe View"

❓开发者指南：创建配方

首先，你需要初始化合成工作台。必须选择发射器 (Dispenser) 作为工作台物品，但配方可以自定义。以下是一个示例：

ItemStack workbenchItem = new ItemStack(Material.DISPENSER);
ItemMeta meta = workbenchItem.getItemMeta();
meta.setDisplayName(ChatColor.YELLOW.toString() + ChatColor.BOLD.toString() + "Special Crafting");
workbenchItem.setItemMeta(meta);

ShapedRecipe workbenchRecipe = new ShapedRecipe(new NamespacedKey(main, "Workbench"), workbenchItem);
workbenchRecipe.shape("IGI", "GDG", "IGI");
workbenchRecipe.setIngredient('I', Material.IRON_BLOCK);
workbenchRecipe.setIngredient('G', Material.GLASS);
workbenchRecipe.setIngredient('D', Material.DIAMOND_BLOCK);

Bukkit.getServer().addRecipe(workbenchRecipe);
main.crapimanager.setWorkBench(workbenchRecipe);

你可以为发射器自定义物品堆，并使用常规材料创建自定义配方（因为此配方需要在普通工作台中合成）。

接下来，可以开始创建物品配方。以下是一个示例

ItemStack redstone = new ItemStack(Material.REDSTONE);
ItemStack quartz = new ItemStack(Material.QUARTZ);
ItemStack gold = new ItemStack(Material.GOLD_INGOT);
ItemStack storageCell = new ItemStack(Material.STONE_AXE);

CustomRecipeAPI.createRecipe(storageCell, redstone, quartz, redstone, quartz, gold, quartz, redstone, quartz, redstone);

配方槽位顺序

物品的摆放顺序如下：[1, 2, 3, 4, 5, 6, 7, 8, 9]。你可以放置空气 (Material.AIR) 或不放任何物品（仅在后续槽位都为空时有效）来留空槽位。

🔧资源与帮助

• JavaDocs 下载链接：https://tinyurl.com/yeo6wo63
• Discord 帮助频道：https://discord.gg/AET9mWj