> For the complete documentation index, see [llms.txt](https://enchantedmobs.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://enchantedmobs.superiormc.cn/for-enchantmentreform/readme.md).

# EnchantmentReform

Welcome to **EnchantmentReform**, this is a data-driven enchantment framework for modern servers. It registers custom enchantments, lets administrators redefine selected vanilla enchantments, and builds runtime effects from YAML instead of hard-coded event handlers.

This plugin includes:

* Custom enchantments registered from `enchantments/**/*.yml`.
* Optional overrides for vanilla enchantments in `vanilla_enchantments/`.
* Level expressions, variables, ranges, and PlaceholderAPI parsing.
* Rarity defaults, supported-item tags, tooltip sorting, and enchanting-table integration.
* Player equipment lifecycle handling through active slots and `on-activate` / `on-deactivate`.
* Combat, projectile, block, movement, fishing, trading, inventory, item, and environment triggers.
* Reusable MatchItemFormat and MatchEntityFormat rules.
* Paper, Spigot, and Folia-aware scheduling; some registry and event features remain platform-specific.
* Integrations for custom-item, economy, protection, MythicMobs, PacketEvents, NBTAPI, and EnchantmentSlots ecosystems when the corresponding plugin is installed.

{% hint style="warning" %}
Minecraft enchantment registries are frozen after server bootstrap. Adding or removing enchantments, changing registry fields, supported items, rarity-derived registry values, or vanilla enchantment definitions requires a **full server restart**. `/enchantmentreform reload` only reloads runtime-safe files and cannot rebuild the frozen registry.
{% endhint %}

## Recommended reading

* [Requirements](/for-enchantmentreform/info/zhun-bei.md)
* [Installation and updates](/for-enchantmentreform/info/install.md)
* [Migrating from another enchantment plugin](/for-enchantmentreform/info/migrating-from-other-enchantment-plugins.md)
* [Configuration files](/for-enchantmentreform/info/configuration-files.md)
* [Enchantment configuration](/for-enchantmentreform/configs/enchantment-configuration.md)
* [Power Triggers](/for-enchantmentreform/configs/triggers.md)
* [Power Conditions](/for-enchantmentreform/configs/power-conditions.md)
* [Power Modifiers](/for-enchantmentreform/configs/power-modifiers.md)
* [Built-in Enchantments and Supported Versions](/for-enchantmentreform/info/builtin-enchantments.md)
* [Abilities](/for-enchantmentreform/configs/info-of-abilities.md)

## Links

### Get the plugin

### Get support

Support is provided through the [Discord server](https://discord.gg/RZajEybhBw). Please read the server rules and plugin license before requesting assistance.

Users in mainland China who purchased the plugin may use QQ group `815351827` with proof of purchase.