Custom Enchantment Builder - Data Driven JSON

Build a brand-new data-driven enchantment for Minecraft Java 1.21+ and download it as a ready-to-install datapack. Pick the items it fits, its rarity, costs, and one of the common effects.

Minecraft version

Loading...

New registry entry, not a replacement

On Java Edition 1.21 and later, enchantments are loaded from datapacks. This builds a brand-new entry, so every vanilla enchantment stays in the game next to yours. Everything is generated in your browser; nothing is uploaded.

1 - Name and id
Display name
Description (shown in the tooltip)
Namespace
Enchantment id

Full id: mypack:lifesteal

2 - Which items can use it
Supported items

#minecraft:enchantable/sharp_weapon

3 - Equipment slots

The slots an item must be worn or held in for the effect to count.

4 - Rarity and cost
Weight
higher = more common
Max level
Anvil cost
per level on the anvil
Exclusive set (cannot combine with)
Enchanting table cost (experience levels)
Min cost base
Min cost per level
Max cost base
Max cost per level

These set the level range where the enchantment can appear at an enchanting table.

5 - Effect

Inflicts a status effect on whatever you hit, like Bane of Arthropods slowing arthropods.

Status effect
Amplifier
0 = level I
Seconds at lvl 1
Extra sec/level
6 - Availability and pack
Custom Enchantments
PNG, square
Enchantment JSON
data/mypack/enchantment/lifesteal.json
{
  "anvil_cost": 2,
  "description": {
    "text": "Lifesteal"
  },
  "effects": {
    "minecraft:post_attack": [
      {
        "enchanted": "attacker",
        "affected": "victim",
        "effect": {
          "type": "minecraft:apply_mob_effect",
          "to_apply": "minecraft:poison",
          "min_amplifier": 0,
          "max_amplifier": 0,
          "min_duration": {
            "type": "minecraft:linear",
            "base": 3,
            "per_level_above_first": 2
          },
          "max_duration": {
            "type": "minecraft:linear",
            "base": 3,
            "per_level_above_first": 2
          }
        },
        "requirements": {
          "type": "minecraft:damage_source_properties",
          "predicate": {
            "is_direct": true
          }
        }
      }
    ]
  },
  "max_cost": {
    "base": 25,
    "per_level_above_first": 8
  },
  "max_level": 3,
  "min_cost": {
    "base": 5,
    "per_level_above_first": 8
  },
  "slots": [
    "mainhand"
  ],
  "supported_items": "#minecraft:enchantable/sharp_weapon",
  "weight": 5
}
Datapack folder tree
custom_enchantments/
+- pack.mcmeta
+- pack.png
+- data/
+- mypack/
+- enchantment/
+- lifesteal.json
+- minecraft/
+- tags/enchantment/
+- tradeable.json
+- non_treasure.json

Save this enchantment

Sign in to keep it in your dashboard. Without an account you still get a share link.

Sign in to save

Build a Data-Driven Enchantment, No Mod Required

Since Java Edition 1.21, enchantments live in a datapack registry, so a single JSON file adds a brand-new enchantment with a real effect. This builder writes that file for you and packages it as a datapack you can drop straight into a world. It all runs in your browser, so nothing uploads.

Each enchantment is one entry at data/<namespace>/enchantment/<name>.json. The tool fills in every field the game expects: the description text component, the supported_items tag that decides which items can carry it, the weight and max_level that set how often and how high it rolls, and the min_cost and max_cost that place it on the enchanting table level scale.

Pick from the real vanilla item tags such as #minecraft:enchantable/weapon or #minecraft:enchantable/armor, add an optional primary_items tag to narrow where it is offered, and set an exclusive_set so it cannot combine with a chosen group. The JSON preview updates live and you can copy it or download the whole datapack.

Effects You Can Add

The builder offers the three effect components most people want, each written exactly the way the vanilla enchantments use them. minecraft:damage adds bonus attack damage on a level-scaled value, the way Sharpness does. minecraft:attributes applies an attribute modifier while the item is equipped, for example extra movement speed or armor. minecraft:post_attack with an apply_mob_effect effect inflicts a status effect on whatever you hit, the way Bane of Arthropods slows arthropods.

Values that grow with the level use a linear value provider (a base plus a per-level amount). When you leave the per-level amount at zero the tool writes a simpler constant value instead, which is what the game expects for flat effects.

FieldWhat it does
supported_itemsItem tag for everything that can hold the enchantment
primary_itemsNarrower tag for table and trade offers (optional)
weightRoll chance against other enchantments (higher is more common)
max_levelThe highest level the enchantment can reach
min_cost / max_costExperience level range on the enchanting table
anvil_costPrior-work cost added per level when combining on an anvil
exclusive_setA group it cannot be combined with
slotsWhere the item must be held or worn for the effect to count

Install the Datapack

1. Download the zip and unzip it. Inside is a folder with a pack.mcmeta and a data folder.

2. Copy that folder into .minecraft/saves/<your world>/datapacks/, then run /reload in game or re-open the world.

3. Confirm it loaded with /datapack list, then apply it with /enchant @s <namespace>:<id> 1 or pull it from an enchanting table if you enabled table offers.

Frequently Asked Questions

How do I make a custom enchantment in Minecraft?

On Java Edition 1.21 and later, enchantments are data-driven, so you write a JSON file and load it from a datapack. This tool builds that JSON for you: pick the items it fits, set the weight, max level, anvil and table cost, and an effect, then download a datapack with the file at data/<namespace>/enchantment/<name>.json. Drop the folder in your world's datapacks folder and run /reload.

What goes in a data-driven enchantment JSON?

The required keys are description (a text component), supported_items (an item tag like #minecraft:enchantable/weapon), weight, max_level, min_cost and max_cost (each with base and per_level_above_first), anvil_cost, slots, and effects. Optional keys include primary_items, which limits where it can be offered, and exclusive_set, which stops it combining with a group of other enchantments. This tool writes every key in the same order as the vanilla files.

Why does my custom enchantment not show at the enchanting table?

An enchantment is only offered at the table if it is in the #minecraft:in_enchanting_table tag and usually the #minecraft:non_treasure tag. The builder adds your enchantment to both tags when you tick the availability boxes. If you still do not see it, make sure the item you are enchanting matches your supported_items tag and your table is at a high enough bookshelf level for the min_cost you set.

How do I give myself a custom enchantment?

After the datapack is loaded with /reload, run /enchant @s <namespace>:<id> <level>, for example /enchant @s mypack:lifesteal 1. You can also place it on a book or item directly with /item or by editing the item's components. The tool shows the exact /enchant command for your enchantment in the success panel after you download.

Can I make a custom enchantment without a mod?

No mod is needed on Java Edition 1.21 and later. The enchantment registry is loaded from datapacks, so a plain JSON file is enough to add a working enchantment with a real effect. This page targets Minecraft 26.3 and earlier 1.21 releases. Effects beyond damage, attributes and status-on-hit (like custom particle logic) still need a mod or extra command-block work.

Does this work on Bedrock Edition?

No. Data-driven enchantments use the Java Edition enchantment registry, which Bedrock does not have. There is no datapack equivalent for adding new enchantments on Bedrock, so this tool is Java only. On Bedrock you can only change the level of existing enchantments with commands.

Add other custom content, or browse more tools: