📢 Overview

Ever lost valuable enchantments by mistake at a Grindstone?

GrindEnchantments lets players selectively extract enchantments one by one from items or enchanted books, saving them safely onto Books — without commands, GUIs, or complexity.

✨ Key Features

• 🖱️ Intuitive Interaction: No complex commands or GUIs. Just open the Grindstone, place your enchanted item, and click a Book in your inventory!
• 💎 Extract One by One: Extracts enchantments one at a time, giving you full control over what you want to keep.
• 📚 Book Splitting: Have a book with "Sharpness V" and "Protection IV"? Use this plugin to split them into two separate books.
• ⚙️ Fully Configurable: Customize XP costs, blacklist specific enchantments (like Curses), or decide if the source item should be destroyed.
• 🚀 High Performance: Built with Kotlin and optimized for 1.14+.

🎮 How to Use

1. Open the standard Grindstone interface.
2. Place the Enchanted Item (or Enchanted Book) in the Top Input Slot.
3. Ensure you have a Book and enough XP in your inventory.
4. Click the Book inside your inventory.
5. Success! An enchantment is extracted from the item onto the book.

⚠️ Important: You must click the Book inside your inventory, not the Grindstone result slot.

📜 Commands & Permissions

Command	Description	Permission
/ge reload	Reloads the configuration file	grindenchantments.admin
(Interaction)	Use enchantment extraction	grindenchantments.use

• Aliases: /grindenchantments, /grind, /ge
• Note: grindenchantments.use is enabled for all players by default.

⚙️ Configuration

Customize the plugin to fit your server's economy and balance.

# ==========================================
# GrindEnchantmentsPlugin Configuration
# ==========================================

# If true, extracting enchantments will cost Experience Levels.
require-xp: true

# The cost in XP Levels per enchantment extracted.
# Example: If an item has 3 enchantments and this is set to 5, it costs 15 Levels.
xp-cost-per-enchantment: 5

# If true, the source item (Sword/Tool/Armor) is DESTROYED after extraction.
# If false, the source item is returned with its enchantments removed (stripped).
destroy-source-item: false

# Success Rate of Extraction (0 - 100)
# 100 = Guaranteed to succeed
# 80  = 20% chance of failure, resulting in loss of book and XP
success-rate: 100

# A list of enchantments that cannot be extracted.
# Use the namespaced key format (e.g., minecraft:binding_curse).
blacklisted-enchantments:
  - minecraft:binding_curse
  - minecraft:vanishing_curse

Example Use Cases

• 💰 Survival Economy: Set high XP cost to prevent abuse.
• ⚔️ RPG Servers: Disable extraction of Mending or custom enchants.
• 🛠️ Casual SMP: Low XP cost, keep source items intact.

📈 bStats

❤️ Credits & Inspiration

This plugin implements the functionality of the Grind Enchantments mod for Spigot/Paper servers. A huge thank you to the original mod author for the brilliant concept and inspiration!

If you are looking for the client-side/Forge/Fabric version, please support the original project: 👉 Original Mod: Grind Enchantments