Custom Recipes

# 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.