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.3.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

• 93+ Custom Enchantments out of the box, covering swords, axes, bows, armor, tools, fishing rods, hoes, and more

• 42+ 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 - Installation and first-run guide

• Commands - All commands with syntax and examples

• Permissions - Full permission reference

• Enchantments - Master list of all default enchantments

• Creating Enchantments - YAML field reference for creating your own

• Action Types - All 36 action types with parameters

• Configuration - config.yml reference

• Triggers and Targets - When and who enchants affect

• Scaling Functions - Level-based value scaling

• Item Groups - Material groups for applicable_items

• Conflicts - Enchantment conflict system

• FAQ - Common questions and answers

Compatibility

• Server: Paper 1.21+ (or forks like Purpur).

• Java: 21+

• Soft Dependencies: WorldGuard, GriefPrevention, Towny, Lands, Residence