# NBTRecipes<\/p>\n
#### A very simple plugin to add recipes that use NBT data.<\/p>\n
## Description<\/p>\n
Plugin designed to simplify creation of custom recipes, without the need writing any code or touching datapacks.
\nYou can attach common data (amount, name, lore) as well as NBT tags to items processed by the recipes.
\nFormat is very similar to the one used by datapacks.<\/p>\n
## Usage
\nYou can place your recipes inside the `recipes` folder in the plugin folder.
\nIf you want to organize your recipes in subfolders you can do it, the plugin will search for recipes in every subfolder of the `recipes` folder.
\nThe plugin will automatically load all the recipes in the subfolders and add their relative path to the recipe namespaced key.<\/p>\n
To create a recipe just create a text file with the `.json` extension and put it in the `recipes` folder.
\nEdit the file with your favorite text editor and put the recipe in it as shown in the examples below.<\/p>\n
### Config
\nIn the config you can change the namespace of your recipes and all the messages of the plugin.
\nThe namespace can only contain the following characters: `a-z`, `0-9`, `_`, `-`, `\/`.<\/p>\n
<\/p>\n
### Commands
\n* `\/nbtrecipes reload` – Reloads the recipes and the config file.
\n * `nbtr.command` Permission needed to use the command.
\n* `\/nbtrecipes list` – Lists all the recipes added by this plugin.
\n * `nbtr.command` Permission needed to use the command.<\/p>\n
<\/p>\n
## Examples
\nExamples and more detailed description of plugin components.<\/p>\n
<\/p>\n
### Item
\nThis is an object that represents an item in the recipes, it can be used as an ingredient or as a result. Majority of fields are optional, in fact, the only one needed is the `material`.<\/p>\n
When only `material` field is defined, and no other items within the choice requires any metadata (name, lore, nbt), items in the recipe are matched by material.<\/p>\n
*See below examples for more details.*<\/p>\n
<\/p>\n
### Discover Trigger
\nRecipe trigger can make any recipe to be discoverable by players, by picking up an item.
\nField `discover` is optional and if not specified, recipe will be discovered and visible by default.<\/p>\n
*See below examples for more details.*<\/p>\n
<\/p>\n
### Shaped Recipe “`json5 Field `discover` is optional.<\/p>\n<\/details>\n <\/p>\n ### Shapeless Recipe “`json5 Field `discover` is optional.<\/p>\n<\/details>\n <\/p>\n ### Smelting Recipes “`json5 Fields `experience`, `cooking_time` and `discover` are optional.<\/p>\n<\/details>\n <\/p>\n ### Smithing Recipe “`json5 Metadata (name, lore, nbt) is not supported for result items, as it’s copied directly from the base item.<\/p>\n Field `discover` is optional.<\/p>\n<\/details>\n <\/p>\n ## Contributing<\/p>\n To contribute to this repository just fork this repository make your changes or add your code and make a pull request. <\/p>\n ## License<\/p>\n NBTRecipes is released under “The 3-Clause BSD License”. You can find a copy here.es\/blob\/master\/LICENSE).<\/p>\n","protected":false},"excerpt":{"rendered":" A very simple plugin to add recipes that use NBT data<\/p>\n","protected":false},"featured_media":109153,"template":"","meta":{"_minecraft_slug":"nbtrecipes","_minecraft_project_id":"X5ARGXUx","_minecraft_author":"LoreSchaeffer","_minecraft_license":"BSD-3-Clause","_minecraft_downloads":1280,"_minecraft_follows":10,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"nbtrecipes.zip","_minecraft_size_bytes":28913245,"_minecraft_version_count":8,"_minecraft_updated_at":"2026-05-16T07:43:52.174048Z","_minecraft_date_created":"2023-01-05T22:20:32.836279Z","_minecraft_date_modified":"2023-11-01T15:17:26.960307Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/nbtrecipes","_minecraft_icon_attachment_id":109153,"_minecraft_imported_at":"2026-06-06T10:04:44+00:00","_minecraft_import_hash":"228aefcb37af321d93228d66b6149297","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,89,127,128,129,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[49,50,51,52,53,54,55,56,57,58,845,846,847,848,849,59,36,60],"class_list":["post-109152","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-2-1","minecraft_version-1-2-2","minecraft_version-1-2-3","minecraft_version-1-2-4","minecraft_version-1-2-5","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2"],"yoast_head":"\n
\nShaped recipe applies to crafting table and inventory crafting.<\/p>\nClick here to expand\/collapse JSON example.<\/b><\/summary>\n
\n{
\n “type”: “crafting_shaped”,
\n \/\/ Crafting pattern. Array must consist of either:
\n \/\/ – two, two-character elements reflecting an inventory crafting grid.
\n \/\/ – three, three-character elements reflecting a crafting table grid.
\n “pattern”: [
\n ” D”,
\n ” D “,
\n “S ”
\n ],
\n \/\/ Key to the pattern.
\n “key”: {
\n “S”: [
\n \/\/ Multiple item choices can be specified for one ingredient.
\n \/\/ In case metadata (name\/lore\/nbt) is attached to an item, all choices are matched as EXACT.
\n { “material”: “stick” },
\n { “material”: “blaze_rod” }
\n ],
\n \/\/
\n “D”: { “material”: “diamond” }
\n },
\n \/\/ Recipe result.
\n “result”: {
\n “material”: “diamond_sword”,
\n “amount”: 1,
\n “name”: “Diagonally Crafted Diamond Sword”,
\n “lore”: [
\n “As the name suggests…”
\n ],
\n “nbt”: “{CustomModelData: 2}”
\n },
\n \/\/ Recipe discover trigger. Optional.
\n “discover”: {
\n \/\/ Items to be picked-up before this recipe is “discovered” by the player.
\n “items”: [
\n { “material”: “diamond” }
\n ]
\n }
\n}
\n“`<\/p>\n
\nShapeless recipe applies to crafting table and inventory crafting.<\/p>\nClick here to expand\/collapse JSON example.<\/b><\/summary>\n
\n{
\n “type”: “crafting_shapeless”,
\n \/\/ Crafting ingredients.
\n “ingredients”: [
\n \/\/ Multiple item choices can be specified for one ingredient.
\n \/\/ In case metadata (name\/lore\/nbt) is attached to an item, all choices are matched as EXACT.
\n [
\n { “material”: “oak_log” },
\n { “material”: “spruce_log” },
\n { “material”: “birch_log” },
\n { “material”: “jungle_log” },
\n { “material”: “acacia_log” },
\n { “material”: “dark_oak_log” },
\n { “material”: “mangrove_log” },
\n { “material”: “cherry_log” }
\n ],
\n { “material”: “flint_and_steel” }
\n ],
\n \/\/ Recipe result.
\n “result”: { “material”: “charcoal” },
\n \/\/ Recipe discover trigger. Optional.
\n “discover”: {
\n \/\/ Items to be picked-up before this recipe is “discovered” by the player.
\n “items”: [
\n { “material”: “oak_log” },
\n { “material”: “spruce_log” },
\n { “material”: “birch_log” },
\n { “material”: “jungle_log” },
\n { “material”: “acacia_log” },
\n { “material”: “dark_oak_log” },
\n { “material”: “mangrove_log” },
\n { “material”: “cherry_log” }
\n ]
\n }
\n}
\n“`<\/p>\n
\nSmelting recipes can be applied to regular furnace, blast furnace, smoker or campfire.<\/p>\nClick here to expand\/collapse JSON example.<\/b><\/summary>\n
\n{
\n \/\/ Recipe type. For furnace recipes you can use one of: [SMELTING, BLASTING, SMOKING, CAMPFIRE_COOKING]
\n “type”: “smelting”,
\n \/\/ Furnace input.
\n “input”: [
\n \/\/ Multiple item choices can be specified for one ingredient.
\n \/\/ In case metadata (name\/lore\/nbt) is attached to an item, all choices are matched as EXACT.
\n { “material”: “diamond_helmet” },
\n { “material”: “diamond_chestplate” },
\n { “material”: “diamond_leggings” },
\n { “material”: “diamond_boots” }
\n ],
\n \/\/ Recipe result.
\n “result”: { “material”: “diamond” },
\n \/\/ Experience to award player after taking smelting result. Optional.
\n “experience”: 0.7,
\n \/\/ Time it takes to cook this recipe. Measured in ticks. Optional.
\n “cooking_time”: 200,
\n \/\/ Recipe discover trigger. Optional.
\n “discover”: {
\n \/\/ Items to be picked-up before this recipe is “discovered” by the player.
\n “items”: [
\n { “material”: “diamond_helmet” },
\n { “material”: “diamond_chestplate” },
\n { “material”: “diamond_leggings” },
\n { “material”: “diamond_boots” }
\n ]
\n }
\n}
\n“`
\nAll furnace recipe types follow the same schema.
\n– `smelting` – recipe for regular furnace.
\n– `blasting` – recipe for blast furnace.
\n– `smoking` – recipe for smoker.
\n– `campfire_cooking` – recipe for campfire.<\/p>\n
\nSmithing recipe applies to smithing table.<\/p>\nClick here to expand\/collapse JSON example.<\/b><\/summary>\n
\n{
\n “type”: “smithing”,
\n \/\/ Base item, you can think of it as an item which upgrades (could) be applied to. More than one item choice can be specified.
\n “base”: { “material”: “iron_pickaxe” },
\n \/\/ Template item, you can think of it as an upgrade which is applied to the base item. More than one item choice can be specified.
\n \/\/ This field works only when running 1.20 or higher.
\n “template”: { “material”: “air” },
\n \/\/ Addition item. For vanilla recipes, it’s usually a trim material. More than one item choice can be specified.
\n “addition”: { “material”: “diamond” },
\n \/\/ Recipe result. Metadata is not supported as it’s copied directly from the base item.
\n “result”: { “material”: “diamond_pickaxe” },
\n \/\/ Recipe discover trigger. Optional.
\n “discover”: {
\n \/\/ Items to be picked-up before this recipe is “discovered” by the player.
\n “items”: [
\n { “material”: “iron_pickaxe” }
\n ]
\n }
\n}
\n“` <\/p>\n
\nIf you find an error or a bug you can open an issue here.<\/p>\n