Welcome to the Nbt Crafting v3 wiki!

Warning

Nbt Crafting v3 is in alpha state. While the basic concepts might remain working, expect breakage. There are no stability guarantees for the Java API.

Links in this wiki might also change and break during the development process.

Information about updating from Nbt Crafting v2

Nbt Crafting is a mod which finally introduces nbt-related recipes.

curseforge downloads modrinth downloads supported Minecraft versions: 1.15 | 1.16 | 1.17 | 1.18


If you want to get started with datapacks and recipes in Minecraft you can check out the Resources site.

Basic usage

The basic starting point is using the nbtcrafting3:data recipe type. This special recipe type allows you to use the Nbt Crafting functionality inside of your recipe.

It works by specifying a recipe object, which contains the normal recipe type and data. See below for an example.

Example Recipe

Sometimes one Hello-World-ish example is worth a thousand words.

{
    "type": "nbtcrafting3:data",
    "recipe": {
        "type": "crafting_shapeless",
        "ingredients": [
            {
                "item": "minecraft:diamond_sword",
                "data": {
                    "require": {
                        "Damage": "$..40"
                    }
                }
            },
            { "item": "minecraft:diamond" }
        ],
        "result": {
            "item": "minecraft:diamond_axe",
            "data": {
                "display": {
                    "Name": "{\"text\":\"Battle Axe\"}"
                },
                "Enchantments": [
                    {
                        "id": "minecraft:sharpness",
                        "lvl": 10
                    }
                ]
            }
        }
    }
}

More information

For detailed information see recipe results and recipe ingredients.

You might also want to add brewing, cauldron or anvil recipes.

Go here if you're a modder and want to work with Nbt Crafting.