Skip to content
neoramm edited this page Nov 5, 2026 · 1 revision

Types

A type groups enchantments by what they are for, not by how rare they are (that is the rarity). Types are useful to say things like:

  • "An item can only have one Special enchantment."
  • "The grindstone cannot remove Special enchantments."
  • "The enchanting table rarely gives high levels of Special enchantments."

Types live in plugins/MetaEnchants/types.yml and reload with /metaenchants reload.

types:
  normal:
    name: "<gray>Normal"
    limit: 0
    grindstone: true
    high-level-bias: 0
  special:
    name: "<light_purple>Special"
    limit: 1
    grindstone: false
    high-level-bias: 0.5

Giving an enchantment a type

Write the id of the type in the enchantment file:

type: special

Enchantments without type get the first type of types.yml (normal in the default file). Vanilla enchantments can get a type in vanilla.yml; otherwise they also get the first one.

If types.yml does not exist, there is a single normal type with no limits.

The options of a type

Option What it does Default
name How the type is called in messages and in the tooltip (%type%). Colors work. The id with a capital letter.
limit The most enchantments of this type one item can have. 0 means no limit. 0
grindstone false means the grindstone cannot remove enchantments of this type. An enchantment can override it with removable. true
high-level-bias From 0 to 1. Makes the enchanting table give lower levels of this type. 0

limit

With limit: 1 on special, a sword with Soulbound (special) cannot get another special enchantment: dragging the book, the anvil and the enchanting table all refuse it, and the player reads:

This item already has the most Special enchantments it can have (1).

See Applying Enchantments for every place where limits apply.

high-level-bias

When the enchanting table rolls an enchantment of this type at level II or more, each level has a high-level-bias chance to go down by one, one after another.

With high-level-bias: 0.5, a roll of level III:

Result Chance
III 50%
II 25%
I 25%

0 keeps the vanilla levels; 1 always gives level I.

Sorting tooltips by type

tooltip.sort: type shows enchantments in the order of their types in types.yml. See Tooltips.

Clone this wiki locally