Limits

< Back to homepage

Enchantment Limits

Sortilege can limit how many enchantments an item may hold.

The limit counts different enchantments, not the combined levels of those enchantments. For example, Sharpness V occupies one slot, while Sharpness V and Unbreaking III occupy two.

By default, an item has 3 enchantment slots.

Slot usage

Each enchantment normally occupies one slot.

When curses_add_slots is enabled, curses behave differently:

• Curses do not consume a normal enchantment slot.
• Each curse adds another slot to the item.
• A curse may be applied even when all normal slots are occupied.

This allows a cursed item to carry more enchantments than an otherwise identical item.

Enchanted Books are not restricted by the item enchantment limit.

Viewing an item's limit

An item's tooltip displays its used and available enchantment slots.

When always_show_limit is enabled, the limit is shown even before the item receives its first enchantment.

Configuration

The limiter is configured under:

{
  "enchanting": {
    "limiter": {
      "default": 3,
      "curses_add_slots": true,
      "override_mode": "relative",
      "overrides": {},
      "always_show_limit": true
    }
  }
}

Field	Description
default	Base number of enchantment slots available to items.
curses_add_slots	Makes curses add slots rather than consume them.
override_mode	Determines whether overrides add to or replace the default limit.
overrides	Per-item or per-tag enchantment-limit changes.
always_show_limit	Displays an item's limit even while it is unenchanted.

Special default values

• Set default to -1 to disable the limiter.
• Set default to 0 to prevent normal items from receiving enchantments.

Overrides

Overrides can target either an individual item or an item tag.

{
  "enchanting": {
    "limiter": {
      "default": 3,
      "override_mode": "relative",
      "overrides": {
        "minecraft:golden_sword": 2,
        "#minecraft:swords": 1
      }
    }
  }
}

Individual items use their resource identifier:

modid:item_id

Item tags begin with #:

#modid:tag_id

Exact item overrides are checked before tag overrides.

Relative mode

With "override_mode": "relative", the override is added to the default limit.

Using a default of 3:

Override	Final limit
2	5
1	4
0	3
-1	2

Absolute mode

With "override_mode": "absolute", the override becomes the item's complete base limit.

Override	Final limit
5	5
2	2
0	0
-1	Unlimited

Limitite

Limitite permanently adds one enchantment slot to an item.

Use a Smithing Table with:

Smithing slot	Ingredient
Template	Lapis Lazuli
Base	The item being improved
Addition	Limitite

The result preserves the original item and adds one extra enchantment slot.

Limitite can only be applied when:

• The item has a positive enchantability value.
• The item's configured base limit is not 0.
• The item has not reached the configured Limitite maximum.

By default, an item can receive up to 3 additional slots from Limitite.

Limitite configuration

{
  "enchanting": {
    "limiter": {
      "limitite": {
        "has_glint": true,
        "loot_weight": 24,
        "max_limit_break": 3
      }
    }
  }
}

Field	Description
has_glint	Gives Limitite an enchantment glint.
loot_weight	Gives Limitite a 1-in-X chance to appear when eligible loot is generated. Set to 0 or lower to disable this loot generation.
max_limit_break	Maximum number of Limitite upgrades that may be applied to one item.

Datapack customization

Items accepted as Limitite materials are controlled by:

#sortilege:is_limit_break_material

Sortilege places sortilege:limitite in this tag by default. A datapack may add other materials or replace the tag entirely.

The extra slots added by Limitite are stored on the individual item. Changing the global limit later does not erase those upgrades.