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.

Requirements

• Paper 1.21.x (built for modern 1.21 API; target use-case is 1.21.11).
• Java 21+ runtime for the server.
• Gradle 8.10+ (wrapper included; only needed to build from source).

Build

./gradlew build -x test

Output jar:

• build/libs/forbidden-enchants-1.0.0.jar

Install

1. Build or use the packaged jar from build/libs/.
2. Drop jar into your server plugins/ folder.
3. Restart server (or use a full plugin reload strategy you trust).

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

   

Config + injector notes:

• Supports comma-separated structure lists for add and remove.
• Structure keys can be short (trial_chambers) or full namespaced (minecraft:trial_chambers).
• Config persistence:
  • structure_injector.* stores injector enable/chance/structure settings.
  • structure_injector.book_rarity.* stores per-book-level rarity weights for injector book rolls.
  • structure_injector.rarity_apply_to_items toggles whether rarity weights apply to books only (false) or books + enchanted items (true).
  • enchant_controls.* stores per-enchant use_enabled + spawn_enabled toggles.
  • spawn_enabled can be toggled from /fe toggles and from the injector rarity editor (F on an entry).
  • librarian_trades.* stores librarian trade enable state + configured offers (chance + costs).
  • bundle_drop.* stores mob bundle-drop enabled state, default chance, per-mob chances, rewards, and extra drops.
  • messages.yml stores configurable user-facing text used by menus/action bars/help output.
• Defaults:
  • Structure injector default chance: 5.0%.
  • Trial vault default chance fallback: 7.5% for normal and ominous when config values are missing.
  • Injector rarity toggle default: true (weights apply to both books and enchanted items).

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 reload
/fe injector <...>
/fe structureinjector <...>
/fe bundle <...>
/fe bundledrop <...>
/fe librarian <...>
/fe librariantrades <...>
/fe libtrades <...>
/fe toggles [player]
/fe settings [player]
/fe enchanttoggles [player]

Permission: forbiddenenchants.admin (default: op).

Injector subcommands:

/fe injector help
/fe injector status
/fe injector list
/fe injector enable
/fe injector disable
/fe injector gui [player]
/fe injector menu [player]
/fe injector add <structure[,structure2...]> [chance]
/fe injector set <structure> <chance>
/fe injector chance <structure> <chance>
/fe injector mode <structure> <book_only|uncursed_book_only|cursed_book_only|mystery_book_only|cursed_item_only|item_only|uncursed_item_only|mystery_item_only|cursed_only|uncursed_only|mystery_only|all|cycle|cycletype|cyclecurse|cyclemystery|status>
/fe injector mode <structure> <books|items|all> <all|cursed|uncursed> [all|mystery|non_mystery]
/fe injector mystery <structure> <on|off|toggle|status>
/fe injector notify <on|off|toggle|status>
/fe injector remove <structure[,structure2...]>
/fe injector clear
/fe injector defaultchance <chance>
/fe injector default <chance>
/fe injector vault <status|enable|disable|normal|ominous|both> [chance]

Librarian subcommands:

/fe librarian help
/fe librarian status
/fe librarian list
/fe librarian enable
/fe librarian disable
/fe librarian gui [player]
/fe librarian menu [player]
/fe librarian add <enchant> <level> <chance> <emeralds> [books]
/fe librarian remove <index>
/fe librarian clear

Bundle subcommands:

/fe bundle help
/fe bundle status
/fe bundle enable
/fe bundle disable
/fe bundle chance <0-100>
/fe bundle gui [player]
/fe bundle menu [player]
/fe bundle clear

Examples:

/fe list
/fe gui
/fe gui SomePlayer
/fe give divine_vision 3
/fe givebook loot_sense 2 SomePlayer
/fe giveitem divine_vision 3 diamond_helmet SomePlayer
/fe giveitem void_grasp 1 netherite_chestplate
/fe giveitem incite_fear 2 netherite_sword SomePlayer
/fe give miners_intuition 2 SomePlayer
/fe give loot_sense 1
/fe give extended_grasp 1
/fe give void_grasp 1
/fe give masquerade 1
/fe give ascension 1
/fe give incite_fear 2
/fe mysterybook chestplate
/fe mysteryitem trident SomePlayer
/fe injector status
/fe injector enable
/fe injector add trial_chambers,ancient_city 15
/fe injector set minecraft:ancient_city 22.5
/fe injector mode minecraft:ancient_city cursed_book_only
/fe injector mystery minecraft:ancient_city toggle
/fe injector notify toggle
/fe injector remove trial_chambers
/fe injector clear
/fe injector defaultchance 7.5
/fe injector vault status
/fe injector vault enable
/fe injector vault disable
/fe injector vault normal 10
/fe injector vault ominous 20
/fe injector vault both 15
/fe injector gui
/fe bundle status
/fe bundle enable
/fe bundle chance 12.5
/fe bundle gui
/fe librarian status
/fe librarian enable
/fe librarian add divine_vision 1 25 24 1
/fe librarian add void_grasp 1 15 32 2
/fe librarian gui
/fe librarian remove 2
/fe toggles

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.

What Can / Can't Be Applied

Item	Can apply	Can't apply / behavior notes
Helmets	Vision set: Divine Vision or Miners Intuition or Loot Sense or Aquatic Sacrifice or The Hated One; plus Creepers Influence / Vexatious / Wololo / The Seeker	Vision-set enchants are mutually exclusive with each other. Wololo applies Binding Curse automatically. The Seeker blocks Mending/Unbreaking.
Chestplates	Extended Grasp or Void Grasp or Miasma Form, plus The Unyielding and/or Evokers Revenge and/or Illusioners Revenge; also Proud Warrior, Sisko's Solution, Borg Technology	Grasp/Miasma Form are mutually exclusive. Evokers Revenge, Illusioners Revenge, Proud Warrior, and Sisko's Solution apply Binding Curse automatically. Proud Warrior / Sisko's Solution / Borg Technology must be solo enchants on the item.
Leggings	Full Pockets, Pocket Dimension	Can coexist on the same leggings.
Boots	Masquerade or Ascension, plus Forbidden Agility and/or Locked Out; also Warp 9.5 and No Fall	Masquerade/Ascension are mutually exclusive. Locked Out applies Binding Curse automatically. Warp 9.5 must be a solo enchant on the item. No Fall is incompatible with Feather Falling, Mending, and Unbreaking.
Swords	Incite Fear, Blindness, Administrative Aspirations, Sonic Panic, Tracker	Administrative Aspirations blocks/strips Mending and Unbreaking.
Bow/Crossbow	Miasma or Charm or Dragons Breath or Explosive Reaction	Mutually exclusive with each other. Miasma is additionally incompatible with Power, Punch, Flame, Infinity, Multishot, Quick Charge, Piercing. Dragons Breath and Explosive Reaction are now incompatible with any other enchant (vanilla or custom).
Tridents/Spears	Withering Strike, Instant Death, Staff Of The Evoker	Withering Strike and Instant Death apply to tridents only and trigger on thrown-trident hits. Both are solo trident enchants (cannot combine with other enchants on that trident). Staff Of The Evoker expects spear-type materials if available; trident fallback is used on non-1.21.11/no-spear-material setups and applies on melee and left-click cast.
Elytra	Launch	Enables double-jump launch while grounded and drains 5% durability per launch.
Maces	Full Force	Grounded hits deal 10 damage and launch targets about 8 blocks with smash impact effects.
Hoes	Healing Touch or Petty Thief	Healing Touch and Petty Thief are mutually exclusive. Healing Touch blocks/strips Mending and Unbreaking.
Axes/Pickaxes/Shovels	Lumberjack (axes), Kismet (all three)	Lumberjack triggers when the bottom log is broken. Kismet is a binding-curse fate enchant and applies to axes/pickaxes/shovels; duplicated shulker drops are emptied.
Compasses	Grave Robber or Pocket Seeker	Grave Robber and Pocket Seeker are mutually exclusive.
Name Tags	Charmed Pet or Applied Curse	Charmed Pet and Applied Curse are mutually exclusive.
Leads	Get Over Here!	Allows enchanted leads to leash villagers (must sneak-right-click).
Shields	Knockback, Ricochet	Can coexist on one shield.
Totem Of Undying	Shockwave, Mujahideen, The Pretender	Triggers when the enchanted totem is consumed.
Potions (Water Bottles in anvil)	Out Of Phase or Silence or Quitter or Infected or Joint Sleep or Limitless Vision or One Plus or Temporal Displacement	Spell potions are mutually exclusive with each other and crafted via water bottle + matching enchanted book.
Wrong slot items	None	Anvil/book and giveitem validation prevent wrong-slot application.

Per-Enchant Compatibility Matrix

Enchant	Can combine with	Cannot combine with
Divine Vision	None (helmet stays single-forbidden-enchant)	Miners Intuition, Loot Sense, Aquatic Sacrifice, The Hated One
Miners Intuition	None (helmet stays single-forbidden-enchant)	Divine Vision, Loot Sense, Aquatic Sacrifice, The Hated One
Loot Sense	None (helmet stays single-forbidden-enchant)	Divine Vision, Miners Intuition, Aquatic Sacrifice, The Hated One
Aquatic Sacrifice	None (helmet stays single-forbidden-enchant)	Divine Vision, Miners Intuition, Loot Sense, The Hated One
The Hated One	None (helmet stays single-forbidden-enchant)	Divine Vision, Miners Intuition, Loot Sense, Aquatic Sacrifice
Extended Grasp	The Unyielding	Void Grasp, Miasma Form
Void Grasp	The Unyielding	Extended Grasp, Miasma Form
Miasma Form	The Unyielding	Extended Grasp, Void Grasp
The Unyielding	Extended Grasp or Void Grasp or Miasma Form	None (custom-enchant conflict-wise)
Masquerade	Forbidden Agility	Ascension
Ascension	Forbidden Agility	Masquerade
Forbidden Agility	Masquerade or Ascension	None
Incite Fear	Blindness	None
Blindness	Incite Fear	None
Administrative Aspirations	Incite Fear, Blindness, Sonic Panic, Tracker, Wing Clipper	Mending, Unbreaking
Miasma	None of other ranged forbidden enchants	Charm, Dragons Breath, Explosive Reaction; plus vanilla Power, Punch, Flame, Infinity, Multishot, Quick Charge, Piercing
Charm	None of other ranged forbidden enchants	Miasma, Dragons Breath, Explosive Reaction
Dragons Breath	None (must be sole enchant on the crossbow)	Miasma, Charm, Explosive Reaction, and any other vanilla/custom enchant
Explosive Reaction	None (must be sole enchant on the crossbow)	Miasma, Charm, Dragons Breath, and any other vanilla/custom enchant
Withering Strike	None (must be sole enchant on the trident)	Instant Death and any other vanilla/custom enchant
Healing Touch	None (single hoe custom enchant in current set)	Mending, Unbreaking
Full Pockets	None (single leggings custom enchant in current set)	None (custom-enchant conflict-wise)
Pocket Dimension	Full Pockets	None (custom-enchant conflict-wise)
Petty Thief	None (single hoe custom enchant in current set)	Healing Touch
Lumberjack	None (single axe custom enchant in current set)	None (custom-enchant conflict-wise)
Kismet	None (single tool-fate enchant in current set)	Any other vanilla/custom enchant on the same tool
Sonic Panic	Incite Fear, Blindness	None (custom-enchant conflict-wise)
Tracker	Incite Fear, Blindness, Sonic Panic, Wing Clipper	None (custom-enchant conflict-wise)
Creepers Influence	Most other helmet enchants except helmet-exclusives below	None (custom-enchant conflict-wise)
Staff Of The Evoker	None (single spear custom enchant in current set)	None (custom-enchant conflict-wise)
Vexatious	Most other helmet enchants except helmet-exclusives below	None (custom-enchant conflict-wise)
Wololo	Most other helmet enchants except helmet-exclusives below	None (custom-enchant conflict-wise)
Locked Out	Masquerade or Ascension, Forbidden Agility	None (custom-enchant conflict-wise)
Evokers Revenge	The Unyielding, and one of Extended Grasp/Void Grasp/Miasma Form	None (custom-enchant conflict-wise)
Illusioners Revenge	The Unyielding, and one of Extended Grasp/Void Grasp/Miasma Form	None (custom-enchant conflict-wise)
The Seeker	Most other helmet enchants except helmet-exclusives below	Mending, Unbreaking
Disarm	Lumberjack	None (custom-enchant conflict-wise)
Marked	Miasma or Charm (unless blocked by other ranged exclusivity)	Dragons Breath, Explosive Reaction (by ranged exclusivity)
Greed	Full Pockets, Pocket Dimension	None (custom-enchant conflict-wise)
Wing Clipper	Incite Fear, Blindness, Sonic Panic	None (custom-enchant conflict-wise)
Launch	None (single Elytra custom enchant in current set)	None (custom-enchant conflict-wise)
Full Force	None (single mace custom enchant in current set)	None (custom-enchant conflict-wise)
Temporal Sickness	None (single armor custom enchant in current set)	None (custom-enchant conflict-wise)
Grave Robber	None (single compass custom enchant in current set)	Pocket Seeker
Pocket Seeker	None (single compass custom enchant in current set)	Grave Robber
Charmed Pet	None (single name-tag custom enchant in current set)	Applied Curse
Applied Curse	None (single name-tag custom enchant in current set)	Charmed Pet
Get Over Here!	None (single lead custom enchant in current set)	None (custom-enchant conflict-wise)
Mujahideen	Shockwave	None (custom-enchant conflict-wise)
Knockback	Ricochet	None (custom-enchant conflict-wise)
Ricochet	Knockback	None (custom-enchant conflict-wise)
Shockwave	Mujahideen	None (custom-enchant conflict-wise)
The Pretender	Shockwave, Mujahideen	None (custom-enchant conflict-wise)
Proud Warrior	None (must be sole enchant on the chestplate)	Any other vanilla/custom enchant
Sisko's Solution	None (must be sole enchant on the chestplate)	Any other vanilla/custom enchant
No Fall	Masquerade or Ascension, Forbidden Agility, Locked Out, Warp 9.5	Feather Falling, Mending, Unbreaking
Borg Technology	None (must be sole enchant on the chestplate)	Any other vanilla/custom enchant
Warp 9.5	None (must be sole enchant on the boots)	Any other vanilla/custom enchant
Instant Death	None (must be sole enchant on the trident)	Withering Strike and any other vanilla/custom enchant
Out Of Phase	None (single spell potion enchant)	Silence, Quitter, Infected, Joint Sleep, Limitless Vision, One Plus, Temporal Displacement
Silence	None (single spell potion enchant)	Out Of Phase, Quitter, Infected, Joint Sleep, Limitless Vision, One Plus, Temporal Displacement
Quitter	None (single spell potion enchant)	Out Of Phase, Silence, Infected, Joint Sleep, Limitless Vision, One Plus, Temporal Displacement
Infected	None (single spell potion enchant)	Out Of Phase, Silence, Quitter, Joint Sleep, Limitless Vision, One Plus, Temporal Displacement
Joint Sleep	None (single spell potion enchant)	Out Of Phase, Silence, Quitter, Infected, Limitless Vision, One Plus, Temporal Displacement
Limitless Vision	None (single spell potion enchant)	Out Of Phase, Silence, Quitter, Infected, Joint Sleep, One Plus, Temporal Displacement
One Plus	None (single spell potion enchant)	Out Of Phase, Silence, Quitter, Infected, Joint Sleep, Limitless Vision, Temporal Displacement
Temporal Displacement	None (single spell potion enchant)	Out Of Phase, Silence, Quitter, Infected, Joint Sleep, Limitless Vision, One Plus
The Duplicator	N/A (anvil transform book)	N/A
The Philosophers Book	N/A (anvil transform book)	N/A

Miners Intuition Material Mapping

Miners Intuition always points to the nearest single matching ore in range.

Helmet material/theme	Ore it locates
Turtle Shell	Spawner
Diamond	Diamond Ore, Deepslate Diamond Ore
Netherite	Ancient Debris
Iron	Iron Ore, Deepslate Iron Ore
Golden/Gold	Gold Ore, Deepslate Gold Ore, Nether Gold Ore
Chainmail	Emerald Ore, Deepslate Emerald Ore
Leather	Coal Ore, Deepslate Coal Ore
Copper-themed custom helmet	Copper Ore, Deepslate Copper Ore
Unknown/default fallback	Diamond Ore, Deepslate Diamond Ore

Full Pockets Loot Pool

When Full Pockets procs, it injects exactly one bonus stack into that container (or drops overflow nearby). While worn, it also attracts XP orbs in a 30 block radius:

• 40%: Diamond x1-2
• 32%: Emerald x2-5
• 14%: Netherite Scrap x1
• 10%: Experience Bottle x8-16
• 4%: Enchanted Golden Apple x1

Helmet Restrictions (Divine Vision / Miners Intuition / Loot Sense)

If a helmet has any of these custom enchants:

• Vanilla enchants are stripped from that helmet.
• Enchanting table application is blocked.
• Helmet custom enchants are mutually exclusive (cannot combine Divine Vision / Miners Intuition / Loot Sense).
• Durability is heavily nerfed:
  • Vanilla damage taken is doubled.
  • Effective remaining durability is capped to leather helmet durability.

Loot Table Integration

Example files are included:

• examples/loot_table_with_vision_books.json
• examples/loot_table_all_mystery_items.json
• examples/loot_table_mystery_items_armor.json
• examples/loot_table_mystery_items_utility.json
• examples/loot_table_mystery_items_weapons_tools.json
• examples/loot_table_mystery_items_weighted.json

These examples cover:

• Forbidden enchanted books
• Mystery books and mystery pre-enchanted items
• Category-specific mystery pools (armor / utility / weapons-tools)
• Weighted mystery selection patterns

This plugin recognizes books by custom_model_data (and also by display name/PDC fallback). It also recognizes pre-enchanted gear items by PDC and by the same custom_model_data formula.

Model data formula used by the plugin:

model_data = 930000 + ((typeIndex + 1) * 10) + level

Type index order:

1. divine_vision
2. miners_intuition
3. loot_sense
4. extended_grasp
5. void_grasp
6. masquerade
7. ascension
8. incite_fear
9. blindness
10. miasma
11. charm
12. miasma_form
13. aquatic_sacrifice
14. the_hated_one
15. withering_strike
16. healing_touch
17. full_pockets
18. dragons_breath
19. explosive_reaction
20. the_unyielding
21. forbidden_agility
22. pocket_dimension
23. petty_thief
24. lumberjack
25. sonic_panic
26. creepers_influence
27. staff_of_the_evoker
28. vexatious
29. wololo
30. locked_out
31. evokers_revenge
32. the_seeker
33. disarm
34. marked
35. greed
36. wing_clipper
37. launch
38. full_force
39. temporal_sickness
40. grave_robber
41. pocket_seeker
42. charmed_pet
43. applied_curse
44. get_over_here
45. mujahideen
46. shield_knockback
47. ricochet
48. shockwave
49. proud_warrior
50. siskos_solution
51. no_fall
52. borg_technology
53. warp_9_5
54. tracker
55. the_pretender
56. out_of_phase
57. silence
58. quitter
59. infected
60. the_duplicator
61. the_philosophers_book
62. joint_sleep
63. illusioners_revenge
64. instant_death
65. limitless_vision
66. one_plus
67. temporal_displacement
68. kismet
69. administrative_aspirations

So the generated IDs are:

• Divine Vision I/II/III/IV: 930011, 930012, 930013, 930014
• Miners Intuition I/II/III/IV: 930021, 930022, 930023, 930024
• Loot Sense I/II/III: 930031, 930032, 930033
• Extended Grasp I: 930041
• Void Grasp I: 930051
• Masquerade I: 930061
• Ascension I: 930071
• Incite Fear I/II: 930081, 930082
• Blindness I: 930091
• Miasma I: 930101
• Charm I/II/III/IV: 930111, 930112, 930113, 930114
• Miasma Form I: 930121
• Aquatic Sacrifice I: 930131
• The Hated One I/II: 930141, 930142
• Withering Strike I: 930151
• Healing Touch I: 930161
• Full Pockets I/II/III/IV: 930171, 930172, 930173, 930174
• Dragons Breath I/II: 930181, 930182
• Explosive Reaction I: 930191
• The Unyielding I: 930201
• Forbidden Agility I/II/III/IV: 930211, 930212, 930213, 930214
• Pocket Dimension I: 930221
• Petty Thief I: 930231
• Lumberjack I: 930241
• Sonic Panic I: 930251
• Creepers Influence I: 930261
• Staff Of The Evoker I: 930271
• Vexatious I/II/III: 930281, 930282, 930283
• Wololo I: 930291
• Locked Out I: 930301
• Evokers Revenge I: 930311
• The Seeker I: 930321
• Disarm I: 930331
• Marked I: 930341
• Greed I: 930351
• Wing Clipper I: 930361
• Launch I: 930371
• Full Force I: 930381
• Temporal Sickness I/II/III: 930391, 930392, 930393
• Grave Robber I/II/III/IV: 930401, 930402, 930403, 930404
• Pocket Seeker I/II/III/IV: 930411, 930412, 930413, 930414
• Charmed Pet I: 930421
• Applied Curse I/II/III: 930431, 930432, 930433
• Get Over Here! I: 930441
• Mujahideen I: 930451
• Knockback I: 930461
• Ricochet I: 930471
• Shockwave I: 930481
• Proud Warrior I: 930491
• Sisko's Solution I: 930501
• No Fall I: 930511
• Borg Technology I: 930521
• Warp 9.5 I: 930531
• Tracker I: 930541
• The Pretender I: 930551
• Out Of Phase I: 930561
• Silence I: 930571
• Quitter I: 930581
• Infected I: 930591
• The Duplicator I: 930601
• The Philosophers Book I/II/III: 930611, 930612, 930613
• Joint Sleep I: 930621
• Illusioners Revenge I: 930631
• Instant Death I: 930641
• Limitless Vision I: 930651
• One Plus I/II/III/IV: 930661, 930662, 930663, 930664
• Temporal Displacement I/II/III: 930671, 930672, 930673
• Kismet I: 930681
• Administrative Aspirations I/II: 930691, 930692

Notes / Caveats

• Vision and sense effects are particle/status based and run on scheduled ticks.
• Through-wall interactions for Void Grasp are intentionally permissive by design.
• Masquerade uses an invisible player + silent mob disguise entity.

Architecture

The plugin is split into focused layers:

• Composition root: ForbiddenEnchantsPlugin wires services, owns runtime maps/PDC keys, schedules tick maintenance, and exposes command/menu entrypoints.
• Event bridge: ForbiddenEnchantsListener keeps Bukkit handlers thin and routes events into services/runtime dispatch.
• Enchant domain model:
  • EnchantType is the registry of all enchants (arg, model index, color, slot, max level, compatibility flags/groups).
  • enchants/ForbiddenEnchantDefinition defines metadata contract.
  • enchants/ForbiddenEnchantRuntime defines optional runtime hooks.
  • enchants/EnchantList builds the runtime dispatcher from EnchantType.values().
• Rules and item pipeline: EnchantStateService, EnchantRuleCoreService, EnchantEventRuleService, EnchantBookFactoryService, MysteryItemService.
• Feature services: combat/mob/effect systems (GraspCombatService, WitheringStrikeService, VexatiousService, FullPocketsService, TemporalSicknessService, etc.).
• Injector subsystem: runtime/StructureInjectorRuntimeService, admin/InjectorCommandHandler, admin/InjectorMenuService, InjectorLootMode, InjectorMysteryState.
• Librarian trade subsystem: LibrarianTradeService, admin/LibrarianTradeCommandHandler, admin/LibrarianTradeMenuService.
• Presentation/admin UX: admin/FeCommandHandler, admin/FePresentationService, admin/FeMenuService, admin/FeCatalogService, admin/EnchantToggleMenuService, admin/InjectorMessagingUtil.
• Persistence/config: config/ConfigPersistenceService and config/MessagesService.

Project Structure

• src/main/java/dev/cevapi/forbiddenenchants/
  • ForbiddenEnchantsPlugin.java: composition root and shared runtime state.
  • ForbiddenEnchantsListener.java: Bukkit event routing.
  • EnchantType.java: canonical enchant registry + compatibility metadata.
  • admin/: FE command + admin GUIs + injector/librarian/bundle command handlers and messaging helpers.
  • config/: persisted config readers/writers (ConfigPersistenceService, MessagesService).
  • runtime/: runtime-only systems (StructureInjectorRuntimeService, BundleDropRuntimeService).
  • LibrarianTradeService.java: librarian trade runtime hooks.
  • PluginModels.java: inventory holders/records for GUI/runtime model objects.
  • *Service.java: focused subsystems (combat, effects, lifecycle, utility, etc.).
• src/main/java/dev/cevapi/forbiddenenchants/enchants/
  • BaseForbiddenEnchant.java, ForbiddenEnchantDefinition.java, ForbiddenEnchantRuntime.java
  • EnchantList.java runtime dispatcher
  • one class per enchant (*Enchant.java)
• src/main/resources/
  • plugin.yml: command + plugin metadata
  • config.yml: persisted defaults/state (structure_injector, enchant_controls, librarian_trades)
  • messages.yml: customizable text for FE menus/help/action-bar messages
• examples/
  • all datapack-style loot table examples (books + mystery books/items + weighted/category pools)

Example Loot Tables

• examples/loot_table_with_vision_books.json: direct forbidden-book entries.
• examples/loot_table_all_mystery_items.json: broad mystery-item pool.
• examples/loot_table_mystery_items_armor.json: armor-only mystery pool.
• examples/loot_table_mystery_items_utility.json: utility-only mystery pool.
• examples/loot_table_mystery_items_weapons_tools.json: weapons/tools mystery pool.
• examples/loot_table_mystery_items_weighted.json: weighted mystery mix.

Minimal direct-book entry shape (from loot_table_with_vision_books.json):

{
  "type": "minecraft:item",
  "name": "minecraft:enchanted_book",
  "functions": [
    {
      "function": "minecraft:set_components",
      "components": {
        "minecraft:custom_name": {
          "text": "Forbidden Divine Vision I",
          "color": "aqua",
          "italic": false
        },
        "minecraft:custom_model_data": {
          "floats": [930011.0]
        }
      }
    }
  ]
}

For mystery entries, include minecraft:custom_data with:

• "forbiddenenchants:mystery_item": 1

Adding New Enchants

1. Add a new enchant class in src/main/java/dev/cevapi/forbiddenenchants/enchants/, typically extending BaseForbiddenEnchant.
2. In that class, define:
   • arg, pdcKey, displayName, slot, maxLevel, color, aliases
   • effectDescription(level) (shown in lore/UI)
   • runtime hooks only if needed (onDamageByEntity, onInteract, onPlayerTick, etc.)
3. Register the enchant in EnchantType:
   • add import
   • add enum constant with a unique modelTypeIndex and new YourEnchantClass()
   • keep modelTypeIndex unique forever (do not reuse old numbers)
4. Update compatibility/flags in EnchantType static init when needed:
   • setExclusiveGroup(...)
   • addMutualIncompatibility(...)
   • sets like APPLIES_BINDING_CURSE, STRIPS_VANILLA_ENCHANTS, STRIPS_MENDING_UNBREAKING, REQUIRES_NO_OTHER_ENCHANTS, REQUIRES_SOLO_ON_TRIDENT
5. Validate slot/material behavior:
   • existing slot: confirm EnchantMaterialCatalog + ItemClassificationService rules match your intent
   • new slot category: update ArmorSlot, SlotParsingUtil, EnchantMaterialCatalog, and slot checks in ItemClassificationService
6. Understand what is automatic:
   • command arg resolution and tab-complete come from EnchantType metadata
   • runtime dispatch is automatic through EnchantList once the enchant is in EnchantType
   • book/item lore wrapping uses slotDescription() + effectDescription(level) via EnchantBookFactoryService and LoreWrapUtil
7. If your enchant needs extra runtime state/services, wire it in ForbiddenEnchantsPlugin and route relevant events through existing services/listener flow.
8. Build and validate:
   • ./gradlew build

• test /fe give, /fe givebook, /fe giveitem, /fe mysterybook, /fe mysteryitem, /fe reload, /fe gui, and injector/toggle interactions.

Note: this repository currently has no scaffold script for new enchants; add them manually with the steps above.