Runic Tome 0.2.0

A reliability and feature release for Minecraft 1.20.1 / Forge 47.3.0+.

Highlights

Reliability

• Non-destructive absorption — books are only consumed once confirmed stored in your tome; a failed unlock leaves the item untouched instead of destroying it.
• Corruption-tolerant data — malformed/duplicate entries are skipped on load instead of breaking your save.
• Open-failure feedback — a book that fails to open now tells you why instead of doing nothing.

Features

• Searchable, scrollable library UI with real item icons and an unlocked-book count.
• Favorites — right-click any book to pin it to the top (persisted per player).
• More integrations — Minecraft Comes Alive, Better Animals Plus, Immersive Engineering, Modonomicon, plus a keyword catch-all for unsupported mods.
• Datapack-defined books — declare books in data/<namespace>/runictome/books/*.json; synced to clients on servers.
• Openable IMC books via the new ImcBook payload, and a RunicTomeAPI.API_VERSION constant.

Under the hood

• Explicit adapter priority, reduced unlock network traffic, and a network protocol bump to 2 (update client and server together).

See CHANGELOG.md for the full list, including the 0.1.3 changes (toast names, configurable sweep, first-join toggle) folded into this release.

Requires: Minecraft 1.20.1, Forge 47.3.0+. No hard dependencies — integrations are detected at runtime.

Runic Tome 0.1.0

First public release of Runic Tome — a per-player virtual library for guide books on Minecraft 1.20.1 / Forge 47.3.0+.

Highlights

• Automatic absorption of every guide book that enters your inventory — pickup, craft, smelt, quest reward, command, container close.
• Soulbound. The tome is never dropped on death and is restored to your inventory on respawn. Stash is persisted to disk so even a server crash between death and respawn won't lose it.
• Vanilla-book-styled GUI with paginated, clickable entries that delegate to each guide system's native opener.
• Patchouli support (reflective, zero compile-time dependency) for both generic NBT-tagged books and custom-item books (dont_generate_book: true) like Ars Nouveau's Worn Notebook and Botania's Lexica Botania.
• Tinkers' Construct auto-integration for all six standard books.
• Config-driven allowlist (extraBookItemIds) for arbitrary standalone book items.
• Public API + IMC for third-party mod integration.

Installation

1. Install Forge 47.3.0+ for Minecraft 1.20.1.
2. Drop runictome-0.1.0.jar into your mods/ folder.
3. Launch. The tome is granted on your first world join.

See CHANGELOG.md for the full feature list and README.md for documentation.