✨ Custom Enchants

40 custom enchantments in English · 5 rarity tiers · 100% Vanilla integration Compatible with Paper 1.21.8+ (Java 21) — No external dependencies required.

CustomEnchants adds 40 original enchantments that seamlessly integrate into core game mechanics: they appear in the Enchanting Table, combine on Anvils with progressive XP costs, and feature strict anti-stacking rules to maintain game balance. These are true registry-level enchantments — not lore-line workarounds.

An in-game administration panel allows full management without needing to edit configuration files manually.

---

💎 Rarity System

Rarity	Color	Sources
Common	⬜ White	Enchanting Table, Villagers, Loot Chests
Rare	🟦 Blue	Enchanting Table, Villagers, Loot Chests
Epic	🟪 Purple	Enchanting Table, Villagers, Loot Chests
Legendary	🟨 Gold	Villagers, Loot Chests
Mythic	🟥 Red	Villagers (Very rare, 1 trade max), Loot Chests

The rarer an enchantment, the higher the cost to acquire and combine — and the more powerful its effect.

---

📖 Enchantment Catalogue (40)

⚔️ Combat — Swords (12)

Enchantment	Rarity	Max Level	Effect
Vampirism	Rare	III	Steals HP from the target on hit.
Lightning Call	Epic	II	Chance to strike target with lightning.
Venom	Common	III	Poisons the hit target.
Frostbite	Rare	II	Freezes and heavily slows the target.
Decapitator	Rare	III	Chance to drop the victim's head.
Rage	Epic	III	Damage builds up as your HP decreases.
Execution	Legendary	III	Increased damage against low-health targets.
Cleave	Epic	II	Hits deal damage to nearby enemies as well.
Enfeeble	Common	II	Weakens the target's outgoing hits.
Hellfire	Common	III	Ignites target for longer than Fire Aspect.
Slayer	Common	III	Increased damage against hostile mobs.
Reaper	Mythic	I	Chance for devastating critical strikes with soul visual effects.

🏹 Bows & Crossbows (6)

Enchantment	Rarity	Max Level	Effect
Multishot+	Epic	II	Fires multiple arrows in a spread.
Homing	Rare	I	Arrows adjust trajectory toward target.
Explosive	Legendary	II	Explodes on impact without destroying blocks.
Grapple	Rare	I	Pulls you to the arrow's point of impact.
Glacial	Common	II	Heavily slows the struck target.
Arrow Rain	Epic	I	Rains down a volley of arrows over an area.

⛏️ Tools (10)

Enchantment	Rarity	Max Level	Effect
Excavation	Epic	II	Mines a 3x3 area (5x5 at Level 2).
Auto-Smelt	Rare	I	Ores are automatically smelted upon harvest.
Telekinesis	Rare	I	Drops are sent directly to your inventory.
XP Boost	Common	III	Increases XP gained while mining.
Lumberjack	Rare	I	Fells entire trees in a single strike.
Reaper Hoe	Common	II	Harvests and replants mature crops in an area.
Prospector	Legendary	III	Chance to double rare ore drops.
Jackhammer	Common	I	Grants Haste while mining below Y=0.
Tiller	Common	I	Till soil in a 3x3 area.
End Miner	Epic	I	Grants Haste II in the Nether and End dimensions.

🛡️ Armor (10)

Enchantment	Rarity	Max Level	Effect
Regeneration	Epic	II	Passive regeneration with full armor set equipped.
Velocity	Common	III	Increases movement speed.
Golem Grip	Rare	II	Significantly reduces knockback taken.
Vengeful Thorns	Rare	II	Reflects damage and weakens attackers.
Leaping	Common	II	Increases jump height.
Night Vision	Common	I	Grants permanent Night Vision.
Gills	Rare	I	Unlimited underwater breathing.
Anchor	Epic	I	Immunity to knockback and forced displacement.
Last Breath	Legendary	I	At 10% HP: grants Absorption + Resistance (5 min cooldown).
Avatar	Mythic	I	Full set: environment-adaptive stat buffs.

🔮 Miscellaneous (2)

Enchantment	Rarity	Max Level	Effect
Soulbound	Legendary	I	Item stays in inventory upon death.
Soul Repair	Legendary	I	Item repairs itself with each creature killed.

---

🎯 How to Obtain

• 🪄 Enchanting Table — Common, Rare, and Epic only. Legendary and Mythic tiers are excluded.
• 🧑‍🌾 Librarian Villagers — Offers custom enchanted books. Prices scale with rarity (Emeral -> Diamond -> Netherite + Emerald Blocks). Mythics can only be traded once per villager.
• 🗝️ Loot Chests — Found in dungeons, mineshafts, temples, End cities, etc., with weighted loot tables based on rarity.
• 🛠️ Admin Options — In-game admin panel and commands to grant any enchantment directly.

---

⚖️ Anti-Stacking & Balancing

Certain enchantments are mutually exclusive — the table and anvil will natively prevent stacking them on a single item:

Group	Exclusions
Damage Perks	Rage · Execution · Reaper
Elemental	Lightning Call · Venom · Frostbite · Enfeeble · Hellfire
Special Arrows	Multishot+ · Homing · Explosive · Arrow Rain
Mining	Excavation · Lumberjack · Jackhammer
Survival	Last Breath · Avatar
Boots Mobility	Velocity · Leaping

Item Limit: Maximum 3 custom enchantments per item. Anvil XP costs increase with each additional custom enchantment applied.

---

🖥️ Commands & Interface

Command	Permission	Description
/ce menu	Everyone	Open full in-game enchantment catalogue
/ce panel	Admin	Toggle features, give items, edit filters
/ce give /ce apply	Admin	Grant or apply specific enchantments
/ce info /ce list	Everyone	View detailed enchantment lists
/ce reload	Admin	Reload plugin configuration

Every enchantment can be toggled off individually without breaking existing items held by players.

---

📦 Installation

1. Download the .jar file and place it into your server's plugins/ directory.
2. Restart your server (Do not use /reload — enchantments register on startup).
3. Optionally configure settings via config.yml.

⚠️ Requires Paper 1.21.8+ (or forks such as Purpur or Pufferfish). Spigot is incompatible.