Handy Bookshelf

Vanilla chiseled bookshelves look great — until you need to find your Mending book among 30 identical shelves. Every slot looks the same regardless of what's inside. Is that an enchanted book? A regular book? A book and quill you accidentally stuffed in there? No way to tell without clicking every single slot. Handy Bookshelf fixes that by making enchanted books actually look enchanted.

Features

✨ Enchantment Glint

Slots containing enchanted books display a shimmering glint effect — the same iconic shimmer you see on enchanted items in your inventory. Enchanted books glow, regular books don't. Instant visual distinction.

🏷️ Enchantment Name Tags

Point your crosshair at a bookshelf slot (within 4 blocks) and the enchantment name appears above the shelf. No more guessing, no more opening slots one by one hunting for Sharpness V.

🎭 Pixel-Perfect Glint Masking

The glint effect only renders over book pixels — not the wooden shelf border. It's a small detail, but it keeps things looking clean and intentional rather than "someone slapped a filter over a rectangle."

🧭 All Orientations

Works with chiseled bookshelves facing any cardinal direction. North, south, east, west — your enchanted books shimmer from every angle.

Why This Mod?

Chiseled bookshelves were one of the best additions in 1.20. Finally, a way to display and organize books on shelves with individual slots. But Mojang stopped short — the visual representation treats every book type identically. You can store the most powerful enchanted book in the game right next to a blank book, and they look exactly the same.

The average enchantment hoarder has somewhere between "a few" and "an unreasonable number" of chiseled bookshelves in their base. Finding the right enchanted book means clicking through slot after slot, shelf after shelf, squinting at tooltips. Handy Bookshelf turns that scavenger hunt into a glance.

• Vanilla-esque — no new items, no new blocks. Just better bookshelf visuals using vanilla's own enchantment glint.
• Lightweight — does one thing well. No heavy dependencies beyond Fabric API.
• Non-intrusive — regular books, written books, and empty slots all look exactly like vanilla. Only enchanted books get the special treatment.

Compatibility

• Requires Fabric API
• Must be installed on both client and server (inventory sync mixin)
• Should work alongside most mods — if you run into conflicts, open an issue
• ⚙️ Optional: Mod Menu + YACL for in-game config screen (not required)

Installation

Single Player

1. Install Fabric Loader
2. Install Fabric API
3. Drop handybookshelves-x.x.x.jar into your mods/ folder
4. Launch the game!

Server

The mod is required on both the server and all connecting clients for inventory sync to work correctly.

1. Install Fabric Loader on your server
2. Place Fabric API and Handy Bookshelf in the server's mods/ folder
3. Each connecting player needs Fabric Loader, Fabric API, and Handy Bookshelf installed

Part of the Handy series

Small Fabric mods that smooth over vanilla friction points:

• Handy Shulker — bundle-like interactions for shulker boxes
• Handy Trader — bookmark your favorite villager trades
• Handy Indicator — visual indicators on container blocks

Handy Bookshelf is open source under the MIT license.