Custom Enchantments Documentation

Fish's Custom Enchantments

Vanilla-like custom enchantment books that are dropped by mobs. Over 90 enchantments across weapons, tools, armour, elytra and wolf armour — each obtained by hunting the mob that drops it, so progression feels like part of the game rather than a menu.

To view what an enchantment does or how to obtain it in game, use /enchantinfo <enchantment>.

Download Fish's Custom Enchantments on SpigotMC

Installation

  1. Add the FishsCustomEnchantments jar into your plugins folder.
  2. Restart your server.

Commands

  • /fce help — Shows the help menu.
  • /fce reload — Reloads the plugin. (fce.admin.reload)
  • /enchantinfo — Opens a paginated GUI listing all custom enchantments; includes a filter button to show only enchantments for a chosen item type (sword, bow, pickaxe, chestplate, etc.) — click the filter button to open the item-type picker, then select a type to narrow the list, or select All to show every enchantment. (fce.user.enchantinfo)
  • /enchantinfo <enchantment> — Gives information about an enchantment in chat. (fce.user.enchantinfo)
  • /enchantinfo hand — Opens a GUI showing the enchantments on the item in your hand. (fce.user.enchantinfo)
  • /fenchant <enchantment> [level] — Applies an enchantment to the item in your hand. (fce.admin.fenchant)
  • /disenchant <enchantment> — Removes an enchantment from the item in your hand and returns the enchantment book. (fce.user.disenchant)
  • /enchantedbook <enchantment> [level] — Get an enchanted book with the specified enchantment. (fce.admin.enchantedbook)
  • /combineenchantments — Opens an interactive GUI where you can place two items into the labeled input slots and see a live preview of the combined result in the result slot. Take the result item to apply the merge. Works for Java and Bedrock (Geyser) players. (fce.user.combineenchantments)

Permissions

  • fce.user.enchantinfo — Allows viewing enchantment information.
  • fce.user.disenchant — Allows removing an enchantment and recovering the book.
  • fce.user.combineenchantments — Allows combining enchantments without an anvil.
  • fce.user.combineenchantments.bypassconflicts — Allows combining normally-conflicting or mutually-exclusive enchantments. Applies only to the combine command; the vanilla anvil is unaffected.
  • fce.user.combineenchantments.conflicts.<armor|weapons|tools>.<1|2|3> (op) — Nine tiered nodes giving a graduated per-category ceiling on how many conflicting enchantment pairs a combine may produce. Each item category (armor, weapons, tools) has three tiers; tier N lets the resulting item end up with at most N conflicting pairs. Higher tiers include the lower ones, and a combine that would exceed a player's tier falls back to the non-conflicting merge. Items outside these three categories (books, shields, fishing rods, wolf armor) are governed only by bypassconflicts, which remains the unlimited node. Like bypassconflicts, these apply only to the combine command, not the vanilla anvil.
  • fce.admin.reload — Allows reloading the plugin.
  • fce.admin.fenchant — Allows applying any enchantment to the held item.
  • fce.admin.enchantedbook — Allows spawning any enchanted book.

Enchanting Table

Any custom enchantment can optionally appear in the vanilla enchanting table, configured per enchantment in enchantments.yml under an enchanting-table block:

  • enabled — Off by default; set it to true to opt an enchantment into the enchanting table. While off, the enchantment behaves exactly as before and never shows up when enchanting.
  • weight — The relative chance of the enchantment appearing versus the others eligible at that power level (higher = more common; not a literal percentage).
  • min-cost / max-cost — The enchanting-power range in which the enchantment is offered.

These settings are read while the server boots, so they only take effect after a full server restart (a /fce reload will not apply them). Any invalid or missing value falls back to its default with a warning and never stops the server from starting.

Enchantments

Most enchantments are a rare drop from a specific mob, listed alongside each entry.

General

These stack freely with each other and with vanilla enchantments.

  • Aqua Aspect (Weapons) — Deal extra damage to enderman, blaze etc. Extinguishes attacked entities. Rare drop from drowned.
  • Auto Reel (Fishing Pole) — Automatically reels in your fishing rod when a fish bites. Rare drop from guardian.
  • Bad Omen (Chestplate and Elytra) — Wearer receives bad omen. Rare drop from breeze.
  • Block Reach (Chestplate) — Increases the distance at which you can interact with blocks. Rare drop from enderman.
  • Cavalry (Spears) — Bonus melee damage while mounted, scaling with how fast your mount is moving — the classic joust. Rare drop from skeleton horse.
  • Enlightenment (Tools and Weapons) — Increased XP drops from blocks and mobs. Rare drop from warden.
  • Excavating (Tools) — Mine blocks in a 3x3 area, digging deeper at higher levels. Rare drop from creeper.
  • Fling (Weapons) — Sends attacked entities upwards. Rare drop from creeper.
  • Hunt (Leggings) — Nearby entities glow while you are sneaking. Rare drop from warden.
  • Invisibility (Armor) — Wearer receives invisibility. Rare drop from witch.
  • Luck (Chestplate) — Wearer has increased luck. Rare drop from evoker.
  • Pegasus (Boots) — Mounted mobs receive slow falling. Rare drop from ghast.
  • Phantom Shield (Chestplate and Elytra) — Phantoms that attack you take lethal damage and deal none in return. Rare drop from phantom.
  • Precision (Bow and Crossbow) — Fired projectiles have 100% accuracy. Rare drop from skeleton.
  • Radiance (Weapons) — Attacked entities receive glowing. Rare drop from magma cube.
  • Range (Bow and Crossbow) — Fired projectiles have a higher velocity. Rare drop from skeleton.
  • Reflection (Shield) — Reflect arrows at a higher velocity. Rare drop from breeze.
  • Replanting (Hoe) — Replants anything harvested automatically. Rare drop from pillager.
  • Shield Bash (Shield) — Blocking a melee attack knocks the attacker back and deals a small amount of damage. Rare drop from breeze.
  • Skewer (Spears) — Spear jabs run through and damage every enemy on the line to your target; the line always reaches your target and higher levels extend it farther to pierce more enemies. Rare drop from pillager.
  • Smelting (Tools) — Dropped items will be smelted if possible. Rare drop from blaze.
  • Spurs (Boots) — Mounted mobs receive speed and jump boost. Rare drop from pillager.
  • Stagger (Shield) — Blocking a melee attack may stagger the attacker with slowness and weakness. Rare drop from pillager.
  • Stripping (Axe) — Strips all connected logs of the same type. Rare drop from pillager.
  • Telekinesis (Tools and Weapons) — Dropped items are added to your inventory. Items blocked with the Don't Pick Up plugin are left on the ground when it is installed. Rare drop from enderman.
  • Tilling (Hoe) — Hoe farmland 3x3. Rare drop from pillager.
  • Thunder Charge (Trident) — Throw a trident above the world's build limit (Y=320) to summon a thunderstorm. 30 minute cooldown per player. Rare drop from drowned.
  • Tree Feller (Axe) — Breaks the entire trunk of the tree. Rare drop from pillager.
  • Unbreakable (All) — Item will not lose durability. Rare drop from wither.
  • Vein Miner (Pickaxe) — Mines the whole connected ore vein. Rare drop from creeper.
  • Volley (Bow and Crossbow) — Fire multiple arrows at once. Rare drop from skeleton.

Curses

  • Curse of Aquaphobia (Armor) — Wearer takes damage from water and rain. Rare drop from enderman.
  • Curse of Ever Flame (Leggings) — Wearer is perpetually on fire, and anyone who attacks them is set ablaze until they extinguish themselves. Rare drop from blaze.
  • Curse of Iron Grip (Tools and Weapons) — Prevents the holder from dropping the item. Rare drop from witch.
  • Curse of Levitating (Armor) — Wearer levitates uncontrollably. Rare drop from shulker.
  • Curse of Mining Fatigue (Armor) — Wearer has decreased mining speed. Rare drop from elder guardian.
  • Curse of Radiance (Armor) — Wearer will begin to glow. Rare drop from magma cube.
  • Curse of Slowness (Armor) — Wearer has decreased movement speed. Rare drop from warden.
  • Curse of Weakness (Armor) — Wearer has decreased melee damage. Rare drop from cave spider.

Exclusive: Weapons

Only one of these enchantments may be applied at the same time.

  • Blood Tipped (Bow and Crossbow) — Take slight damage when firing, applies your potion effects to the arrow. Rare drop from piglin.
  • Crater (Mace) — Mace smash attacks briefly root nearby entities. Rare drop from iron golem.
  • Crippling (Weapons) — Attacked entities receive slowness. Rare drop from skeleton.
  • Debilitating (Weapons) — Attacked entities receive weakness. Rare drop from witch.
  • Destructive (Bow and Crossbow) — Projectiles destroy blocks. Rare drop from creeper.
  • Disorienting (Weapons) — Attacked entities receive nausea. Rare drop from spider.
  • Executioner (Weapons) — Deals bonus melee damage that scales with the target's missing health, acting as a finisher. Rare drop from wither skeleton.
  • Fire Blast (Bow and Crossbow) — Launched projectiles are transformed into a blaze fire ball. Rare drop from blaze.
  • Frostbite (Weapons) — Attacked entities are frozen, taking freeze damage and slowing down. Rare drop from stray.
  • Glass (Weapons) — Increased damage, decreased durability. Rare drop from skeleton.
  • Harpoon (Bow and Crossbow) — Launched projectiles are transformed into tridents. Rare drop from drowned.
  • Levitating (Bow and Crossbow) — Launched projectiles are transformed into a shulker bullet. Rare drop from shulker.
  • Life Steal (Weapons) — A portion of the damage you deal is added to your health. Rare drop from wither.
  • Lightning Charge (Spears) — Strike lightning on your enemy when landing a charged attack. Cooldown per player. Rare drop from witch.
  • Meteor (Mace) — Mace smash attacks add fire particles and briefly ignite the target. Rare drop from magma cube.
  • Obscure (Weapons) — Attacked entities receive blindness. Rare drop from warden.
  • Plague (Weapons) — On kill, spawns a lingering poison cloud that infects nearby mobs. Rare drop from zombie.
  • Salmon Slinger (Bow and Crossbow) — Launched projectiles are transformed into salmon. This enchantment is not dropped by any mob.
  • Seeking (Bow and Crossbow) — Arrows are attracted to the nearest entity. Rare drop from stray.
  • Shockwave (Mace) — Mace smash attacks unleash an area-of-effect shockwave that damages and knocks back nearby entities, scaling with fall distance. Rare drop from ravager.
  • Starving (Weapons) — Attacked entities receive hunger. Rare drop from husk.
  • Teleport (Bow and Crossbow) — Teleport to the location your projectile hits. Rare drop from enderman.
  • Venom (Weapons) — Attacked entities receive poison. Rare drop from cave spider.
  • Withering (Weapons) — Attacked entities receive wither. Rare drop from wither.

Exclusive: Helmet

Only one of these enchantments may be applied at the same time.

  • Conduit Power — See underwater, breathe underwater, mine faster underwater. Drop from elder guardian.
  • Gills — Wearer can breathe underwater. Rare drop from drowned.
  • Night Vision — Wearer has improved vision in the dark. Rare drop from spider.
  • Sustenance — Hunger bar replenishes over time. Rare drop from zombie.
  • Worm — Prevents suffocation damage. Rare drop from silverfish.

Exclusive: Chestplate

Only one of these enchantments may be applied at the same time.

  • Big — Increases the size of the wearer by 50% per level, making them heavier so they fall faster. On wolf armor, grows the wolf. Rare drop from ravager.
  • Death Wish — Wearer takes increased damage and deals increased damage. Rare drop from wither skeleton.
  • Dragon Scales — Wearer has increased damage resistance. Rare drop from ender dragon.
  • Fire Resistance — Wearer is immune to fire damage. Rare drop from blaze.
  • Flaming — Attackers will be lit on fire. Rare drop from blaze.
  • Haste — Wearer has increased mining speed. Rare drop from piglin.
  • Healing — Wearer has faster health regeneration. Rare drop from witch.
  • Hero of the Village — Wearer receives reduced villager prices. Rare drop from pillager.
  • Increased Health — Wearer has increased max health. Rare drop from ender dragon.
  • Projectile Resistance — Wearer is immune to projectile damage. Rare drop from wither.
  • Small — Decreases the size of the wearer, making them lighter so they fall a little slower. On wolf armor, shrinks the wolf. Rare drop from silverfish.
  • Strength — Wearer has increased melee damage. Rare drop from piglin.

Exclusive: Elytra

Only one of these enchantments may be applied at the same time.

  • Boosters — A small amount of constant thrust is added to the elytra. Rare drop from creeper.
  • Momentum — Wearer will gain speed faster when gliding. Rare drop from ender dragon.

Exclusive: Leggings

Only one of these enchantments may be applied at the same time.

  • Dolphins Grace — Wearer can move quickly in water. Rare drop from guardian.
  • Ender Aspect — Teleports the wearer to a random nearby location when hit by a projectile, and sometimes when taking damage. Rare drop from enderman.
  • Heavy — Wearer receives no knockback. Rare drop from warden.
  • Longlegs — Wearer has increased step height. Rare drop from enderman.
  • Swiftness — Wearer has increased movement speed. Rare drop from witch.

Exclusive: Boots

Only one of these enchantments may be applied at the same time.

  • Anchor — Wearer sinks in water and has increased traction in water. Rare drop from drowned.
  • Anti-Gravity — Decreases gravity of the wearer. Rare drop from shulker.
  • Bounce — Wearer bounces instead of taking fall damage. Rare drop from slime.
  • Crush — Falling on an entity will damage it. Rare drop from ravager.
  • Leaping — Wearer has increased jump height. Rare drop from slime.
  • Slow Falling — Wearer falls gracefully like a feather. Rare drop from ghast.

Exclusive: Wolf Armor

Only one of these enchantments may be applied at the same time.

  • Blood Feast — When the wolf deals damage to an enemy, it heals for a portion of the damage dealt and its armor durability is repaired. Rare drop from ravager.
  • Bramble — Wolf armor reflects a portion of incoming damage back to the attacker. Rare drop from bogged.
  • Fireproof — Wolf armor makes the wolf immune to fire and lava damage. Rare drop from blaze.
  • Hamstring — Wolf attacks apply slowness to the target. Rare drop from ravager.
  • Panther Blood — Wolf stores incoming damage as a charge and releases it as bonus damage on the next attack, with a particle burst scaling to the charge released. Rare drop from ender dragon.
  • Pursuit — Wolf moves faster and jumps higher based on enchantment level. Rare drop from pillager.
  • Rabies — Wolf attacks inflict Poison on the target. Rare drop from cave spider.
  • Savagery — Wolf attacks deal increased damage based on enchantment level. Rare drop from ravager.
  • Warding — Wolf armor reduces incoming damage based on enchantment level. Rare drop from wither.

Exclusive: Horse Armor

Only one of these enchantments may be applied at the same time.

  • Barding — Horse armor reduces incoming damage based on enchantment level. Rare drop from pillager.
  • Gallop — Horse moves faster and jumps higher based on enchantment level. Rare drop from pillager.

Exclusive: Harness / Happy Ghast Saddle

Only one of these enchantments may be applied at the same time. This category is established and harness enchantments are coming — none have shipped yet.