Custom Enchants 3.1.1 — Minecraft 1.21.11

Custom Enchants 3.1.1 — Minecraft 1.21.11

Compatibility: Fabric, Minecraft 1.21.11, Java 21. Required: Fabric Loader >=0.19.3, Fabric API >=0.141.6+1.21.11, Cloth Config >=21.11.153. Mod Menu >=17.0.0 is optional.

Install custom-enchants-3.1.1-mc1.21.11.jar in mods/. Source branch: 3.1/1.21.11 (d3cb2b4adef92e297145f6b3bfce6d2bc28edabf); verified by CI run 31195503639.

Highlights: the maintained 1.21.11 port with final config UI, Magnet and Auto Smelt fixes, Shadow Blade and Sky Rage fixes, authoritative Double Jump, Feedback/XP Syphon verification, and runtime/mixin compatibility fixes.

Documentation: https://sqwiziiy.github.io/Custom-Enchants/ · Issues: https://github.com/sqwiziiy/Custom-Enchants/issues

Custom Enchants 3.1.1 — Minecraft 1.21.1

Custom Enchants 3.1.1 — Minecraft 1.21.1

Compatibility: Fabric, Minecraft 1.21.1, Java 21. Required: Fabric Loader >=0.19.3, Fabric API >=0.116.15+1.21.1, Cloth Config >=15.0.140. Mod Menu >=11.0.4 is optional.

Install custom-enchants-3.1.1-mc1.21.1.jar in mods/. Source branch: 3.1/1.21.1 (ed9e7f2a0ce8c5615f4f1cfd542051413844ac40); verified by CI run 31195503726.

Highlights: final config UI, Magnet and Auto Smelt fixes, safe Shadow Blade teleport, Sky Rage restrictions, authoritative Double Jump, Feedback and XP Syphon verification, plus runtime/mixin compatibility fixes for the 1.21.1 port.

Documentation: https://sqwiziiy.github.io/Custom-Enchants/ · Issues: https://github.com/sqwiziiy/Custom-Enchants/issues

Custom Enchants 3.1.1 — Minecraft 1.20.1

Custom Enchants 3.1.1 — Minecraft 1.20.1

Compatibility: Fabric, Minecraft 1.20.1, Java 17. Required: Fabric Loader >=0.18.4, Fabric API >=0.92.7+1.20.1, Cloth Config >=11.1.118. Mod Menu >=7.2.2 is optional.

Install custom-enchants-3.1.1.jar in mods/. Source branch: 3.1/1.20.1 (ce81f102fcbda31f11daf02b3713542d4c285637); verified by CI run 31195502342 (tests, check, build, release-JAR contract, 4/4 GameTests, dedicated-server smoke).

Highlights: final config UI; linked-drop Magnet fixes; resolved-loot Auto Smelt fixes; safe Shadow Blade teleport; Sky Rage item restrictions; authoritative Double Jump movement and sprint impulse; Feedback fixes; XP Syphon verification; runtime/mixin compatibility fixes.

Known limitation: on complex real-tree layouts, Magnet + Lumberjack can leave some secondary drops nearby. The release contract permits no loss or duplication.

Documentation: https://sqwiziiy.github.io/Custom-Enchants/ · Issues: https://github.com/sqwiziiy/Custom-Enchants/issues

Custom Enchants 3.1.0 — Minecraft 1.20.1

Custom Enchants 3.1.0 for Minecraft 1.20.1

Build and compatibility

• Synchronized the Java 17, Minecraft 1.20.1 and Fabric metadata baseline.
• Stabilized Gradle/Loom packaging with release-JAR verification and dedicated-server smoke coverage.
• Added GitHub Actions CI with dependency warm-up retry, unit/contract tests, GameTest and server smoke.

Correctness and safety

• Hardened configuration validation, normalization and atomic persistence.
• Safe Drill/Lumberjack block breaking and Auto Smelt vanilla-loot transformation.
• Shot-time projectile context snapshots, confirmed shield-block handling and safe Shadow Blade destinations.
• Lifecycle/multiplayer state cleanup and bounded state/memory behavior.

Major behavior changes

• Feedback requires a real front-facing active shield block; Rebound only reacts to confirmed blocks.
• Magnet respects ownership and pickup delay; Kinetic Discharge does not repair old Elytra damage.
• Sculk Bloom uses the captured direct lethal weapon context.
• Double Jump is server-approved with one activation per airtime.

Tests

• 62 JUnit/contract tests, 2 official Fabric GameTests, release-JAR contract and dedicated-server smoke.

Custom Enchants 3.1.0 — Minecraft 1.21.1

Custom Enchants 3.1.0 for Minecraft 1.21.1

Compatibility

• Minecraft 1.21.1
• Fabric Loader >=0.19.3
• Fabric API >=0.116.15+1.21.1
• Java >=21

Release coordinates

• Release line: 3.1
• Minecraft branch: 3.1/1.21.1
• Minecraft version: 1.21.1
• Mod version: 3.1.0
• Release tag: v3.1.0-mc1.21.1

Port highlights

Custom Enchants 3.1.0 is now available for Minecraft 1.21.1 on Java 21. This is a full
compatibility port of the stable 1.20.1 release (v3.1.0), moving through Minecraft's
data-driven enchantment rewrite: all 19 enchantments now ship as
data/custom-enchants/enchantment/*.json definitions with ResourceKey/holder-based lookup,
villager trades run on the 1.21.1 MerchantOffer/ItemCost API, Double Jump and Second Wind
networking use typed CustomPayload, and all 19 mixins were re-verified against Minecraft
1.21.1's Mojang-mapped classes.

Gameplay parity

A full parity audit compared every enchantment, all 44 librarian trade offers, and the
complete configuration schema against the 1.20.1 baseline. Result: zero gameplay
regressions. Every enchanted item's supported items, max level, cost curve, weight, anvil
cost, and conflict set match 1.20.1 exactly; every trade offer's price, tier, uses and XP
match exactly; the config schema is byte-identical (existing 1.20.1 config files load
unchanged, no manual migration needed). No gameplay balance was changed as part of this port.
See docs/ports/1.21.1/FINAL_PARITY_MATRIX.md in the source repository for the full
mechanic-by-mechanic evidence.

Installation

Download custom-enchants-3.1.0-mc1.21.1.jar from the GitHub release and place it in the
Fabric mods/ directory.

Required dependencies

Fabric Loader >=0.19.3, Fabric API >=0.116.15+1.21.1, Cloth Config >=15.0.140
and Java >=21.

Optional dependencies

Mod Menu >=11.0.4 provides the optional client configuration UI.

Verification

The release is checked by 70 JUnit/contract tests, 5 official Fabric GameTests
(including runtime proof that all 19 enchantments resolve in the live registry, that the
melee combat hook applies a representative effect, and that projectile enchantment context
is a true shot-time snapshot surviving a weapon switch before impact), release-JAR contract
verification, isolated dedicated-server smoke, and a full local + remote CI pass.

Known limitations

Interactive client verification (title screen, Mod Menu screen contents, config screen UI,
translations rendering, representative enchantment recognized visually) could not be
performed in this headless build environment. A bounded headless client boot did reach a
live joined world with zero error-level log output, cloth-config/modmenu/custom-enchants
all loading cleanly — strong evidence the client entrypoint, mixins and resources are sound —
but no human/visual confirmation was captured. As with the 1.20.1 release, the complete
survival, protection, multiplayer, reconnect, trade/anvil and client visual matrix remains
partially unverified beyond the automated and headless-runtime evidence described above.

Upgrade notes

The 3.1.0 release for Minecraft 1.21.1 preserves the established enchantment IDs, translation
keys and configuration compatibility baseline from the 1.20.1 release. Existing server
configuration files can be copied over without modification. Worlds/saves are not
cross-compatible between Minecraft 1.20.1 and 1.21.1 — this is a Minecraft engine constraint,
not specific to this mod.

Version 3.0

[3.0.0] - 2026-04-30

Added

• Sculk Bloom — new sword enchantment (rare, max level 2). When killing a mob, sculk spreads at the death location — as if a Sculk Catalyst were placed there.
  • Level I: small sculk bloom (8 charges, 12 spread steps, radius ≈2–3 blocks).
  • Level II: large sculk bloom (20 charges, 28 spread steps, radius ≈4–5 blocks). Can generate sculk veins, sensors, and shriekers following natural sculk propagation rules.
• Librarian trades: Sculk Bloom I (tier 4, 30 emeralds), II (tier 5, 50 emeralds).

Version 2.9

[2.9.0] - 2026-03-28

Added

• Kinetic Discharge — a new enchantment for Elytra (rare, max level 3). Landing on your feet after a fast flight creates a shockwave that knocks back mobs.
• Level 1: 3-block radius, weak knockback.
• Level 2: 5-block radius, moderate knockback.
• Level 3: 7-block radius + 2 damage to all mobs hit. Shockwave has a 10% chance to drain Elytra durability when activated (90% chance to avoid the drain). Passive: During flight, 90% of Elytra durability damage is negated (≈−90% of the drain).
• Trade with the Librarian: Kinetic Discharge I (Tier 4, 28 emeralds), II (Tier 5, 44 emeralds), III (Tier 5, 62 emeralds).

Fixed

• Feedback — This enchantment now fully protects against magic-type damage, including instant damage (arrows and potions of harm). Previously, the shield only blocked persistent negative effects, but instant damage (DamageTypes.MAGIC) was still applied. Now:
• Magic-type damage is canceled by hurt() before it deals damage.
• All active negative effects are cleared.
• Shield durability is partially restored as a block bonus.

Version 2.8

[2.8.0] - 2026-03-28

Added

• XP Syphon — new sword enchantment (uncommon, max level 3). Hits on mobs have a chance to drop XP orbs before the mob dies.
  • Level I: 5% chance, 1 XP.
  • Level II: 10% chance, 2 XP.
  • Level III: 15% chance, 3 XP.
• Librarian trades: XP Syphon I (tier 2, 14 emeralds), II (tier 3, 26 emeralds), III (tier 4, 40 emeralds).

Fixed

• Feedback — complete rework of negative effect protection:
  • On any blocked hit, ALL currently-active harmful effects are now cleared (including pre-existing ones).
  • Added forceAddEffect interception — some effects previously bypassed the protection.

---

Version 2.7

[2.7.0] - 2026-03-28

Added

• Sky Rage enchantment for bows and crossbows (rare, max level 3). During a thunderstorm, arrows have a chance to call a lightning strike at the hit location.
  • Level I: 10% chance.
  • Level II: 20% chance.
  • Level III: 30% chance.
  • Only activates during a thunderstorm (not plain rain).
  • Does not work under a roof (sky exposure required).
  • Per-player cooldown: 1.5 seconds (30 ticks) between strikes.
  • Incompatible with: Flame, Infinity, Piercing.
  • Available from enchanting table and villager trades.
• Librarian trades: Sky Rage I (tier 3, 22 emeralds), II (tier 4, 38 emeralds), III (tier 5, 55 emeralds).
• Config options: enable/disable, cooldown ticks.

---

Version 2.6

[2.6.0] - 2026-03-28

Added

• Tether Master enchantment for fishing rods (uncommon, max level 3). Increases the pull strength when reeling in hooked mobs.
  • Level I: +15% pull strength.
  • Level II: +25% pull strength.
  • Level III: +40% pull strength.
  • Available from enchanting table and villager trades.
• Librarian trades: Tether Master I (tier 1, 10 emeralds), II (tier 3, 22 emeralds), III (tier 4, 36 emeralds).
• Config option: enable/disable enchantment.

Changed

• Shadow Blade is now compatible with Loyalty again. A trident with both enchantments will teleport the player on throw and return as normal.

---