Overview#
Grind Enchantments is a quality-of-life mod designed to expand the utility of the vanilla Grindstone. While the vanilla Grindstone is limited to stripping enchantments for a small amount of experience, this mod transforms it into a powerful enchantment management station. Players can now salvage valuable enchantments from loot, separate multiple enchantments from a single book, and even reset the 'Too Expensive!' anvil repair cost of their favorite gear.
Key Features
- Non-Destructive Disenchanting: Move enchantments from tools, weapons, or armor onto a standard book.
- Enchantment Separation: Split multiple enchantments on a single book into separate books.
- Repair Cost Reset: Use catalysts to wipe the accumulated anvil repair cost from items.
- Experience Integration: Balanced mechanics that require experience levels for transfers.
- Tax Free Levels Support: Full compatibility with the Tax Free Levels mod to prevent exponential XP scaling.
Mechanics#
The mod introduces three primary mechanics to the Grindstone interface. Each operation typically consumes experience levels and specific items.
1. Disenchanting to Book
This mechanic allows you to strip all enchantments from an item and store them in a book. Unlike the vanilla behavior, the item is not destroyed and its enchantments are preserved in book form.
- Top Slot: Enchanted Item (Sword, Pickaxe, Armor, etc.)
- Bottom Slot: Normal Book
- Result: Unenchanted Item + Enchanted Book (containing all enchantments from the original item).
2. Moving Enchantments Between Books
Useful for separating enchantments that are incompatible or intended for different items (e.g., a book with both Efficiency and Protection).
- Top Slot: Enchanted Book (Source)
- Bottom Slot: Normal Book or Enchanted Book (Target)
- Result: The topmost enchantment from the source book is moved to the target book. The source book remains with its remaining enchantments.
3. Resetting Anvil Repair Cost
Over time, repairing or enchanting an item in an anvil increases its "Repair Cost" NBT tag, eventually making it "Too Expensive" to modify. This mod allows you to reset that cost using a catalyst.
- Top Slot: Item with high repair cost.
- Bottom Slot: Catalyst Item (Default: Diamond).
- Result: The item is returned with its repair cost reset to zero. The catalyst is consumed.
Blocks and Items#
Grind Enchantments does not add new blocks or items but significantly modifies the functionality of existing vanilla assets.
Modified Blocks
| Block | Modification |
|---|---|
| Grindstone | Updated GUI logic to recognize Books and Catalysts in the bottom slot. Enables disenchanting and transfer logic. |
Key Items
| Item | Role in Mod |
|---|---|
| Book | Used as the vessel for extracted enchantments. |
| Enchanted Book | Acts as either a source of enchantments or a target for transfers. |
| Diamond | The default Catalyst item used to reset anvil repair costs. |
Catalyst Items
By default, only the Diamond is recognized as a catalyst. However, this is fully configurable. Only items that are non-damageable and non-enchanted can be designated as catalysts to prevent conflicts with other mod features.
Experience and Costs#
Operations performed in the Grindstone are not free. The mod calculates an XP cost based on the level and rarity of the enchantments being moved.
- Cost Calculation: The mod can be configured to use either the sum of enchantment levels (
count_levels) or the minimum enchanting table power (count_min_power) to determine the final level cost. - Vanilla Experience: By default, the mod disables the vanilla "XP back" feature when using these new mechanics, as the value of salvaging the enchantment outweighs the small XP gain from destroying it.
Configuration#
The mod is highly customizable via configuration files located in .minecraft/config/grindenchantments/. In version 1.20.1, these are typically split into server.json and client.json.
| Option | Default | Description |
|---|---|---|
disenchant_cost_factor |
1.0 | Multiplier for the XP cost of disenchanting items. |
transfer_cost_factor |
1.0 | Multiplier for the XP cost of moving enchantments between books. |
allow_treasure_enchantments |
true | Whether treasure enchantments (like Mending) can be moved. |
allow_curse_enchantments |
false | Whether curses can be moved to books. |
grindstone_experience |
false | If true, players still receive vanilla XP orbs when disenchanting. |
only_take_first |
false | If true, disenchanting an item only takes the first enchantment instead of all. |
catalyst_items |
["minecraft:diamond"] |
List of items that can be used to reset anvil repair costs. |
reset_repair_cost |
false | Enables the anvil repair cost reset feature. |
Client Configuration (client.json)
| Option | Default | Description |
|---|---|---|
show_cost_in_gui |
true | Displays the required XP level directly in the Grindstone interface. |
show_cost_in_tooltip |
true | Shows the transfer cost when hovering over items in the Grindstone. |
Technical Details#
Compatibility
- Fabric API: Required for the mod to function.
- Tax Free Levels: Highly recommended. This mod ensures that the XP cost for disenchanting and transferring remains fair and does not suffer from the exponential scaling of vanilla anvil mechanics.
- Modded Enchantments: Fully compatible with enchantments added by other mods. They will be treated according to their rarity and level during cost calculation.
License
Grind Enchantments is licensed under the GNU Lesser General Public License v3.0 (LGPL-3.0). Users are free to redistribute and modify the software under the terms of this license.
