Superenchants

# 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 | | ---------------------------------- |------------------------------------------- | | <code>/superenchant &lt;enchant&gt; &lt;level&gt;</code> |Apply an enchant to your held item | | <code>/segui</code> |Open the enchant GUI for your held item | | <code>/sebooks</code> |Browse all enchants and get enchanted books | | <code>/segive &lt;player&gt; &lt;enchant&gt; &lt;level&gt;</code> |Give an enchanted book to a player | | <code>/sereload</code> |Reload all enchant configs | ## Permissions | Permission |Description |Default | | ------------------------ |-------------------------------- |------- | | <code>superenchants.enchant</code> |Use <code>/superenchant</code> |OP | | <code>superenchants.gui</code> |Use <code>/segui</code> |OP | | <code>superenchants.books</code> |Use <code>/sebooks</code> |OP | | <code>superenchants.give</code> |Use <code>/segive</code> |OP | | <code>superenchants.reload</code> |Use <code>/sereload</code> |OP | | <code>superenchants.use.&lt;id&gt;</code> |Use a specific enchant |All | | <code>superenchants.apply.&lt;id&gt;</code> |Apply a specific enchant via GUI |All | | <code>superenchants.admin</code> |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 **(https://superenchants.gitbook.io/superenchants-wiki)**.