# 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.0+**\
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

* **103+ Custom Enchantments** out of the box, covering swords, axes, bows, armor, tools, fishing rods, hoes, and more
* **48+ 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](https://superenchants.gitbook.io/superenchants-wiki/getting-started) - Installation and first-run guide
* [Commands](https://superenchants.gitbook.io/superenchants-wiki/general/commands) - All commands with syntax and examples
* [Permissions ](https://superenchants.gitbook.io/superenchants-wiki/general/permissions)- Full permission reference
* [Enchantments](https://superenchants.gitbook.io/superenchants-wiki/enchantments/default-enchantments) - Master list of all default enchantments
* [Creating Enchantments](https://superenchants.gitbook.io/superenchants-wiki/enchantments/creating-enchantments) - YAML field reference for creating your own
* [Action Types](https://superenchants.gitbook.io/superenchants-wiki/enchantments/action-types) - All 36 action types with parameters
* [Configuration](https://superenchants.gitbook.io/superenchants-wiki/general/configuration) - config.yml reference
* [Triggers and Targets](https://superenchants.gitbook.io/superenchants-wiki/enchantments/triggers-and-targets) - When and who enchants affect
* [Scaling Functions](https://superenchants.gitbook.io/superenchants-wiki/enchantments/scaling-functions) - Level-based value scaling
* [Item Groups](https://superenchants.gitbook.io/superenchants-wiki/enchantments/item-groups) - Material groups for `applicable_items`
* [Conflicts](https://superenchants.gitbook.io/superenchants-wiki/enchantments/conflicts) - Enchantment conflict system
* [FAQ](https://superenchants.gitbook.io/superenchants-wiki/faq) - Common questions and answers

### Compatibility

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://superenchants.gitbook.io/superenchants-wiki/home.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.