Перейти к содержимому
Mineforgian

Superenchants

This plguin adds new enchants to your game, such as healthsteal, bleed, autosmelt, and more!

Загрузки
30K
Подписчики
121
Обновлён
7 мая 2026 г.
Лицензия
All-Rights-Reserved

Опубликован 2 августа 2023 г.

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.

Ченджлог

4.6.2Релиз26.1, 26.1.1, 26.1.2 · 7 мая 2026 г.
  • Feature: Per-action exclude list — any action can now declare exclude: [sneaking, sprinting, ...] to skip execution when the player is in that state. Supported states: sneaking, sprinting, swimming, flying, gliding.
  • Feature: New durability action 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_HEALTH on 1.21.1 servers — attribute lookups in PassiveListener and HealthStealAction now 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_HEALTH field reference.
  • Bug fix: Attribute modifiers are now removed immediately when armor is changed, via a new PlayerArmorChangeEvent handler, rather than waiting for the next passive tick.
4.6.1Релиз26.1, 26.1.1, 26.1.2 · 23 апреля 2026 г.
  • Fixed deflect always returning an arrow even if another projectile was thrown
4.6.0Релиз26.1, 26.1.1, 26.1.2 · 19 апреля 2026 г.

4.6.0

  • Removed piercing enchant (redundant)

  • Added Janitor enchant

  • Added Stalker enchant

  • Added Quickstep enchant

  • Added Eruption enchant

  • Added vacuum_drops action type for the Janitor enchant

  • Fixed grindstone not working on custom enchanted books (inputs now consumed, ENCHANTED_BOOK → BOOK result)

  • Added area_potion_effect action 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
4.5.1Релиз1.21.9, 1.21.10, 1.21.11 · 10 апреля 2026 г.
  • Fixed anvil enchanting keeping the book
4.5.0Релиз1.21.9, 1.21.10, 1.21.11 · 10 апреля 2026 г.

Bug Fixes

  • 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: onProjectileHit read shooter.inventory.itemInMainHand at hit time, which could be wrong if the player swapped weapons mid-flight.

New Features

  • disabled flag: Add disabled: true to 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 single trigger: field. The old single-trigger format remains backward-compatible.
    • lightning now fires on both ATTACK_ENTITY and RIGHT_CLICK as 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 in applicable_items for 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.
4.4.2Релиз1.21.9, 1.21.10, 1.21.11 · 9 апреля 2026 г.
  • Fixed some duplication bugs regarding mobs
  • Fixed enderaura not having an entity-type filter
4.4.1Релиз1.21.9, 1.21.10, 1.21.11 · 6 апреля 2026 г.
  • Fixed an error dump from respawn action on Folia
  • Fixed AutosmeltAction particle spawning at block corner instead of block center
  • Fixed ParticleSpawner potential NPE when world is null (unloaded chunk/world transition)
  • Fixed Folia/Canvas crash on PlayerRespawnEvent (DeathListener now uses player.scheduler.runDelayed instead of runTaskLater)
  • Added 10-second HTTP timeout to update checker to prevent indefinite stalls
  • Balanced concussion proc chance (was 100%, now 45%/60%/75% per level)
  • Updated wiki
4.4.0Релиз1.21.9, 1.21.10, 1.21.11 · 25 марта 2026 г.

New Enchantments

  • 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

Комментарии

Загружаем…