Enchantment Storage

Summary

The Enchantment Storage mod adds one new block to Minecraft, the Enchantment Extractor. The purpose of the Enchantment Extractor is to provide a centralized place to store all the enchantments you collect. This mod was born from the frustration of overflowing inventory, chests, & shulker boxes with unstackable enchanted items. So instead of wasting valuable storage space, and spending way too much time organizing enchanted items, now you can remove the enchantments and use them somewhere else. Of course this benefit doesn't come for free. Each transaction of storing or extracting enchantments costs 1 experience level per enchantment level. But, this cost can be reduced, or even nullified, by consuming lapis lazuli. Work smart, not hard. Save space, time, & sanity.

Player Usage

Installation

• Download the Enchantment Storage .jar file.
• Place the enchantment_storage-x.y.z.jar file into your Minecraft mods/ folder.
• Use the same Minecraft version as this mod (1.21.10).
• Ensure Fabric Loader & Fabric API are installed.

Crafting Recipes

There are two valid shaped recipes to craft an Enchantment Extractor, requiring the following materials:

• Obsidian x4
• Lapis Lazuli x2
• Ender Eye x1
• Dragon's Breath or End Crystal x2

GUI Basics

Slot layout

• The top input slot can only hold lapis lazuli.
• The bottom input slot can only hold books, enchanted books, or enchanted items.
• The right slot is output only.

Action buttons

• Store: pulls enchantments from bottom input slot into internal storage.
• Extract: applies selected enchantment onto a book or enchanted book.

NOTE: You cannot extract enchantments directly onto items or tools, only books or enchanted books.

Store & Extract Flow

1. Place lapis lazuli in top input slot.
2. Place an enchanted item or enchanted book in the input slot, then click Store.
3. Select a stored enchantment level from the list.
4. Place a book or enchanted book in bottom input slot, then click Extract.
5. Take result from the output slot.

Experience & Lapis Cost

• Store XP cost = total sum of enchantment levels on input item, book, or enchanted book.
• Extract XP cost = selected enchantment level (Mending costs 1 level, Smite V costs 5 levels).
• Lapis lazuli gives a direct discount of 1 experience level.
• One lapis lazuli is consumed per level discounted.

Compatibility

• This mod is compatible with all "Vanilla" Minecraft enchantments.
• This mod is also compatible with modded, non-"Vanilla" enchantments.

Hopper Behavior

• The top face (UP) is for the lapis lazuli top input slot only.
• The side faces (N/S/E/W) are for the item, book, & enchanted book input slot only.
• The bottom face (DOWN) is for the output slot extraction only.

Debug Commands

Debug commands are dev-only and require permission level 2. Root command: /es

Developer Notes

Gradle

Use.\gradlew <task> to run Gradle wrapper tasks.

Use the --refresh-dependencies flag to force a full Gradle rebuild.

JVM Arguments

• Java version requirement: Java 21
• Global Gradle JVM arguments location: gradle.properties
• Other Gradle dependencies location: build.gradle:

Spotless

.\gradlew spotlessApply
.\gradlew spotlessCheck

Unit Testing

.\gradlew test

Game Testing

.\gradlew runGameTest

Enchantment Registry

• Implemented by the getEnchantmentRegistry() method.
• The purpose is to resolve the enchantment registry from the world registry manager.
• The method returns null when the world is unavailable, so callers must handle nullable results.

Clean Code Guidelines

1. Keep nullability contracts explicit and consistent.
2. Replace magic numbers with named constants.
3. Keep logs structured and low-noise.
4. Keep client-only code out of common/server paths.
5. Keep NBT serialization version-aware and validated.
6. Use one clear registration/bootstrap path.
7. Avoid avoidable allocations in hot UI/render loops.
8. Keep utility classes focused by domain.
9. Move deterministic logic into pure testable helpers.
10. Use consistent naming and verb conventions.
11. Add compatibility guards where APIs/mappings shift.
12. Enforce formatting and static checks in automation.

Source Regions

Unit Test Regions

Repository

Check out the source code on GitHub.

PRs & Issues

• Create a pull request to contribute features and bug fixes.
• If you find a problem with the mod, please create an issue.

Donations

• Venmo: @Lexxeous
• Cash App: $Lexxeous

License

View the license.