Custom Recipes Plugin

Version: Paper/Spigot 1.21.5
Author: TomMustBe12

---

Overview

Custom Recipes lets you easily create your own crafting recipes directly in-game! Use the /recipe command to open a powerful, intuitive GUI that allows you to craft custom recipes that persist between server restarts. These recipes are fully compatible with the vanilla crafting grid, allowing you and your players to craft custom items without any external tools or config files.

---

Features

• Create custom recipes on the fly using items from your inventory
• Persistent recipes: saved across server restarts automatically
• Craftable in the vanilla crafting grid — no special crafting blocks needed
• Simple GUI interface to build and manage your recipes
• Permission-based control to restrict who can create recipes
• Custom NBT data saved on input or output items, allowing for more flexibility.

---

Commands & Permissions

/recipe

• Opens the custom recipe creation GUI
• Requires permission:
  • customrecipes.set — Allows the player to create and manage custom recipes

Permissions Summary

Permission	Description	Default
customrecipes.set	Allows using /recipe command and managing custom recipes	OP only

Note: Only players with customrecipes.set permission can create or modify custom recipes. Others can still craft the recipes but cannot add or remove them.

---

How to Use the Custom Recipe GUI

1. Run the command /recipe to open the recipe creation GUI.
2. The GUI shows a 3x3 crafting grid on the left, and an output slot on the bottom right.
3. Place the ingredients in the 3x3 grid by clicking items from your inventory into the grid slots.
4. Set the output item by placing the resulting item in the output slot.
5. Once you have the input ingredients and output set, click the "Submit" button (green wool) to register the recipe.
6. The recipe is now saved persistently and craftable by anyone using the vanilla crafting table!
7. Please note that eventually in further versions I will create a way to delete custom recipes. Right now, to delete, you will have to delete the recipe id in the config.yml.

---

Additional Notes

• Recipes are saved to config.yml automatically; no manual config editing required.
• You can create multiple recipes for the same output, and all will be recognized. However, creating a recipe that already exists will overwrite the vanilla recipe and replace with the new recipe.

---

Example Usage

1. Give yourself permission or be OP:
   /lp user YourName permission set customrecipes.set true (if using LuckPerms)
2. Run /recipe to open the GUI.
3. Put any combination of ingredients, for example: 1 diamond + 1 stick.
4. Set the output item to a diamond sword.
5. Save the recipe.
6. Now anyone can craft a diamond sword using just a diamond and a stick!

---

Support & Contributions

If you find bugs or want to request features, please open an issue on the plugin’s GitHub page or contact me, TomMustBe12.