Do I need to install Patchouli separately, or does it come with the mod that requires it?

You need to install it separately. Mods that depend on Patchouli list it as a required dependency, but they don't bundle it inside their own JAR. Download Patchouli from this page and put it in your mods folder alongside the mod that needs it.

What mods actually use Patchouli?

A lot of popular ones. Botania uses it for the Lexica Botania, Blood Magic uses it for its guidebook, Astral Sorcery, Quark, Ars Nouveau, Biomes O' Plenty, Create's official addons, and many others. If you're playing any serious tech or magic modpack, there's a good chance Patchouli is already in there.

The game crashed saying it can't find Patchouli. What's wrong?

Either Patchouli isn't in your mods folder, or the version you downloaded doesn't match your Minecraft version or mod loader. Double-check the filename: it should say something like 'Patchouli-1.20.1-84-FORGE.jar' and that middle number should match your game version exactly. Also confirm you're using the right loader edition (Forge vs Fabric vs NeoForge).

Can I open the guidebook from a mod that uses Patchouli without crafting it first?

It depends on the mod. Some mods give you the book automatically when you first join a world. Others require you to craft it using a simple recipe. A few lock it behind early-game progression. Check the specific mod's documentation to find out which method it uses.

Does Patchouli work with OptiFine?

Generally yes. Patchouli books don't use shaders or custom rendering that typically conflicts with OptiFine. That said, if you run into visual glitches in book pages while using OptiFine, try disabling OptiFine's custom textures or connected textures temporarily to see if they're the cause. For Fabric players, consider Sodium plus Iris as an alternative to OptiFine — see our page on OptiFine for more options.

Patchouli Mod - In-Game Guide Books

Download Patchouli Mod from Modrinth

What Is Patchouli?

Patchouli is a library mod that lets mod developers create good-looking, fully functional guidebooks inside the game. Instead of hunting down a wiki or alt-tabbing to a browser mid-build, you get a proper book in your inventory with crafting recipes, item spotlights, and formatted text pages all in one place.

On its own, Patchouli doesn’t add anything you can interact with. It’s a foundation, not a standalone feature. You install it because another mod you want requires it, and that mod ships its own book that runs on top of Patchouli’s system. Think of it like a printing press: the press itself is just machinery, but without it, the books don’t exist.

Why So Many Mods Use It

Before Patchouli, every mod author who wanted in-game documentation had to build the whole system from scratch: custom GUIs, page rendering, recipe display, search, the works. Most just skipped it and pointed players to external wikis instead.

Patchouli solved that by giving authors a standard format (JSON files packed into their mod) they can fill out without touching a single line of rendering code. The result is that mods like Botania, Blood Magic, Astral Sorcery, and Quark all ship polished guidebooks that look consistent and actually work. If you play modpacks regularly, you’ve almost certainly read a Patchouli book without knowing it.

Key Features

Data-Driven Books

Every book is defined entirely in JSON. Mod authors write entries the same way they write recipes: plain text files, no custom code needed. This means books can be updated, translated, or even overridden by resource packs without touching the mod jar itself.

Multiple Page Types

A single book entry can contain several page types chained together. The most common ones are text pages, crafting recipe pages, item spotlight pages (great for explaining what an item does), multiblock structure displays (shows a 3D preview of a structure you need to build), image pages, and quest-style link pages that connect related entries. Mod authors mix and match these to build proper tutorials instead of walls of text.

Built-In Search

Every Patchouli book has a search bar. You can type any keyword and it filters entries across every category instantly. For large mods with dozens of items, this saves a lot of page-flipping.

Progression Locking

Mod authors can lock entries behind advancements. A chapter on end-game crafting might not appear until you’ve reached that point in the mod’s progression. This keeps books from being overwhelming at the start and reveals content naturally as you play.

Addon and Extension Support

One mod can add entries to another mod’s Patchouli book. So if you have a mod that adds Botania cross-compatibility, it can inject its own documentation directly into the Botania lexicon rather than requiring a separate book.

Supported Versions and Mod Loaders

Patchouli covers a wide range of Minecraft versions and all the major mod loaders:

Forge: 1.12.2 (legacy), 1.16.5, 1.18.2, 1.19.2, 1.19.4, 1.20.1, 1.21.x
Fabric: 1.16.5 through 1.21.x
Quilt: 1.18.2 and later
NeoForge: 1.20.1 and later

Always match your Patchouli version to the mod loader and Minecraft version used by whatever mod is requiring it. Mismatched versions are the most common source of crashes with library mods like this.

How to Install Patchouli

Patchouli installs the same way as any other mod. You just need a working mod loader set up first.

Pick and install a mod loader. Use Minecraft Forge, Fabric, NeoForge, or Quilt, depending on what the mod that needs Patchouli uses. Check that mod’s page if you’re not sure which loader it targets.
Download Patchouli. Use the download button on this page. Make sure the file version matches your Minecraft version and mod loader.
Drop the JAR into your mods folder. On Windows this is usually %AppData%\.minecraft\mods. On macOS it’s ~/Library/Application Support/minecraft/mods. If the folder doesn’t exist, create it.
Install the mod that depends on it. Patchouli alone won’t do anything visible. Drop your actual target mod in the mods folder alongside Patchouli.
Launch the game and check for errors. If Minecraft starts normally and you can load a world, you’re set. The guidebook will appear in-game, usually as a craftable item or in your starting inventory depending on the mod.

If you’re new to installing mods generally, see the full walkthrough for Forge mod installs or Fabric mod installs.

Patchouli Mod – In-Game Guide Books