SuperEnchants
A powerful custom enchantments plugin for Paper 1.21+ that adds 103+ unique enchantments to your server through a fully data-driven YAML system.
What It Does
SuperEnchants replaces the vanilla enchanting experience with a massive library of custom enchantments spanning weapons, armor, tools, bows, fishing rods, and more. Every enchantment is defined in its own YAML config file, making it easy to tweak values, disable specific enchants, or create your own without touching any code.
How It Works
- Enchanting Table — Players can discover custom enchants naturally through the vanilla enchanting table, with configurable weights, costs, and level ranges.
- Action System — Each enchantment is powered by composable actions (damage bonuses, potion effects, explosions, teleports, area breaks, and more) that fire on configurable triggers like attacking, taking damage, mining, fishing, or sneaking.
- Level Scaling — Enchantment effects scale with level using linear or fixed scaling functions, so higher levels feel meaningfully stronger.
- Cooldowns & Chances — Built-in support for activation chances and cooldown timers to keep powerful enchants balanced.
- Protection Integration — All block-modifying enchants respect WorldGuard and other protection plugins out of the box.
Features
- 103 enchantments across all item types
- 50+ action types (damage, potion effects, lightning, explosions, teleportation, veinmine, timber, and more)
- 18 trigger types: melee, ranged, mining, fishing, sneaking, passive, and more
- Data-driven YAML configs, customize everything without code
- Enchanting table, anvil, and villager trading integration
- Loot table integration for dungeon/chest loot
- Per-enchant permissions for use and application
- Conflict system to prevent incompatible enchant combos
- GUI for browsing and applying enchants
- Enchanted book generation and distribution
Getting Started
| Command | Description |
|---|---|
/superenchant <enchant> <level> |
Apply an enchant to your held item |
/segui |
Open the enchant GUI for your held item |
/sebooks |
Browse all enchants and get enchanted books |
/segive <player> <enchant> <level> |
Give an enchanted book to a player |
/sereload |
Reload all enchant configs |
Permissions
| Permission | Description | Default |
|---|---|---|
superenchants.enchant |
Use /superenchant |
OP |
superenchants.gui |
Use /segui |
OP |
superenchants.books |
Use /sebooks |
OP |
superenchants.give |
Use /segive |
OP |
superenchants.reload |
Use /sereload |
OP |
superenchants.use.<id> |
Use a specific enchant | All |
superenchants.apply.<id> |
Apply a specific enchant via GUI | All |
superenchants.admin |
All admin permissions | OP |
Configuration
Each enchantment lives in plugins/SuperEnchants/enchants/<name>.yml. Drop in new files or edit existing ones, then /sereload to apply changes live. For the full list of enchantments, action types, triggers, configuration options, and advanced usage, see the Wiki.
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
|
R
3.1.9
|
1d ago | 1 | |||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 | ||||
| 1d ago | 1 |
- Feature:** Per-action
excludelist — any action can now declareexclude: [sneaking, sprinting, ...]to skip execution when the player is in that state. Supported states:sneaking,sprinting,swimming,flying,gliding. - Feature:** New
durabilityaction type — damages a configurable equipment slot's item by a scalable amount, respecting Unbreaking. - Feature (Excavator):** Multi-break and durability drain are now skipped when the player is sneaking.
- Bug fix:**
NoSuchFieldError: MAX_HEALTHon 1.21.1 servers — attribute lookups inPassiveListenerandHealthStealActionnow use the registry-based resolver that works across 1.21.1 and 1.21.2+. - Bug fix:** Permanent attribute effects (e.g. Lightweight speed boost persisting after removing the item) — attribute cleanup now runs correctly on servers that previously crashed at the
MAX_HEALTHfield reference. - Bug fix:** Attribute modifiers are now removed immediately when armor is changed, via a new
PlayerArmorChangeEventhandler, rather than waiting for the next passive tick.
- Fixed deflect always returning an arrow even if another projectile was thrown
- Removed piercing enchant (redundant)
- Added Janitor enchant
- Added Stalker enchant
- Added Quickstep enchant
- Added Eruption enchant
- Added
vacuum_dropsaction type for the Janitor enchant - Fixed grindstone not working on custom enchanted books (inputs now consumed, ENCHANTED_BOOK → BOOK result)
- Added
area_potion_effectaction type (radius-based potion effect around the player) - Balance pass — 22 enchants adjusted for SMP viability:**
- bleed: added 40% chance (+10%/lvl), 3s cooldown; reduced effect duration
- venom: added 40% chance (+10%/lvl), 3s cooldown; reduced effect duration
- freeze: added 4s cooldown; slowness capped at Slowness I; mining fatigue capped at Fatigue II; reduced durations
- frostbite: added 3s cooldown; capped at Slowness I; reduced duration
- blindness: added 25% chance (+10%/lvl), 6s cooldown; reduced duration
- confusion: added 25% chance (+10%/lvl), 5s cooldown; reduced duration
- critical: bonus damage reduced from 50% to 25%
- adrenaline: flat damage reduced (max 4 at L3, down from 9)
- lightning: cooldown increased from 3s to 6s
- bloodlust: all effect durations reduced (max ~7s at L3, down from ~14s)
- healthsteal: heal amount reduced (max 1.5 HP at L3, down from 2.5)
- vampiric: heal amount reduced (max 1.5 HP at L3, down from 2.5)
- backstabber: flat damage reduced; cooldown increased to 15s
- withering: capped at Wither I; reduced duration
- disarm: added 8s cooldown
- concussion: fixed chance bug (was always triggering); now 30% (+15%/lvl)
- growth: max health per level reduced (max +6 HP / 3 hearts at L5, down from +10 HP)
- overload: capped at Absorption I (2 hearts); reduced duration
- berserk: strength duration reduced
- fortify: capped at Resistance I; reduced duration
- martyrdom: explosion power reduced (max 1.5 at L3, down from 2.5)
- retaliation: reflect percentage reduced (max 40% at L3, down from 70%)
- Folia compatibility fixes:**
- AnvilListener: replaced deprecated Bukkit scheduler with entity scheduler
- TeleportAction, SwapPositionsAction: use teleportAsync for cross-region safety
- ShockwaveAction, GravityAction, MagnetAction, SetFireAction: entity mutations dispatched via entity scheduler
- TimberAction, VeinmineAction, MultiBreakAction: block breaks dispatched via region scheduler
- LavaWalkerAction: block conversions and reverts dispatched via region scheduler
- ExplosionAction, ExplodeProjectileAction, LightningAction: world effects dispatched via region scheduler
- CommandAction: console commands use globalRegionScheduler; player commands use entity scheduler
- Fixed anvil enchanting keeping the book
- LightningAction NPE:**
getTargetBlock(null, 100)could return null when looking at sky causing a crash - Cooldown consumed before execution:** Cooldown timestamp was recorded before actions ran. If an action threw an exception the cooldown was wasted.
- PROJECTILE_HIT reads wrong item:**
onProjectileHitreadshooter.inventory.itemInMainHandat hit time, which could be wrong if the player swapped weapons mid-flight.
### New Features
disabledflag:** Adddisabled: trueto any enchant YAML to fully disable it without deleting the file. Disabled enchants are skipped at load time.- Multi-trigger support:** Enchants can now fire on multiple triggers. Use
triggers: [ATTACK_ENTITY, RIGHT_CLICK](list) instead of a singletrigger:field. The old single-trigger format remains backward-compatible. lightningnow fires on bothATTACK_ENTITYandRIGHT_CLICKas its description stated.
### New Triggers (3)
SHIELD_BLOCK** — Fires when a player successfully blocks an attack with a shield. Checks the shield in the offhand and all armor slots.SPRINT** — Fires once when a player begins sprinting (PlayerToggleSprintEvent). Checks all equipment slots.CONSUME** — Fires when a player eats food or drinks a potion (PlayerItemConsumeEvent). Checks the consumed item and all armor slots.
### New Action Types (2)
send_title** — Displays a MiniMessage-formatted title, subtitle, or action bar message to the player. Configurable fade-in, stay, and fade-out times.swap_positions** — Teleports the player to the target's location and the target to the player's original location. Preserves each entity's yaw/pitch.
### New Item Group (1)
SHIELDS** —[SHIELD]. Use inapplicable_itemsfor shield enchantments.
### New Enchantments (6)
- Retaliation** (SHIELDS, SHIELD_BLOCK) — Reflects 50–80% of incoming damage back to the attacker while blocking.
- Fortress** (SHIELDS, SHIELD_BLOCK) — Grants absorption for 3s on successful block.
- Bounding** (BOOTS, SPRINT) — Grants jump boost when you start sprinting.
- Windrunner** (BOOTS, SPRINT) — Grants speed boost when you start sprinting.
- Nourished** (ARMOR, CONSUME) — Eating food triggers regeneration.
- Swapper** (MELEE, ATTACK_ENTITY) — Swaps positions with your target on hit.
- Fixed some duplication bugs regarding mobs
- Fixed enderaura not having an entity-type filter
- Fixed an error dump from respawn action on Folia
- Fixed
AutosmeltActionparticle spawning at block corner instead of block center - Fixed
ParticleSpawnerpotential NPE when world is null (unloaded chunk/world transition) - Fixed Folia/Canvas crash on
PlayerRespawnEvent(DeathListenernow usesplayer.scheduler.runDelayedinstead ofrunTaskLater) - Added 10-second HTTP timeout to update checker to prevent indefinite stalls
- Balanced
concussionproc chance (was 100%, now 45%/60%/75% per level) - Updated wiki
- Added Concussion enchantment
- Added Warlord enchantment
- Added Tempest enchantment
- Added Aquabound enchantment
### Enchant Compatibility
- Added MACE and TRIDENT support to: bleed, lightning, healthsteal, gravity, critical, venom, freeze, disarm, skullcrusher, doublestrike, weaken, withering, frostbite, backstabber, slaughter, bloodlust, inflame, adrenaline, confusion, blindness, predator
- Added MACE and TRIDENT support to: ignite, vampiric
- Added MACE support to: shockwave
### Item Groups
- Added MACES item group
- Added TRIDENTS item group
### Bug Fixes
- Fixed crash on minecraft versions without copper armor
- Fixed excavator levels 1–3 all mining the same area (scaling was broken; now 3×3×3 / 5×5×5 / 7×7×7)
- Fixed crash when using block-data particles (e.g. BLOCK_DUST on veinminer) with combined enchants
- Fixed veinminer and autosmelt not working together (vein blocks were not being smelted)
- Fixed excavator and veinminer not working together (ores exposed by excavator are now veinmined)
- Fixed excavator and autosmelt not working together (radius blocks were not being smelted)
- Fixed new enchants not appearing on existing servers after update
### Other
- Updated version checker to use Modrinth API instead of Pastebin
- Removed Hangar from update notification links
- Fixed harvester from working on non-mature crops
- Fixed dismantle breaking armor with abiding
- Fixed removing soulbound
- Added support for GravesX
- Added Folia support
- Added 3 new triggers: BLOCK_PLACE, RESPAWN, ITEM_SWAP
- Added 4 new action types: particle, sound, send_message, spawn_entity
- Added 3 new enchantments: Rebirth, Mason, Quick Draw
- Added sound and particle effects to 15 existing enchantments
- Added support for copper tools/armor
- Added Vampiric enchant
- Added Martyrdom enchant
- Adjusted harvester to balance out the game
- Fixed harvester to only duplicate plants
- Improved villager trading, each enchantment now modifies it
- Removed lore from enchantment books so the name doesn't look duplicated
- Added ability for enchantments to work in the off-hand
- Added pagination to /sebooks
- Fixed lavawalker from being buggy
- Allowed abiding to be applicable to any enchantable item
- Added a new enchantment "Stealth"
- Added a remove fall damage option to the velocity action
- Added ability to remove enchantments from the grindstone
- Added command action type
- Added timer actions
- Added a permission check for enchanting items using the enchanting table
- Added a permission check for enchanting items using an anvil
- Added a permission check for using the grindstone
- Fixed right click trigger actions on armor pieces (ascend)
- Fixed jetpack enchantment
- Fixed a critical error with bleed causing the server to crash when mixed with other enchantments
- Decreased default chance of villager trades/loot generation
- Fixed replacing trades from villagers to only replace existing enchantment trades
- Fixed villagers not gaining XP from custom enchant trades
- Fixed scaling functions so chance now works properly
- Updated the update message to reduce clutter
- Fixed the passive modifier to remove/add effects properly
- Fixed armor enchantments to only work when its worn, not held
- Complete plugin rewrite with significant performance improvements
- Enchantments are now fully data-driven, all enchantments are 100% customizable
- Updated to Minecraft 1.21.1
- Expanded configuration options
- Optimized enchantment tick frequency for better server performance
## New Enchantments
Autoreel, Soulbound, Lifeline, Anchor, Berserk, Entangle, Fortify, Ignite, Ironclad, Overload, Rejuvenation, Spiritlink, Venom, Tiller
## Removed
Multishoot (now a vanilla enchantment)
## Bug Fixes
- Fixed permission issues
- Fixed specific enchantment bugs
- Resolved all known null pointer exceptions and error dumps
## Developer
- Improved developer API
## Other
- Added WorldGuard/claim plugin protections
- Updated wiki with much needed changes
- fixed anvil compatibility with enchantments - now only proper items can get the proper enchantments
- fixed anvil enchanting levels
- fixed pressure plates activating some enchantments
- fixed multishoot not applying to crossbows
- fixed conflict between heavy vs lightweight
- fixed explosive not working well
- fixed explosive doing damage to self
- fixed enchantents not being in "stored_enchants", had caused some issues
- added much more flexibility to explosive in config.yml
- added a cap to the amount of blocks timber can break
- removed custom anvil
- updated plugin to 1.21.8
- Fixed bait duplicating items on the ground
- Fixed excavator breaking barrier blocks
- Fixed consume enchantment not working on armor
- Fixed tab complete not recommending enchantments
- Added customanvil into the plugin so you don't have to download it separately
- Fixed an issue related to wandering traders when opening their trading menu
- Added thanos enchantment
- Added consume enchantment
- Fixed emeralds not working with autosmelt + fortune
- Fixed coal not working with autosmelt + fortune
- Fixed redstone not working with autosmelt + fortune
- Fixed lapis not working with autosmelt + fortune
- Fixed diamond not working with autosmelt + fortune
- Fixed nether quartz not working with autosmelt + fortune
- Fixed skullcrusher translations not working for languages other than english
- Fixed ninja translations not working for languages other than english
- Added chinese translations
- Added more support for level 255 enchantments
- Removed unnecessary code to improve performance
- Added skullcrusher enchantment
- Added ninja enchantment
- Added villager trades that can be disabled in configuration
- Added multiple new configuration options
- Made custom enchantment books have a chance to appear in structures, can be disabled in config
- Added more configuration options
- Added predator enchantment
- Added slaughter enchantment
- Updated pirate translations a bit
- Added cubism enchantment
- Added vanish enchantment
- Added dodge enchantment
- Added ascend translations
- Added dragonhunter translations
- Added permission checking to spotlight enchant
- Added permission checking to farmer enchant