Mentalitys | Custom Enchantments

Русская версия

A Minecraft 1.20.1 mod for Fabric API that adds unique enchantments with flexible configuration via Cloth Config API.

---

Enchantments

⚔️ Glow Strike

A weapon enchantment for swords, axes, and tridents. On hit, applies the Glowing effect to the target, making them visible through walls.

Level	Duration	Ticks
I	2 sec	40
II	4 sec	80
III	7 sec	140

• Rarity: Rare
• Max level: 3
• Incompatible with Knockback; when applied to a trident — also incompatible with Shadow Blade
• Effect only triggers when the attacker is a Player and the target is a LivingEntity
• Duration for each level is configurable

🦘 Double Jump

A boots enchantment. Allows the player to perform a second jump in mid-air.

Level	Effect
I	Double jump

• Rarity: Very Rare
• Max level: 1
• Spawns white particles under the player on double jump
• 67% chance to consume 1 durability from boots (Unbreaking enchantment reduces this chance)
• Only works when not in water or lava
• Can be enabled/disabled via config

⛏️ Drill

A tool enchantment for pickaxes and shovels. Breaks blocks in a 3×3 area around the center block.

Level	Effect
I	3×3 mining

• Rarity: Very Rare
• Max level: 1
• Disabled while sneaking (Shift) — allows precise single-block mining
• The 3×3 plane is determined by the face of the block being mined
• Consumes 1 durability per extra block broken (Unbreaking applies)
• Only breaks blocks appropriate for the tool; unbreakable blocks (bedrock, etc.) are skipped
• Can be enabled/disabled via config

🗡️ Poison Blade

A weapon enchantment for swords and axes. On hit, applies the Poison effect to the target.

Level	Duration
I	2 sec
II	3 sec
III	4 sec

• Rarity: Rare
• Max level: 3
• Incompatible with Fire Aspect
• Effect only triggers when the attacker is a Player and the target is a LivingEntity
• Duration for each level is configurable
• Can be obtained from enchanting table and villager trades

🪵 Lumberjack

An axe enchantment. Chops down an entire tree by breaking one log block. Smart detection ensures only natural tree logs are felled — won't break player-built structures.

Level	Tree Size	Max Blocks
I	Small trees	16
II	Medium trees	48
III	Large trees	128

• Rarity: Rare
• Max level: 3
• Only breaks log blocks of the same type (oak, birch, spruce, crimson, warped, etc.)
• Does not work on _wood or hyphae blocks (crafted full-bark blocks from the sawmill/crafting)
• Works with Nether trees (crimson and warped stems)
• Verifies the block is part of a natural tree (checks for leaves or wart blocks at the top)
• Does not break below the original block (safe for log walls)
• Consumes 1 durability per log broken (Unbreaking applies)
• Can be enabled/disabled via config; max blocks per level are configurable

🗡️ Shadow Blade

A trident enchantment. On hit, has a chance to teleport the player behind the target and apply Slowness II to the target.

Level	Chance	Slowness Duration
I	15%	1 sec
II	25%	2 sec
III	35%	3 sec

• Rarity: Very Rare
• Max level: 3
• Incompatible with Channeling, Riptide, and Glow Strike
• Teleports the player 1.5 blocks behind the target entity, facing it
• Distance bonus: up to +10% chance when thrown from 30 blocks away (linear scaling)
• Chance and slowness duration are configurable per level
• Can be obtained from enchanting table and villager trades

🧲 Magnet

A tool enchantment for pickaxes, axes, shovels, and hoes. When mining blocks, items within a configurable radius are automatically picked up into the player's inventory.

Level	Effect
I	Auto-pickup within 5 blocks

• Rarity: Rare
• Max level: 1
• Works with Drill and Lumberjack — collects all drops from additional blocks
• Pickup radius is configurable (default: 5 blocks)
• Can be obtained from enchanting table and villager trades
• Can be enabled/disabled via config

🔥 Auto Smelt

A pickaxe enchantment. When mining ores that require smelting, automatically drops the smelted result instead of raw ore.

Level	Effect
I	Auto-smelts iron, gold, copper ores

• Rarity: Rare
• Max level: 1
• Only applies to ores that have a smelting recipe (iron, gold, copper ores and their deepslate variants)
• Grants smelting XP on smelt
• Incompatible with Fortune
• Can be obtained from enchanting table and villager trades
• Can be enabled/disabled via config

🌱 Vegetation

A hoe enchantment. When breaking a mature crop, has a chance to auto-replant it.

Level	Chance
I	30%
II	60%
III	100%

• Rarity: Rare
• Max level: 3
• Works with wheat, carrots, potatoes, beetroot, and nether wart
• Replants on the next server tick after harvest
• Freshly replanted crops are protected from accidental breaking for 0.5 sec
• Chance per level is configurable
• Can be obtained from enchanting table and villager trades
• Can be enabled/disabled via config

🛡️ Rebound

A shield enchantment. When blocking a melee attack, knocks the attacker back and gives the player a small backwards impulse.

Level	Knockback Strength
I	0.5
II	1.0
III	2.0

• Rarity: Rare
• Max level: 3
• Does not deal damage
• Consumes extra shield durability (1 per level)
• The player also receives a small self-knockback (15% of attacker knockback)
• Knockback strength per level is configurable
• Incompatible with Feedback and Guardian's Grace
• Can be obtained from enchanting table and villager trades
• Can be enabled/disabled via config

🛡️ Feedback

A shield enchantment. When blocking a magical attack (harming potions, harming arrows, shulker bullets, etc.), fully cancels the incoming damage, restores shield durability, and clears all active harmful effects (poison, instant damage, slowness, etc.) while the shield is raised. Also prevents new harmful effects from being applied while blocking.

Level	Effect
I	Cancel magic damage, purge effects, restore durability

• Rarity: Rare
• Max level: 1
• Fully blocks instant damage from harming potions/arrows (fix v2.9)
• Cancels magic damage inside hurt() before it is applied
• Purges all currently-active harmful effects on magic block
• Shield durability is partially restored as a bonus for blocking
• Durability restoration amount is configurable
• Incompatible with Rebound and Guardian's Grace
• Can be obtained from enchanting table and villager trades
• Can be enabled/disabled via config

🪱 Second Wind

A chestplate enchantment. When the player's health drops below 1 heart (2 HP), instantly grants a burst of survival effects. The duration of effects scales with how many armor pieces have the enchantment.

Pieces enchanted	Speed II duration	Resistance I duration
1	2 sec	1 sec
2	3 sec	1 sec
3	3 sec	2 sec
4	4 sec	2 sec

• Rarity: Very Rare
• Max level: 1
• Can be applied to helmet, chestplate, leggings, and boots
• Triggers when health ≤ 2.0 HP (1 heart)
• Grants Speed II, Damage Resistance I, and 100% knockback resistance
• Visual effects: smoke and cloud particles (no screen overlay)
• Cooldown: 60 seconds (configurable)
• Can be obtained from enchanting table and villager trades
• Can be enabled/disabled via config

🛡️ Guardian's Grace

A shield enchantment. When successfully blocking an attack, has a chance to convert part of the blocked damage into food (saturation restore). At max level, also rarely heals the player.

Level	Food Restore Chance	Bonus
I	10%	—
II	20%	—
III	30%	+10% to heal 1 heart

• Rarity: Rare
• Max level: 3
• Restores 1 food point (half a visual drumstick) on proc
• Level III: additional 10% chance to heal 2 HP (1 heart)
• Chances per level are configurable
• Incompatible with Rebound and Feedback
• Can be obtained from enchanting table and villager trades
• Can be enabled/disabled via config

---

🎯 Vulnerability

A bow and crossbow enchantment. Arrows from this bow partially ignore the target's armor value, piercing through protection.

Level	Armor Ignore
I	10%
II	20%
III	30%

• Rarity: Rare
• Max level: 3
• Works with regular arrows, fire arrows, and other projectile types
• Reduces the effective armor and toughness values when calculating damage
• Percentage per level is configurable
• Can be obtained from enchanting table and villager trades
• Can be enabled/disabled via config

🎣 Tether Master

A fishing rod enchantment. Increases the pull strength when reeling in hooked mobs.

Level	Pull Strength
I	+15%
II	+25%
III	+40%

• Rarity: Uncommon
• Max level: 3
• Works on any mob hooked by the fishing rod
• Can be obtained from enchanting table and villager trades
• Can be enabled/disabled via config

⚡ Sky Rage

A bow and crossbow enchantment. During a thunderstorm, arrows have a chance to summon a lightning strike at the hit location.

Level	Chance
I	10%
II	20%
III	30%

• Rarity: Rare
• Max level: 3
• Only activates during a thunderstorm (not plain rain)
• Does not work under a roof — the hit position must be sky-exposed
• Per-player cooldown: 1.5 seconds (30 ticks) between strikes
• Incompatible with: Flame, Infinity, Piercing
• Can be obtained from enchanting table and villager trades
• Can be enabled/disabled via config

✨ XP Syphon

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

Level	Chance	XP
I	5%	1
II	10%	2
III	15%	3

• Rarity: Uncommon
• Max level: 3
• Works on any mob including bosses
• Can be obtained from enchanting table and villager trades
• Can be enabled/disabled via config

💥 Kinetic Discharge

An elytra enchantment. Landing on the ground after fast elytra flight creates a shockwave that knocks back nearby mobs. Wave strength depends on enchantment level.

Level	Radius	Effect
I	3 blocks	Weak knockback
II	5 blocks	Medium knockback
III	7 blocks	Strong knockback + 2 HP damage to all hit entities

• Rarity: Rare
• Max level: 3
• Only triggers when landing speed ≥ 0.4 blocks/tick (configurable)
• Level III (passive): during flight, 90% of durability ticks are refunded (≈−90% elytra wear)
• Level III: shockwave activation has only a 10% chance to cost durability (90% free)
• Visual effect: central explosion particle + ring of poof particles at wave radius
• All parameters (speed threshold, knockback, damage) are configurable
• Can be obtained from enchanting table and villager trades
• Can be enabled/disabled via config

🌑 Sculk Bloom

A sword enchantment. When you kill a mob, sculk spreads at the death location — as if a Sculk Catalyst were placed there.

Level	Effect
I	Small sculk bloom (≈2–3 block radius)
II	Large sculk bloom (≈4–5 block radius)

• Rarity: Rare
• Max level: 2
• Works only on direct kills made with the enchanted weapon
• Can convert soil, stone, and other blocks to sculk following natural propagation rules
• May generate sculk veins, sensors, or shriekers
• Can be obtained from enchanting table and villager trades
• Can be enabled/disabled via config

---

Obtaining

Enchanted books can be purchased from Librarian villagers:

Enchantment	Villager Tier	Price
Glow Strike I	Novice (1)	10 Emeralds
Glow Strike II	Journeyman (3)	28 Emeralds
Glow Strike III	Master (5)	48 Emeralds
Double Jump I	Expert (4)	38 Emeralds
Drill I	Master (5)	50 Emeralds
Poison Blade I	Novice (1)	12 Emeralds
Poison Blade II	Journeyman (3)	30 Emeralds
Poison Blade III	Master (5)	50 Emeralds
Lumberjack I	Apprentice (2)	14 Emeralds
Lumberjack II	Expert (4)	32 Emeralds
Lumberjack III	Master (5)	52 Emeralds
Shadow Blade I	Apprentice (2)	16 Emeralds
Shadow Blade II	Expert (4)	34 Emeralds
Shadow Blade III	Master (5)	54 Emeralds
Magnet I	Journeyman (3)	24 Emeralds
Auto Smelt I	Expert (4)	32 Emeralds
Vegetation I	Apprentice (2)	14 Emeralds
Vegetation II	Expert (4)	30 Emeralds
Vegetation III	Master (5)	48 Emeralds
Rebound I	Apprentice (2)	16 Emeralds
Rebound II	Expert (4)	32 Emeralds
Rebound III	Master (5)	50 Emeralds
Feedback I	Journeyman (3)	22 Emeralds
Second Wind I	Master (5)	52 Emeralds
Guardian's Grace I	Apprentice (2)	16 Emeralds
Guardian's Grace II	Expert (4)	32 Emeralds
Guardian's Grace III	Master (5)	50 Emeralds
Vulnerability I	Apprentice (2)	18 Emeralds
Vulnerability II	Expert (4)	36 Emeralds
Vulnerability III	Master (5)	52 Emeralds
Tether Master I	Novice (1)	10 Emeralds
Tether Master II	Journeyman (3)	22 Emeralds
Tether Master III	Expert (4)	36 Emeralds
Sky Rage I	Journeyman (3)	22 Emeralds
Sky Rage II	Expert (4)	38 Emeralds
Sky Rage III	Master (5)	55 Emeralds
XP Syphon I	Apprentice (2)	14 Emeralds
XP Syphon II	Journeyman (3)	26 Emeralds
XP Syphon III	Expert (4)	40 Emeralds
Kinetic Discharge I	Expert (4)	28 Emeralds
Kinetic Discharge II	Master (5)	44 Emeralds
Kinetic Discharge III	Master (5)	62 Emeralds
Sculk Bloom I	Expert (4)	30 Emeralds
Sculk Bloom II	Master (5)	50 Emeralds

All enchantments can also be obtained from the enchanting table.

---

Configuration (Cloth Config)

The mod supports configuration via Cloth Config API. Config file: config/custom-enchants.json.

Parameters

Parameter	Default	Description
glowStrikeEnabled	true	Enable/disable Glow Strike
glowStrikeDurationL1	40	Level I duration (ticks)
glowStrikeDurationL2	80	Level II duration (ticks)
glowStrikeDurationL3	140	Level III duration (ticks)
doubleJumpEnabled	true	Enable/disable Double Jump
drillEnabled	true	Enable/disable Drill
poisonBladeEnabled	true	Enable/disable Poison Blade
poisonBladeDurationL1	40	Level I duration (ticks)
poisonBladeDurationL2	60	Level II duration (ticks)
poisonBladeDurationL3	80	Level III duration (ticks)
lumberjackEnabled	true	Enable/disable Lumberjack
lumberjackMaxBlocksL1	16	Max blocks Level I
lumberjackMaxBlocksL2	48	Max blocks Level II
lumberjackMaxBlocksL3	128	Max blocks Level III
shadowBladeEnabled	true	Enable/disable Shadow Blade
shadowBladeChanceL1	15	Chance Level I (%)
shadowBladeChanceL2	25	Chance Level II (%)
shadowBladeChanceL3	35	Chance Level III (%)
shadowBladeSlowDurationL1	20	Slowness duration Level I (ticks)
shadowBladeSlowDurationL2	40	Slowness duration Level II (ticks)
shadowBladeSlowDurationL3	60	Slowness duration Level III (ticks)
magnetEnabled	true	Enable/disable Magnet
magnetRadius	5	Pickup radius (blocks)
autoSmeltEnabled	true	Enable/disable Auto Smelt
vegetationEnabled	true	Enable/disable Vegetation
vegetationChanceL1	30	Chance Level I (%)
vegetationChanceL2	60	Chance Level II (%)
vegetationChanceL3	100	Chance Level III (%)
reboundEnabled	true	Enable/disable Rebound
reboundKnockbackL1	5	Knockback Level I (×0.1)
reboundKnockbackL2	10	Knockback Level II (×0.1)
reboundKnockbackL3	20	Knockback Level III (×0.1)
feedbackEnabled	true	Enable/disable Feedback
feedbackHealAmount	2.0	Heal amount (HP)
feedbackRepairAmount	2	Durability restored
secondWindEnabled	true	Enable/disable Second Wind
secondWindSpeedDuration	5	Speed II duration (seconds)
secondWindCooldown	60	Cooldown (seconds)
guardiansGraceEnabled	true	Enable/disable Guardian's Grace
guardiansGraceChanceL1	10	Level I chance (%)
guardiansGraceChanceL2	20	Level II chance (%)
guardiansGraceChanceL3	30	Level III chance (%)
vulnerabilityEnabled	true	Enable/disable Vulnerability
vulnerabilityIgnoreL1	10	Armor ignore Level I (%)
vulnerabilityIgnoreL2	20	Armor ignore Level II (%)
vulnerabilityIgnoreL3	30	Armor ignore Level III (%)
tetherMasterEnabled	true	Enable/disable Tether Master
skyRageEnabled	true	Enable/disable Sky Rage
skyRageCooldownTicks	30	Cooldown between strikes (ticks)
xpSyphonEnabled	true	Enable/disable XP Syphon
kineticDischargeEnabled	true	Enable/disable Kinetic Discharge
kineticDischargeMinSpeed	0.4	Min flight speed to trigger (blocks/tick)
kineticDischargeKnockbackL1	1.5	Knockback strength Level I
kineticDischargeKnockbackL2	2.5	Knockback strength Level II
kineticDischargeKnockbackL3	3.5	Knockback strength Level III
kineticDischargeDamageL3	2.0	Bonus damage at Level III (HP)
sculkBloomEnabled	true	Enable/disable Sculk Bloom

---

Project Structure

src/main/java/com/mentality/customenchants/
├── CustomEnchantsMod.java         — Main mod class, trade registration
├── config/
│   ├── ModConfig.java             — JSON config load/save
│   └── ModConfigScreen.java       — GUI settings screen (Cloth Config)
└── enchantment/
    ├── ModEnchantments.java       — Enchantment registration
    ├── GlowStrikeEnchantment.java — Glow Strike logic
    ├── DoubleJumpEnchantment.java — Double Jump definition
    ├── DoubleJumpServerHandler.java — Server-side double jump + durability
    ├── DrillEnchantment.java      — Drill definition
    ├── DrillHandler.java          — Server-side 3×3 mining logic
    ├── PoisonBladeEnchantment.java — Poison Blade logic
    ├── LumberjackEnchantment.java — Lumberjack definition
    ├── LumberjackHandler.java     — Server-side tree felling logic
    ├── ShadowBladeEnchantment.java — Shadow Blade logic
    ├── MagnetEnchantment.java     — Magnet definition
    ├── MagnetHandler.java         — Server-side auto-pickup logic
    ├── AutoSmeltEnchantment.java  — Auto Smelt definition
    ├── AutoSmeltHandler.java      — Server-side auto-smelt logic
    ├── VegetationEnchantment.java — Vegetation definition
    ├── VegetationHandler.java     — Server-side auto-replant logic
    ├── ReboundEnchantment.java    — Rebound definition
    ├── FeedbackEnchantment.java   — Feedback definition
    ├── SecondWindEnchantment.java  — Second Wind definition (all armor slots)
    ├── SecondWindHandler.java      — Server-side second wind logic (scales by piece count)
    ├── GuardiansGraceEnchantment.java — Guardian's Grace definition
    ├── XpSyphonEnchantment.java   — XP Syphon definition
    ├── KineticDischargeEnchantment.java — Kinetic Discharge definition
    ├── KineticDischargeHandler.java — Server-side shockwave on landing logic
    ├── SculkBloomEnchantment.java — Sculk Bloom definition
    ├── SculkBloomHandler.java     — Server-side sculk spreading on kill logic
    └── ModEnchantments.java       — Enchantment registration

src/client/java/com/mentality/customenchants/
├── CustomEnchantsClient.java      — Client initializer
├── config/
│   └── ModConfigScreen.java       — GUI settings screen (Cloth Config)
└── enchantment/
    ├── DoubleJumpHandler.java     — Client-side double jump logic
    └── SecondWindClientHandler.java — Client-side second wind effects

---

Requirements

• Minecraft 1.20.1
• Fabric Loader ≥ 0.18.4
• Fabric API
• Cloth Config API ≥ 11.0.0
• Java 21+

Building

./gradlew build

The compiled jar will be in build/libs/.

License

CC0-1.0