Forbidden Enchants (Paper 1.21.x)

Forbidden Enchants is a Paper plugin for 1.21.x that adds 69 custom enchants, curses, spell books, and utility effects designed to push survival further than vanilla normally allows. Some are strong, some are disruptive, and some are deliberately unfair, but all of them are meant to create unusual situations, higher-stakes progression, and more server variety.

This is not just a pack of extra enchants. It also includes a full set of in-game admin tools for controlling how those enchants are distributed and balanced. With /fe gui, /fe injector gui, /fe bundle gui, /fe librarian gui, and /fe toggles, you can manage item access, loot injection, bundle drops, villager trades, and per-enchant runtime settings directly in-game without constantly editing config files or restarting the server.

If you want a plugin that can make an SMP less predictable while still giving admins direct control over how chaotic it gets, Forbidden Enchants is built for that.

Features

• Fancy /fe admin command with help/list output and colored feedback.
• /fe gui paged creative style inventory menu sorted by enchant type, with quick category filters.
• /fe injector command suite for structure/vault injection setup (help, status|list, enable, disable, add, set|chance, remove, clear, defaultchance|default, vault, gui|menu).
• /fe injector gui visual editor for injector structure lists and per-structure chance tuning.
• /fe bundle command suite for mob bundle-drop setup (help, status, enable, disable, chance, gui|menu, clear).
• /fe bundle gui visual editor for reward content (enchants, spell potions, general loot), per-mob drop chances, bundle capacity tracking, and extra non-stackable drops.
• /fe librarian command suite for librarian trade blend setup (help, status|list, enable, disable, add, remove, clear, gui|menu).
• /fe librarian gui visual editor with all-book + configured views, per-book chance, and cost tuning.
• Librarian blend mode keeps vanilla/datapack trade generation and appends configured forbidden-book offers by per-trade chance.
• /fe toggles GUI for per-enchant enable/disable controls (usage and chest/vault spawning), with aliases settings and enchanttoggles.
• Generate both enchant books and pre-enchanted gear items directly.
• Anvil application flow for helmets, chestplates, and boots.
• 69 custom enchants with level support where configured.
• Loot-table compatible book detection via custom_model_data.
• Loot-table compatible gear detection via custom_model_data fallback.
• Helmet-only balancing rules for the vision enchants.
• Mystery book/item generation with obfuscated text (/fe mysterybook, /fe mysteryitem).
• Mystery gear reveals its real enchant when equipped/used.
• Optional structure loot injector (config + command + GUI editor) for random forbidden books in selected structures.

Loot Integration Paths

You can add Forbidden Enchants to world loot in two different ways:

1. Datapack/resourcepack-style loot table editing
   Use your own loot table JSONs (or the provided example) to explicitly place specific forbidden books/items in specific tables with your own fixed rules.

2. In-game injector system (/fe injector or /fe injector gui)
   Use plugin-side runtime injection to add random forbidden books into selected structures and trial vault rewards with configurable chances, without manually editing loot table files.

Use loot table editing when you want exact, deterministic entries.
Use injector when you want fast setup and configurable randomization from in-game commands/GUI.

5 Main GUI Menus

This plugin has five main admin GUIs, each for a different workflow:

1. /fe gui (Creative-style admin picker)

   • Purpose: manually give forbidden books/items to players for admin distribution, balancing checks, and testing.
   • Layout: one enchant type per page (book first, then compatible pre-enchanted items).
   • Controls: click item to claim; left/right page arrows (left-click = 1 page, right-click = 5 pages).
   • Bottom-row category buttons: Armors, Weapons, Totems, Books, Potions, Other, and Return (back to default all-enchants view).

   

2. /fe injector gui (Structure/vault loot injector editor)

   • Purpose: configure runtime loot injection so forbidden books/items appear in structure chests and trial vault rewards.
   • Supports all structures and configured-only view modes.
   • Includes an Enchantment Rarity Editor button to tune weighted rarity for each enchantment level.
   • Rarity editor includes a back button and an Apply Weights To Enchanted Items toggle (default: ON).
   • Rarity editor controls:
     • Left/Right: +/-0.1 weight (Shift: +/-1.0)
     • Q/Ctrl+Q: multiply weight by x2 / x0.5
     • Middle: reset weight to 1.0
     • Double-click: set weight to 0.0 (disabled)
     • F: toggle per-enchant spawn_enabled directly from the rarity editor
   • Per-entry controls:
     • Left/Right clicks: increase/decrease chance
     • Q: cycle loot type (books -> items -> all)
     • Ctrl+Q: cycle curse state (all -> cursed -> uncursed)
     • F: cycle mystery state (all -> mystery_only -> non_mystery_only)
   • Includes global enable toggle, notify toggle, clear-all, and normal/ominous vault entries.

   

3. /fe librarian gui (Librarian trade blend editor)

   • Purpose: configure forbidden books to be added into librarian trades while keeping vanilla/datapack trade generation.
   • Supports all-books and configured-only view modes.
   • Per-book controls:
     • Left/Right clicks: increase/decrease trade chance
     • Q/Ctrl+Q: increase/decrease emerald cost
     • F: increase required book cost
     • Middle click: disable/remove that configured trade

   

4. /fe toggles (Per-enchant runtime/spawn controls)

   • Purpose: toggle each enchant's runtime usage and injector spawn state without editing config files manually.
   • Shows all enchant families, including potion enchants and utility books (not only standard enchanted-book entries).
   • Per-entry controls:
     • Left-click: toggle use_enabled
     • Right-click: toggle spawn_enabled
     • Middle-click: toggle both together

   

5. /fe bundle gui (Mob bundle-drop editor)

   • Purpose: configure a bundle that mobs can drop, including exact contents and per-mob drop chances.
   • Reward sources:
     • Forbidden enchant books
     • Spell potion items
     • General loot items (diamonds/netherite/gold/etc.)
   • Also supports a separate extra-drop category for non-stackable items dropped alongside the bundle.
   • Bundle behavior respects bundle capacity limits and shows a live used/64 counter in the root editor.
   • Root controls:
     • Enable/disable bundle drops
     • Adjust default chance used when quickly enabling mobs
     • Select mobs and tune chance per mob
     • Edit enchant/potion/loot reward lists
     • Import general loot directly by shift-click/drag from your player inventory while in the loot editor
     • View/adjust configured bundle rewards (including count increments)
     • Configure extra non-stackable drops

   

Commands

/fe help
/fe list
/fe gui [player]
/fe menu [player]
/fe give <enchant> <level> [player]
/fe givebook <enchant> <level> [player]
/fe giveitem <enchant> <level> <material> [player]
/fe mysterybook <slot> [player]
/fe mysteryitem <material> [player]
/fe injector <...>
/fe structureinjector <...>
/fe bundle <...>
/fe bundledrop <...>
/fe librarian <...>
/fe librariantrades <...>
/fe libtrades <...>
/fe toggles [player]
/fe settings [player]
/fe enchanttoggles [player]

Enchants

Enchant	Item Slot	Levels	Effect
Divine Vision	Helmet	I-IV	Applies glow to nearby players/mobs through walls. Range: 10/20/30/50 blocks. Level IV also grants permanent night vision while worn. Travel wear: every 100 blocks traveled deals 10% durability damage.
Miners Intuition	Helmet	I-IV	Tracks nearest matching ore by helmet material (see mapping below). Range: 10/20/30/50. Level IV also grants permanent night vision while worn. Travel wear: every 100 blocks traveled deals 10% durability damage (reduced to 2% at IV).
Loot Sense	Helmet	I-III	Tracks nearest chest, barrel, or shulker. Range: 20/30/50. Travel wear: every 100 blocks traveled deals 10% durability damage.
Extended Grasp	Chestplate	I	Sets block/entity interaction reach to 6 blocks.
Void Grasp	Chestplate	I	6 block reach plus through-wall interactions (containers/buttons/etc.) and through-wall attack tracing.
Masquerade	Boots	I	Sneak to disguise as nearest mob; cannot attack while disguised. Travel wear: every 100 blocks traveled deals 10% durability damage.
Ascension	Boots	I	Airborne upward boost while jumping; intentionally heavy durability drain.
Incite Fear	Sword	I-II	On hit, nearby mobs have a 25%/50% chance to flee from you.
Blindness	Sword	I	On player hit, 33% chance to blind for a random 1.0-5.0 seconds.
Miasma	Bow/Crossbow	I	On arrow impact: smoke burst, close-range invisibility, nearby blindness, explosion sound pulse.
Charm	Bow/Crossbow	I-IV	Hit mobs become temporary allies that protect/follow you. If shot at a player and no mobs are nearby, hostile allies are spawned to attack for you. Duration/ally cap: 15s/1, 30s/2, 60s/3, permanent/4. Charmed mobs emit hearts while active, no longer target each other, and each successful charm proc costs 10% weapon durability. Warden charm clears nearby Darkness.
Miasma Form	Chestplate	I	Sneak to enter smoke form: hides gear visuals, phases through 1-block walls (costs 2 damage), cannot attack/interact, immune to non-fire damage, ignored by mobs except blazes.
Aquatic Sacrifice	Helmet (Binding Curse)	I	Underwater breathing/speed/mining buffs and +2 damage underwater; outside water you slowly take drowning-style damage.
The Hated One	Helmet (Binding Curse)	I-II	I: reduced aggro/loot pressure. II: full aggro pressure (including illusioners in raider waves), and much higher loot/equipment drops.
Withering Strike	Trident	I	Thrown-trident hits apply withering that ticks every 3 seconds until cured.
Healing Touch	Hoe	I	Hits heal instead of harm, cure wither, and grant golden-apple-like regen/absorption; user takes 1 heart self-damage. Undead take double damage, wither skeletons convert to normal skeletons, and zombie villagers can be cured. Starts at full durability but degrades quickly; no Mending/Unbreaking.
Full Pockets	Leggings	I-IV	On first open of a world container, adds bonus rare loot with a 10% * level chance (max 40%). Also pulls XP orbs within 30 blocks toward you.
Dragons Breath	Crossbow	I-II	Arrow impact spawns a dragon-breath cloud that damages all players and mobs in the core zone for 5s (I) or 15s (II), including the shooter.
Explosive Reaction	Crossbow	I	Arrow impact causes smoke with a reduced TNT-style explosion.
The Unyielding	Chestplate	I	Prevents pushback from damage, explosions, wind bursts, and flowing-water push. Compatible with other chest enchants.
Forbidden Agility	Boots	I-IV	Increases movement speed by 0.006 * level; compatible with other boot enchants.
Pocket Dimension	Leggings	I	At 5% health or lower, teleports you ~50 blocks to a safe location and then breaks the leggings.
Petty Thief	Hoe	I	1/10 chance on PvP hit to steal a random inventory item. On mob hit, 1/10 chance to grant a themed drop item.
Lumberjack	Axe	I	Breaking the bottom log fells the connected tree (logs + leaves) and applies durability equal to 50% of the full block break cost.
Sonic Panic	Sword	I	At 50% health or lower, triggers a warden-strength radial sonic blast and shatters the sword.
Creepers Influence	Helmet	I	Nearby creepers prioritize exploding other mobs; if no other mobs are nearby they self-detonate.
Staff Of The Evoker	Spear	I	Spear jabs and left-click casts send a longer forward line of evoker fangs, even out of melee range, and the fangs damage mobs.
Vexatious	Helmet	I-III	Maintains 1/2/3 bound vex allies. Extra vexes require pristine helmet durability.
Wololo	Helmet (Binding Curse)	I	Sheep within 3 blocks recolor once; each conversion costs you 1 heart.
Locked Out	Boots (Binding Curse)	I	Blocks interaction with doors/buttons/switches/portals; Nether portal use breaks the portal block, End portal use is denied.
Evokers Revenge	Chestplate (Binding Curse)	I	Random evokers spawn near you every few minutes; each evoker you kill increases future spawn count.
The Seeker	Helmet	I	Shows only the player you are most lined up with (about a 20 degree FOV): PlayerName 125m. If no one is in view alignment, nothing is shown. Helmet loses 10% durability per 100 blocks traveled. Mending/Unbreaking are blocked/stripped.
Disarm	Axe	I	1/20 chance to force main-hand drop from players/mobs; unarmed mobs are feared for 3 seconds.
Marked	Bow/Crossbow	I	Hit players glow for 30 seconds; your subsequent damage to that marked player is increased by 25%.
Greed	Leggings (Binding Curse)	I	Vacuums nearby item entities and XP (30 blocks), but prevents dropping items.
Wing Clipper	Sword	I	On player hit, blocks Elytra equip for 10 seconds; if Elytra is worn it is instantly broken to 1 durability.
Launch	Elytra	I	Grounded double jump gives a rocket-like launch boost and consumes 5% Elytra durability.
Full Force	Mace	I	Grounded mace hits deal 10 damage and launch targets about 8 blocks with a smash impact (sound + particles).
Temporal Sickness	Any Armor (Binding Curse)	I-III	I: every 30s teleports to the next available dimension using safe-surface placement rules. II: every 5-30s teleports to border-safe random positions within 10,000 blocks per destination dimension. III: every 10-30s does level-II style warp and deals 1 heart damage. Curse breaks by killing 10/20/30 mobs at levels I/II/III, which breaks the enchanted armor piece.
Grave Robber	Compass	I-IV	Compass points to the nearest recorded player death location within 1000/2500/5000/10000 blocks for levels I/II/III/IV. Action bar shows obfuscated coordinate text that reveals more digits as you get closer.
Pocket Seeker	Compass	I-IV	Compass points to the nearest living player within 1000/2500/5000/10000 blocks for levels I/II/III/IV. If none are in range it random-spins, and action bar uses obfuscated coordinate text that reveals more digits as you get closer.
Charmed Pet	Name Tag	I	Name-tagged mobs become passive pets that follow the tagger; right-click toggles sit/stay.
Applied Curse	Name Tag	I-III	Name-tagging another player renames them for chat + display: 30m (I), 1h (II), until death (III).
Get Over Here!	Lead	I	Allows enchanted leads to leash villagers (must sneak/right-click villager).
Mujahideen	Totem of Undying	I	On totem pop, detonates roughly 2x TNT force at your death spot with a miasma-like smoke blast, then teleports you ~50 blocks to a safe location.
Knockback	Shield	I	Blocking a melee hit knocks the attacker back with strong force (roughly Knockback II feel).
Ricochet	Shield	I	While blocking: 55% chance to reflect arrows, 100% reflect vs ghast and shulker projectiles.
Shockwave	Totem of Undying	I	On totem pop, emits a shockwave that pushes nearby mobs/players back and deals 3 hearts.
Proud Warrior	Chestplate (Binding Curse)	I	On first hit from mob/player, detonates roughly 2x TNT force, leaves wearer at 1 HP, and breaks the chestplate.
Sisko's Solution	Chestplate (Binding Curse)	I	Near 3+ villagers, black smoke spreads villager-to-villager, applies wither damage in the cloud, and summons wither skeletons that ignore the wearer until all linked villagers die.
No Fall	Boots	I	Negates all fall damage. If the fall would have killed you, consume 25% boot durability instead. Incompatible with Feather Falling, Mending, and Unbreaking.
Borg Technology	Chestplate	I	Adapts on repeated hits: after 3 matching hits, gains a barrier against that attack profile until 337 blocks of movement are traveled.
Warp 9.5	Boots	I	On bedrock, grants extreme speed, degrades over travel distance, and breaks after about 3333 blocks of warp travel.
Tracker	Sword	I	On hit, target leaves a breadcrumb particle trail (up to 30 blocks) for 1 minute. Re-hits do not extend time.
The Pretender	Totem of Undying	I	On totem pop, fakes death (loot drop + death message), then gives 30s silent invisibility/regeneration while hostile mobs ignore you.
Out Of Phase	Potion (spell)	I	Crafted by combining a water bottle + Out Of Phase book in an anvil. Drink for 1 minute phasing through entities and 1-block walls.
Silence	Potion (spell)	I	Crafted by combining a water bottle + Silence book in an anvil. Drink to silence nearby players for 15s (potions/pearls/totems/enchanting blocked).
Quitter	Potion (spell)	I	Crafted by combining a water bottle + Quitter book in an anvil. Drink to fake-leave for 30s and return automatically.
Infected	Potion (spell)	I	Crafted by combining a water bottle + Infected book in an anvil. Drink to zombify nearby mobs/villagers for 30s, then revert.
The Duplicator	Utility Book	I	Anvil utility: duplicates the left-slot item stack. Rejects non-empty shulker boxes and non-empty bundles. Book is consumed.
The Philosophers Book	Utility Book	I-III	I: iron -> gold, II: gold -> diamond, III: diamond -> netherite (ingot/block equivalents, same amount). Book is consumed.
Joint Sleep	Potion (spell)	I	Crafted by combining a water bottle + Joint Sleep book in an anvil. Warps to nearest other-player bed; if none, places 2 beds ahead or gives beds.
Illusioners Revenge	Chestplate (Binding Curse)	I	Random illusioners spawn near you every few minutes; each illusioner you kill increases future spawn count.
Instant Death	Trident	I	Thrown trident direct hits are guaranteed lethal, force-drop the victim's totems, and bypass totem resurrection for direct-hit victims. The trident explodes on impact (hit or miss) with about 5x TNT force, then disappears.
Limitless Vision	Potion (spell)	I	Crafted by combining a water bottle + Limitless Vision book in an anvil. Grants permanent night vision and Divine-style line-of-sight glow at 50 blocks until death.
One Plus	Potion (spell)	I-IV	Crafted by combining a water bottle + One Plus book in an anvil. Temporarily adds +1 enchant level to worn/held gear for 1/5/10/30 minutes.
Temporal Displacement	Potion (spell)	I-III	Crafted by combining a water bottle + Temporal Displacement book in an anvil. Slows all players/mobs within 20 blocks to very low speed for 10s/30s/60s (caster unaffected).
Kismet	Pickaxe/Shovel/Axe (Binding Curse)	I	On first block break with that tool, fate locks forever at 50/50: either all valid broken blocks drop double, or all valid broken blocks drop nothing. Works with Silk Touch rules; duplicated shulker-box drops are always emptied.
Administrative Aspirations	Sword	I-II	On player hit: I instantly kicks target player (25% sword durability cost), II bans for 5 minutes with message Banned by Administrative Aspirations Sword for 5 Minutes then kicks (50% sword durability cost). On mob hit: teleports mob to world spawn, announces it to attacker, and costs 2% sword durability. Incompatible with Mending and Unbreaking.

Need More Information?

Check the GitHub!