Runic Tome

[0.5.0] — 2026-07-11

This update prevents functional modded books and tomes from being mistaken for guidebooks, absorbed, and permanently deleted.

Fixed

• Epic Fight skill books are now always excluded from absorption. Their selected skill is stored in item data that the Runic Tome cannot preserve.
• All Scriptor items are now excluded, preventing functional tomes and spellbooks from being destroyed.
• The #runictome:absorb_blocklist tag is now a true global exclusion respected by every absorption method.
• Improved automatic detection of functional items. Books containing spell data, skill selections, enchantments, durability, or function-related names are no longer treated as guides.
• Corrected outdated and inaccurate configuration details in the README.

Added

• A centralized absorption policy now checks all exclusions before an item can be absorbed.

• Added two global exclusion settings:

  • absorbExclusionItems defaults to ["epicfight:skillbook"]
  • absorbExclusionMods defaults to ["scriptor"]

• Added #runictome:guide_books, allowing modpack creators to explicitly mark items as absorbable guides.

• Added #runictome:absorb_blocklist, allowing any item to be permanently excluded from absorption.

• Previously absorbed items that are now excluded will be removed from player libraries on login. Their original item data cannot be restored, so replacement items are not created.

• /runictome debug identify now explains:

  • Whether the held item can be absorbed
  • Why it was accepted or rejected
  • Whether it contains important item data
  • Which adapter would otherwise recognize it

For Modpack Creators

Exclusions now always take priority:

Global exclusion → Explicit guide definition → Guide tag → Automatic detection

Use #runictome:guide_books to force a valid guidebook to be recognized. Use #runictome:absorb_blocklist or the new global exclusion settings to ensure an item is never absorbed.