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

Unlimited enchantments levels ( configurable )