Improved Grindstone

Lightweight Paper 1.21.11 plugin that reroutes grindstone disenchantments into books, with optional cross-material transfer support.

Features

• Slot 0: enchanted source item.

• Slot 1 can be either:

  • A normal book (optionally can be a special book) to extract enchantments into an enchanted book.
  • A compatible target item (same archetype, different material allowed) to transfer enchantments directly.

• Extraction keeps the source item (disenchanted) and gives an enchanted book with removed enchants.

• Transfer keeps the source item (disenchanted) and returns the target item with transferred enchants.

• Optional cursed-enchantment capture toggle.

• Separate XP-cost toggles for extraction and transfer.

• Separate configurable XP percentages (default 50%) based on estimated enchanting-table cost of the moved enchants.

• Commands:

  • /improvedgrindstone toggle
  • /improvedgrindstone status
  • /improvedgrindstone cursed
  • /improvedgrindstone xp
  • /improvedgrindstone transfer
  • /improvedgrindstone transferxp
  • /improvedgrindstone specialbook
  • /improvedgrindstone reload

Configuration

Configure behavior in config.yml:

feature-enabled: true
capture-cursed: true
book-xp-cost-enabled: true
book-xp-cost-percent: 50.0
transfer-enabled: true
transfer-xp-cost-enabled: true
transfer-xp-cost-percent: 50.0
require-special-book: false
special-book-ids: []
max-enchants-per-operation: 16
max-operation-item-bytes: 24576

special-book-ids accepts namespaced IDs (for example dingus:blah).
If special-book-ids is empty, any non-vanilla namespaced marker is accepted (item model, plugin PDC key, or namespaced display name).

max-enchants-per-operation is a safety cap. If a source item has more enchantments than this value, the grindstone operation is blocked to avoid oversized/unstable enchant payload handling. max-operation-item-bytes is an additional safety cap on serialized item size (source/result/bonus). If any item involved exceeds this size, the operation is blocked to prevent unsafe payload handling.

XP-cost notes:

• Vanilla enchantments use their estimated enchanting-table costs.
• Custom enchantments are assigned a rough vanilla-equivalent cost from their level, using the highest matching vanilla cost as the baseline.

Compatibility

Designed for Paper 1.21.11.