Repository navigation
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.5Write the id of the type in the enchantment file:
type: specialEnchantments 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.
| 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 |
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.
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.
tooltip.sort: type shows enchantments in the order of their types in types.yml. See Tooltips.