> For the complete documentation index, see [llms.txt](https://superenchants.gitbook.io/superenchants-wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://superenchants.gitbook.io/superenchants-wiki/home.md).

# Home

SuperEnchants is a data-driven custom enchantment plugin for Paper 1.21+. Create, configure, and manage custom enchantments entirely through YAML files, no coding required.

### Note

This wiki was written for **SuperEnchants v4.6.2+**\
It is highly encouraged to update to the latest version of SuperEnchants, since all support for previous versions has been dropped and is no longer maintained.

### Features

* **107+ Custom Enchantments** out of the box, covering swords, axes, bows, armor, tools, fishing rods, hoes, and more
* **51+ Action Types** to use for your enchantments, from potion effects and bonus damage to lightning strikes, vein mining, and arrow rain
* **Data-Driven Design** means every enchantment is a YAML file. Add, remove, or tweak enchants by editing files
* **Enchanting Table Integration** allows custom enchants appear alongside vanilla enchants at the enchanting table
* **Villager Trades & Loot Chests** support, enchanted books appear in librarian trades and dungeon loot
* **GUI Browser -** `/segui` opens a visual enchantment GUI
* **Per-Enchant Permissions -** control who can use or apply each enchantment
* **Conflict System -** prevent incompatible enchants from being combined
* **Region Protection -** integrates with WorldGuard, GriefPrevention, Towny, Lands, and Residence
* **Scaling Functions -** linear or fixed scaling for level-based progression
* **MiniMessage Formatting -** full color and formatting support in display names and descriptions

### Quick Links

* [Getting Started](/superenchants-wiki/getting-started.md) - Installation and first-run guide
* [Commands](/superenchants-wiki/general/commands.md) - All commands with syntax and examples
* [Permissions ](/superenchants-wiki/general/permissions.md)- Full permission reference
* [Enchantments](/superenchants-wiki/enchantments/default-enchantments.md) - Master list of all default enchantments
* [Creating Enchantments](/superenchants-wiki/enchantments/creating-enchantments.md) - YAML field reference for creating your own
* [Action Types](/superenchants-wiki/enchantments/action-types.md) - All 36 action types with parameters
* [Configuration](/superenchants-wiki/general/configuration.md) - config.yml reference
* [Triggers and Targets](/superenchants-wiki/enchantments/triggers-and-targets.md) - When and who enchants affect
* [Scaling Functions](/superenchants-wiki/enchantments/scaling-functions.md) - Level-based value scaling
* [Item Groups](/superenchants-wiki/enchantments/item-groups.md) - Material groups for `applicable_items`
* [Conflicts](/superenchants-wiki/enchantments/conflicts.md) - Enchantment conflict system
* [FAQ](/superenchants-wiki/faq.md) - Common questions and answers

### Compatibility

* **Server:** Paper 1.21+ (or forks like Purpur).
* **Java:** 21+
* **Soft Dependencies:** WorldGuard, GriefPrevention, Towny, Lands, Residence