Custom Recipes
A plugin for Paper Minecraft that lets you create custom Minecraft recipes, usable in the crafting grid.
Custom Recipes
Custom Recipes Plugin
Author: 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
- Custom NBT data using items from your inventory - Custom NBT data saved across server restarts automatically - Custom NBT data — no special crafting blocks needed - Custom NBT data to build and manage your recipes - Custom NBT data 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. saved persistently to open the recipe creation GUI. 2. The GUI shows a saved persistently on the left, and an output slot on the bottom right. 3. saved persistently in the 3x3 grid by clicking items from your inventory into the grid slots. 4. saved persistently by placing the resulting item in the output slot. 5. Once you have the input ingredients and output set, click the saved persistently (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.