MINECRAFTHUB.IO
Java Mods

Bookshelf

Bookshelf is a Minecraft Java library mod from Darkhax that other mods depend on for shared code. It ships for Fabric, Forge, NeoForge, and Quilt, with more than 44 million downloads on Modrinth.

By Darkhax via Modrinth.

Bookshelf's /bookshelf hand debug command exporting held item data in Minecraft chat
Section
Java Mods
Platform
Java
Checked
Updated
Versions
1.7.10, 1.12.2, 1.16.5, 1.18.2, 1.19.2, 1.20.1, 1.21.1, 26.1, 26.2

What Bookshelf works with.

PlatformJava Edition
LoadersFabric, Forge, NeoForge, Quilt
Minecraft versions1.7.10, 1.12.2, 1.16.5, 1.18.2, 1.19.2, 1.20.1, 1.21.1, 26.1, 26.2
EnvironmentClient, Server

Bookshelf is a shared code library from Darkhax, not a mod you interact with directly. Other mods list it as a dependency and stop working without it. It has shipped for Fabric, Forge, NeoForge, and Quilt since as far back as 1.7.10, and the current builds cover the 26.x Minecraft drops, running on both the client and the server.

What Bookshelf actually does

Bookshelf gives mod developers shared code for things like item and block registration helpers, JSON and NBT data handling, network syncing, and debug tools, so each mod that depends on it does not have to rewrite the same plumbing. Mods that list it as a dependency include Enchantment Descriptions, Botany Pots, Tips, and Dark Utilities, and a broader set of Fabric and Forge mods pull it in for the same reason. Installing Bookshelf on its own adds no new items, blocks, or menus. It only exists to make another mod's install requirement true.

Installing Bookshelf

Bookshelf needs no extra setup once it is installed. Download the file that matches your mod loader and Minecraft version, place it in the mods folder next to the mod that requires it, and launch the game. The Fabric build lists Fabric API as a required dependency, so install that alongside it if you play on Fabric. Forge, NeoForge, and Quilt builds carry no such requirement.

Which loader and version to pick

Support is not even across loaders. Fabric and NeoForge currently ship the same build, 26.1.2.15, covering Minecraft 26.1 through 26.1.2. Forge's most recent build is 20.2.15, which only covers Minecraft 1.20.1, and Quilt's most recent build is 21.1.81, covering 1.21.1. If a mod you use needs Bookshelf on Forge or Quilt for a newer Minecraft release, check that a matching build actually exists before assuming one does.

Client and server requirements

Bookshelf is required on both the client and the server. If a mod that depends on it is installed only on one side, the mismatched side will fail to load or refuse to connect. Treat it the same way you would treat any hard dependency, and install it everywhere the mod that needs it runs, whether that is a personal client, a dedicated server, or a hosted modded server.

Questions about Bookshelf.

5 questions

How do I install Bookshelf?

Download the file matching your mod loader (Fabric, Forge, NeoForge, or Quilt) and Minecraft version from Modrinth, then place it in your mods folder next to the mod that requires it. Fabric players also need Fabric API installed, since Bookshelf's Fabric build declares it as a required dependency. There is nothing to configure afterward.

Does Bookshelf work with Fabric, Forge, NeoForge, and Quilt?

Yes, but not to the same version. Fabric and NeoForge currently reach Minecraft 26.1.2 with build 26.1.2.15. Forge's latest build stops at 1.20.1, and Quilt's latest build stops at 1.21.1, so check which loader build actually exists for your target Minecraft version before assuming parity.

Which Minecraft version does Bookshelf support?

Bookshelf has shipped continuously since Minecraft 1.7.10 and stays updated through the current 26.x drops on at least one loader. Exact support depends on which loader you use. Fabric and NeoForge track the newest Minecraft releases most closely, while Forge and Quilt currently lag behind on older versions.

Is Bookshelf safe to use on multiplayer servers?

Bookshelf is an open source library under the LGPL-2.1 license, distributed through Modrinth and CurseForge by Darkhax, a long-running Minecraft mod author. It requires installation on both client and server, and running it on a server is simply how any mod that depends on it is meant to work.

What does Bookshelf actually do in-game?

Nothing by itself. It supplies shared code, such as item and NBT data handling and debug tools, that other mods build on. You will not see new items or menus from Bookshelf directly. You will notice the mods that depend on it, like Enchantment Descriptions or Dark Utilities, working correctly instead.

More Java Mods like Bookshelf.

Guides for Java Mods.

Browse all Minecraft Java mods