Documentation — Unlimited Enchantments
Overview
| Name |
Unlimited Enchantments |
| Mod ID |
unlimitedench |
| Version |
1.0.0 |
| Minecraft |
1.20.1 |
| Loader |
Forge 47.x |
| Java |
17 |
| Side |
Server + Client (BOTH) |
The mod changes how the anvil works so you can stack enchantments beyond the vanilla maximum level. It adds no items, blocks, or recipes — everything runs through the normal anvil, which keeps it lightweight and highly compatible with other mods.
In-game usage
Basic principle
- Put the item to upgrade in the left slot of the anvil.
- Put an identical item (or an enchanted book) carrying the same enchantment at the same level in the right slot.
- The output shows the next level up. Take it for the XP cost displayed.
- Repeat as much as you want: VI + VI → VII, VII + VII → VIII, and so on.
Examples
- Sword Sharpness V + Sword Sharpness V → Sword Sharpness VI
- Sword Sharpness V + Book Sharpness V → Sword Sharpness VI
- Pickaxe Efficiency V + Book Efficiency V → Pickaxe Efficiency VI
Preserved vanilla behavior
- Different enchantments or different levels: combine normally (keeps the higher one), with no level bonus.
- Durability: combining two identical items repairs the item (+12% bonus), just like vanilla.
- Renaming: the anvil name field still works.
- Compatibility: by default an enchantment can only go on a compatible item with no conflicts (e.g. Silk Touch vs Fortune). This can be disabled in the config.
Gameplay effects
Effects scale automatically with the stored level: a Sharpness VI deals more damage than a V, Protection VI shields more, and so on. Above level 10 the level shows as an arabic number (e.g. "Sharpness 12") because vanilla roman numerals only go up to X.
XP cost & the survival limit
Each merge has an XP level cost based on the enchantment's rarity and target level, capped at maxAnvilCost (default 39).
Important: vanilla blocks taking any anvil result that costs 40 levels or more in survival mode ("Too Expensive!"). That's why the cost is capped at 39 by default — so high-level merges stay obtainable in survival. Creative mode ignores this limit entirely.
Admin commands (OP level 2)
Set the maximum level, globally or per enchantment. 0 means unlimited.
| Command |
Effect |
/unlimitedench setmax <enchantment> <level> |
Cap for one enchantment — e.g. /unlimitedench setmax minecraft:sharpness 10 |
/unlimitedench setdefault <level> |
Default cap for every other enchantment |
/unlimitedench get <enchantment> |
Show the effective cap for that enchantment |
/unlimitedench reset <enchantment> |
Remove the override → back to the default |
/unlimitedench resetall |
Remove all overrides |
/unlimitedench list |
List the default + all overrides |
The <enchantment> argument has tab autocompletion (minecraft:… plus modded enchantments). Settings are saved to config/unlimitedench_limits.json and persist across sessions and restarts. They are global to the server/instance (not per-world).
Example setup: keep most enchantments unlimited but cap Sharpness and Power:
/unlimitedench setdefault 0
/unlimitedench setmax minecraft:sharpness 10
/unlimitedench setmax minecraft:power 8
