About

Mentalitys | Custom Enchantments is a Fabric mod for Minecraft 1.20.1, 1.21.1 and 1.21.11 that adds 19 unique enchantments with flexible configuration via Cloth Config API. Each enchantment can be toggled individually, and all parameters — levels, chances, durations, radii — are tweakable via the GUI settings screen (Mod Menu) without restarting the server. Config file: config/custom-enchants.json.

Minecraft 1.20.1 · 1.21.1 · 1.21.11 Fabric API Cloth Config Java 17 / 21 v3.1.1

Minecraft Compatibility

Custom Enchants 3.1.1 is prepared for three Minecraft versions from separate branches. Pick the release that matches your server/client.

🟢
Minecraft 1.20.1 · Java 17
Branch 3.1/1.20.1 · v3.1.1
🆕
Minecraft 1.21.1 · Java 21
Branch 3.1/1.21.1 · v3.1.1-mc1.21.1
🆕
Minecraft 1.21.11 · Java 21
Branch 3.1/1.21.11 · v3.1.1-mc1.21.11

The enchantment reference, configuration reference and librarian trades below are shared documentation for the maintained 3.1.1 line. Always install the JAR and dependencies for your exact Minecraft version.

Requirements (Minecraft 1.20.1)

🧩
Fabric API
0.92.7+1.20.1
⚙️
Cloth Config API
11.1.118
📋
Mod Menu
7.2.2

Minecraft 1.21.1 requires Fabric API >=0.116.15+1.21.1, Cloth Config >=15.0.140 and Mod Menu >=11.0.4. Minecraft 1.21.11 requires Fabric API >=0.141.6+1.21.11, Cloth Config >=21.11.153 and Mod Menu >=17.0.0. Both require Java 21.

Enchantments

⚔️

Glow Strike Glow Strike

Weapon Rare Max level: III

On hit, applies Glowing to the target — makes them visible through walls. Works on swords, axes, and tridents.

📦 Sword · Axe · Trident
Level Duration
I2 sec
II4 sec
III7 sec
  • Incompatible with Knockback; on trident — also with Shadow Blade
  • Duration per level is configurable
🦘

Double Jump Double Jump

Armor Very Rare Max level: I

Allows a second jump in mid-air. White cloud particles appear on double jump.

📦 Boots
  • 67% chance to consume 1 durability (Unbreaking reduces this)
  • Does not work in water or lava
⛏️

Drill Drill

Tool Very Rare Max level: I

Breaks blocks in a 3×3 area. The plane is determined by the mined face.

📦 Pickaxe · Shovel
  • Disabled while sneaking (Shift)
  • 1 durability per extra block (Unbreaking applies)
  • Compatible with Magnet
🗡️

Poison Blade Poison Blade

Weapon Rare Max level: III

On hit, applies the Poison effect to the target.

📦 Sword · Axe
Level Duration
I2 sec
II3 sec
III4 sec
  • Incompatible with Fire Aspect
🪵

Lumberjack Lumberjack

Tool Rare Max level: III

Chops an entire tree by breaking one log. Smart detection — won't break player-built log structures. Works with Nether trees.

📦 Axe
Level Max blocks
I16
II48
III128
  • Does not work on _wood / hyphae blocks
  • Does not break below the original block
  • Compatible with Magnet
🗡️

Shadow Blade Shadow Blade

Weapon Very Rare Max level: III

On hit, chance to teleport behind the target and apply Slowness II. Chance scales with throw distance (up to +10% from 30 blocks).

📦 Trident
Level Chance Slowness
I15%1 sec
II25%2 sec
III35%3 sec
  • Incompatible with Channeling, Riptide, Glow Strike
  • Compatible with Loyalty — trident returns after teleport
🧲

Magnet Magnet

Tool Rare Max level: I

When mining, collects linked drops into the player's inventory and also uses a configurable nearby-item radius (default 5 blocks).

📦 Pickaxe · Axe · Shovel · Hoe
  • Works with Drill and Lumberjack
  • Pickup radius is configurable; on 1.20.1, complex Lumberjack trees can leave some secondary drops nearby without loss or duplication
🔥

Auto Smelt Auto Smelt

Tool Rare Max level: I

Automatically replaces eligible ore loot with the smelted result while preserving the relevant vanilla loot behavior.

📦 Pickaxe
  • Works with the resolved vanilla loot path, including Silk Touch and Fortune behavior where applicable
🌱

Vegetation Vegetation

Tool Rare Max level: III

Breaking a mature crop has a chance to auto-replant it. Works with wheat, carrots, potatoes, beetroot, nether wart.

📦 Hoe
Level Replant chance
I30%
II60%
III100%
  • Freshly planted crop is protected from breaking for 0.5 sec
🛡️

Rebound Rebound

Armor Rare Max level: III

When blocking a melee attack, knocks the attacker back. Player also gets a small backwards impulse (15%). Does not deal damage.

📦 Shield
Level Knockback
I0.5
II1.0
III2.0
  • Costs extra shield durability (1 per level)
  • Incompatible with Feedback and Guardian's Grace
🛡️

Feedback Feedback

Armor Rare Max level: I

When blocking a magical attack (harming potions, shulker bullets, evoker fangs), fully cancels damage, clears all harmful effects, and restores shield durability.

📦 Shield
  • Cancels magic damage inside hurt() before it is applied
  • Durability restoration amount is configurable
  • Incompatible with Rebound and Guardian's Grace
🌀

Second Wind Second Wind

Armor Very Rare Max level: I

When health drops below 1 heart (2 HP), instantly grants Speed II, Resistance I, and 100% knockback resistance. Effect duration scales with enchanted armor pieces.

📦 Helmet · Chestplate · Leggings · Boots
Pieces Speed II Resistance I
12 sec1 sec
23 sec1 sec
33 sec2 sec
44 sec2 sec
  • Cooldown: 60 seconds (configurable)
  • Visual effects: smoke and cloud particles
🛡️

Guardian's Grace Guardian's Grace

Armor Rare Max level: III

On block, chance to restore 1 food point. Level III: extra 10% chance to heal 1 heart.

📦 Shield
Level Food chance Bonus
I10%
II20%
III30%+10% heal (2 HP)
  • Incompatible with Rebound and Feedback
🎯

Vulnerability Vulnerability

Ranged Rare Max level: III

Arrows partially ignore the target's armor, piercing protection.

📦 Bow · Crossbow
Level Armor ignored
I10%
II20%
III30%
🎣

Tether Master Tether Master

Tool Uncommon Max level: III

Increases the pull strength when reeling in hooked mobs.

📦 Fishing Rod
Level Pull strength
I+15%
II+25%
III+40%

Sky Rage Sky Rage

Ranged Rare Max level: III

During a thunderstorm, arrows have a chance to summon a lightning strike at the hit location.

📦 Bow · Crossbow
Level Chance
I10%
II20%
III30%
  • Only during thunderstorm (not plain rain)
  • Does not work under a roof
  • Per-player cooldown: 1.5 sec between strikes
  • Incompatible with Flame, Infinity, Piercing

XP Syphon XP Syphon

Weapon Uncommon Max level: III

Hits on mobs have a chance to drop XP orbs before the mob dies.

📦 Sword
Level Chance XP
I5%1
II10%2
III15%3
  • Works on any mob, including bosses
💥

Kinetic Discharge Kinetic Discharge

Armor Rare Max level: III

Landing after fast elytra flight creates a shockwave that knocks back nearby mobs. Level III passively reduces elytra durability loss by ~90%.

📦 Elytra
Level Radius Effect
I3 blocksWeak knockback
II5 blocksMedium knockback
III7 blocksStrong + 2 HP dmg
  • Triggers at landing speed ≥ 0.4 blocks/tick
  • Level III: only 10% chance to cost durability on shockwave
🌑

Sculk Bloom Sculk Bloom

Weapon Rare Max level: II

When killing a mob, sculk spreads at the death location — as if a Sculk Catalyst were placed there.

📦 Sword
Level Effect
ISmall bloom (≈2–3 block radius)
IILarge bloom (≈4–5 block radius)
  • Works only on direct kills with the enchanted weapon
  • May generate sculk veins, sensors, and shriekers

Changelog

v3.1.1 2026-08-07 Stability & fixes

Compatibility: maintained Fabric builds for Minecraft 1.20.1 (Java 17), 1.21.1 and 1.21.11 (Java 21); 19 enchantments total.

Fixed: linked Magnet drop collection, resolved-loot Auto Smelt, safe Shadow Blade teleport, Sky Rage item restrictions, authoritative Double Jump movement and sprint impulse, Feedback protection, XP Syphon verification, and runtime/mixin compatibility.

v3.0.0 2026-04-30 +1 enchantment

Added: Sculk Bloom — sword enchantment (Rare, max II). On kill, sculk spreads at the death location like a Sculk Catalyst. Level II produces a larger bloom and can generate sensors/shriekers.

v2.9.0 2026-03-28 +1 enchantment

Added: Kinetic Discharge — elytra enchantment (Rare, max III). Shockwave on landing after fast flight. Level III: passive ~90% elytra durability savings.

Fixed: Feedback now fully blocks instant magic damage (DamageTypes.MAGIC) and clears effects before they are applied.

v2.8.0 2026-03-28 +1 enchantment

Added: XP Syphon — sword enchantment (Uncommon, max III). Hits drop XP orbs before mob death.

Fixed: Feedback — full rework of effect protection; added forceAddEffect interception.

v2.7.0 2026-03-28 +1 enchantment

Added: Sky Rage — bow/crossbow enchantment (Rare, max III). Lightning strike during thunderstorms. Cooldown 1.5 sec.

v2.6.0 2026-03-28 +1 enchantment

Added: Tether Master — fishing rod enchantment (Uncommon, max III). Increases mob pull strength.

Changed: Shadow Blade — restored compatibility with Loyalty.

v2.5.0 2026-03-28 +1 enchantment

Added: Vulnerability — bow/crossbow enchantment (Rare, max III). Arrows partially ignore armor.

Changed: Rebound, Feedback and Guardian's Grace are now mutually incompatible.

v2.4.0 2026-03-28 +1 enchantment

Added: Guardian's Grace — shield enchantment (Rare, max III). Restores food on block; Level III also heals.

Changed: Second Wind can now be applied to any armor piece; duration scales with piece count.

v2.3.0 2026-03-27 +1 enchantment

Added: Second Wind — chestplate enchantment (Very Rare, max I). Survival burst on critical health. Cooldown 60 sec.

v2.2.0 2026-03-27 +1 enchantment

Added: Feedback — shield enchantment (Rare, max I). Cancels magic damage, purges effects, restores durability.

Fixed: Vegetation — reliable replanting on the next server tick; 0.5 sec seedling protection.

v2.1.0 2026-03-27 +1 enchantment

Added: Rebound — shield enchantment (Rare, max III). Knocks attacker back on block.

v2.0.0 2026-03-27 +1 enchantment

Added: Vegetation — hoe enchantment (Rare, max III). Auto-replant on harvest.

v1.9.0 2026-03-26 +1 enchantment

Added: Auto Smelt — pickaxe enchantment (Rare, max I). Auto-smelts ore drops and grants smelting XP.

v1.7.0 2026-03-26 +1 enchantment

Added: Magnet — tool enchantment (Rare, max I). Auto-pickup within 5 blocks.

v1.6.0 2026-03-26 +1 enchantment

Added: Shadow Blade — trident enchantment (Very Rare, max III). Teleport behind target + Slowness II.

v1.5.0 2026-03-26 +1 enchantment

Added: Lumberjack — axe enchantment (Rare, max III). Full tree felling on one hit.

v1.4.0 2026-03-26 +1 enchantment

Added: Poison Blade — sword/axe enchantment (Rare, max III).

v1.3.0 2026-03-26 +1 enchantment

Added: Drill — pickaxe/shovel enchantment (Very Rare, max I). 3×3 area mining.

v1.1.0 2026-03-25 +1 enchantment

Added: Double Jump — boots enchantment. Cloth Config integration, Mod Menu. Mod renamed.

v1.0.0 2026-03-25 Initial release

Added: Glow Strike — first enchantment. Librarian trades, EN/RU localization.