# Types A **type** groups enchantments by what they are for, not by how rare they are (that is the [rarity](Rarities)). 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`. ```yaml types: normal: name: "Normal" limit: 0 grindstone: true high-level-bias: 0 special: name: "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: ```yaml 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`](Vanilla-Enchantments); 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](Tooltips#enchanted-books) (`%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](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](Tooltips#order).