Описание
# Recipe Helper
**Recipe Helper** is a Minecraft mod that adds the `/recipe_helper` command, allowing you to dynamically manage crafting recipes while the game is running.
All subcommands require **permission level 2** (i.e., default OP privileges).
---
## 📖 New Version (>1.0)
The mod has been completely rewritten. Old recipes from versions ≤1.0 are **not compatible** with this new version. Recipes are now generated in standard JSON format instead of the old custom format.
### Commands
The command system has been greatly simplified. Use:
/recipe_helper openGUI
to open the graphical user interface. All recipe management (adding, editing, deleting) is now done through the GUI. The old command-based recipe creation and removal have been removed.
### Recipe Storage
All created or modified recipes are stored in:
config/registerhelper/recipes
### Supported Mods
This mod supports recipe creation and modification for:
- Avaritia (Endless: Reborn)
- Eternis Starry Sky
- Mystical Agriculture
- Botania
- Farmer's Delight
- And more!
### Export Support
Recipes can be exported as code for:
- **KubeJS**
- **CraftTweaker**
> ⚠️ **Note:** The following export commands are no longer maintained and may not work:
/recipe_helper export kubejs single # Export all recipes to a single KubeJS file
/recipe_helper export kubejs multiple # Export all recipes to multiple KubeJS files
/recipe_helper export crafttweaker single # Export all recipes to a single CraftTweaker file
/recipe_helper export crafttweaker multiple # Export all recipes to multiple CraftTweaker files
text
### Reloading Recipes
When using the mod on a server:
- The `/reload` command must be executed from the **server console** (OP executing `/reload` client-side will not work).
- OPs can use the following command to synchronize recipes:
/recipe_helper reload
text
This fully reloads the datapack, equivalent to the server console `/reload` command.
---
### NBT Handling
- **Middle-click** on an item with NBT data to completely ignore NBT.
- **Shift + Middle-click** to enter the **exact matching interface**, allowing you to configure which NBT tags to ignore.
- A default preset is available for **Bamboo Mod (SlashBlade)** swords.
- The configuration file also allows you to modify whether items carry NBT by default.
---
## 🛠️ Creating Recipe Processors via JSON
You can add custom recipe processors by placing JSON files in:
config/registerhelper/processor
text
### Example JSON:
```json
{
"processor": {
"modid": "eternisstarrysky",
"methods": {
"isModLoaded": {
"condition": {
"type": "forge:mod_loaded",
"modid": "eternisstarrysky"
}
},
"getSupportedRecipeTypes": {
"return": ["vanilla_workbench_s"]
},
"createRecipeJson": {
"generator": "shapeless",
"recipeType": "eternisstarrysky:vanilla_workbench_s"
}
}
},
"recipeType": {
"type": "vanilla_workbench_s",
"displayName": "Vanilla Special Workbench",
"layout": "custom_layout_id"
}
}
```
Place the JSON file in config/registerhelper/processor and restart the game. The processor will load automatically and appear in the GUI.
Built-in Layouts
The mod includes the following built-in layout IDs:
rectangular_3x3, rectangular_9x9, rectangular_4x1, rectangular_1x1, rectangular_2x2, rectangular_5x5, rectangular_11x11, minecraft_brewing, stonecutting, smithing, runic_altar, arc_furnace, infusion, reprocessor, cutting, cooking, emptying, create_cutting, compacting, filling.
More mod integrations will be added in future updates.
🖼️ Gallery
(Placeholder for screenshots)
📜 Legacy Version (≤1.0)
Note: These commands are for older versions (≤1.0) and are kept here for reference only.
Commands
text
/recipe_helper gui
Opens the graphical recipe management interface.
After modifying or adding recipes, use:
text
/recipe_helper reload
to reload the recipes.
Add Recipes
Shaped:
text
/recipe_helper add shaped
: Output item
: Output quantity (1–64)
: Pattern string
Example:
text
/recipe_helper add shaped minecraft:diamond 1 "###,# #,###;#:minecraft:iron_ingot"
(Iron ingots in a ring shape craft a diamond)
Shapeless:
text
/recipe_helper add shapeless
: Output item
: Output quantity
: List of ingredients (separated by ;)
Example:
text
/recipe_helper add shapeless minecraft:stick 4 "minecraft:planks;minecraft:planks"
Smelting:
text
/recipe_helper add smelting
Example:
text
/recipe_helper add smelting minecraft:iron_ore minecraft:iron_ingot
Avaritia (Endless: Reborn):
text
/recipe_helper add avaritia
: Singularity Workbench tier (1–4)
Example:
text
/recipe_helper add avaritia minecraft:nether_star 1 4 "###,###,###;#:minecraft:diamond_block"
Other Legacy Commands
text
/recipe_helper register
/recipe_helper reload from_json
/recipe_helper delete recipe
/recipe_helper delete all confirm
/recipe_helper delete list
/recipe_helper clear
/recipe_helper count
/recipe_helper help
Legacy Compatibility Notes
Compatible with Avaritia: Endless Reborn (excluding compressor recipe modifications).
All recipes are stored in config/recipes.
⚠️ Important Notes
Dynamically modifying recipes is an advanced feature and may affect the logic of other mods.
It is strongly recommended to use this mod only in a testing environment or on servers that require hot-reloading of recipes.
Be extremely cautious when performing bulk operations such as deleting all recipes.
📦 Requirements
For version ≥1.6, JEI version must be ≥ 15.20.0.112 for brewing stand and anvil recipes to display correctly.