Skip to content

Vanilla Enchantments

neoramm edited this page Nov 5, 2026 · 1 revision

Changing Vanilla Enchantments

plugins/MetaEnchants/vanilla.yml changes the vanilla enchantments of the game: Sharpness, Mending, Protection...

enchantments:
  sharpness:
    max-level: 6
    description:
      - "<gray>Extra damage against everything."
  mending:
    removable: false
    type: special

Write each enchantment by its id: sharpness, fire_aspect, minecraft:mending... (with or without minecraft:). MetaEnchants enchantments are changed in their own files, not here.

The options

Option What it does Needs
name A new name, with colors. It is the name everywhere: tooltips, commands, the anvil. Restart
max-level A new maximum level (1 to 255). The enchanting table, villagers, loot and /enchant use it. Restart
weight How common it is (1 to 1024). See Weight. Restart
anvil-cost How expensive it is at the anvil (0 to 255). Restart
description Lines shown under it in the tooltip. Can change per level. Reload
type Its type, for limits per item and the tooltip order. Reload
removable false means the grindstone cannot remove it. Reload
applies-to The text of %applies_to% on books. Reload

Options that need a restart are written into the game when the server starts, like the options of MetaEnchants enchantments. See Restart or reload?.

Examples

Sharpness up to VI, with a description:

enchantments:
  sharpness:
    max-level: 6
    description:
      - "<gray>Extra damage against everything."

Mending that the grindstone cannot remove:

enchantments:
  mending:
    removable: false

A gold, renamed Protection:

enchantments:
  protection:
    name: "<gold>Guardian"

Things to know

  • Items that already have a level above a new, lower max-level keep it. It works as a level above the maximum.
  • Lowering max-level does not change books or items that already exist.
  • If an id is wrong, the console says 'x' is not an enchantment and is ignored on reload.

Clone this wiki locally