Patchouli is a library and utility mod that provides data-driven, in-game documentation books for Minecraft modders and modpack makers, available for Fabric, Forge, NeoForge, and Quilt loaders.
One of the most persistent frustrations in modded Minecraft is figuring out how a mod actually works. Players Alt-Tab to wikis, scroll through outdated forum posts, and watch 30-minute YouTube tutorials just to craft a single item. Patchouli solves that problem by giving mod creators a powerful framework to build beautiful, browsable guide books that live right inside the game. Created by Vazkii — the developer behind Botania — and refined through years of community feedback, Patchouli has earned over 25 million downloads on Modrinth alone. It is one of the most widely depended-upon library mods in the entire Minecraft modding ecosystem, and chances are you already have it installed without even realizing it.
Key Features of Patchouli Mod
- Fully Data-Driven Book Creation — Patchouli lets modders and pack makers create complete in-game guide books using only JSON files. You do not need to write Java code or even compile against Patchouli's source. This dramatically lowers the barrier to entry, meaning even modpack creators with no programming experience can build professional-looking documentation for their packs.
- Rich Text Formatting with Macros — The built-in text engine supports bold, italic, colored text, clickable links, and reusable macros. This means authors can maintain consistent styling across hundreds of pages without manually formatting each one, and readers get a polished experience that feels native to Minecraft's interface.
- Advancement-Driven Content Unlocking — Book entries can be locked behind Minecraft advancements, revealing new pages as players progress. This turns documentation into a guided learning experience rather than an overwhelming wall of text, which is especially valuable for complex tech and magic mods with steep learning curves.
- Multiblock Visualization — Patchouli can render interactive 3D previews of multiblock structures directly on a book page. Players can rotate and inspect these structures before building them in-world, eliminating the guesswork that typically comes with assembling large crafting altars, ritual setups, or machine frames.
- Ready-to-Use Page Templates — The mod ships with several built-in page types including text pages, crafting recipe displays, image galleries, and spotlight pages. Modders can also create entirely custom page templates using the template system, giving them full control over layout without sacrificing the convenience of a structured framework.
- Seamless Mod Integration — Books created with Patchouli can appear in a mod's own creative tab and display under that mod's name, so players never realize they are using a separate library. This tight integration means the documentation feels like a native part of whatever mod it serves, which improves the overall user experience significantly.
- Full Localization Support — Every piece of text in a Patchouli book can be localized through standard Minecraft language files. For mod authors distributing their work internationally, this means community translators can localize the entire guide book without touching any code or JSON structure.
Screenshots
How to Install Patchouli Mod
- Download and install your preferred mod loader: Fabric, Minecraft Forge, NeoForge, or Quilt. Make sure the loader version matches your Minecraft version.
- If using Fabric, also install Fabric API, as most Fabric-based mods require it as a dependency.
- Download the correct Patchouli file for your Minecraft version and loader from the download section below.
- Place the downloaded
.jarfile into your.minecraft/modsfolder. If the folder does not exist, launch Minecraft once with your mod loader to generate it. - Launch Minecraft and verify Patchouli is loaded by checking the mod list. Most mods that depend on Patchouli will now display their in-game guide books automatically.
Requirements & Compatibility
| Detail | Information |
|---|---|
| Supported Loaders | Fabric, Forge, NeoForge, Quilt |
| Latest MC Version | 1.21.1 |
| Older Versions | 1.21, 1.20.6, 1.20.4, 1.20.1, 1.19.4, 1.19.3, 1.19.2, 1.18.2, 1.17.1, 1.16.5, 1.14.4, 1.12.2 |
| Author | Vazkii |
| License | CC-BY-NC-SA-3.0 |
| Total Downloads | 25,400,000+ |
What's New
- Updated to support Minecraft 1.21.1 across NeoForge, Fabric, and Quilt loaders.
- Continued maintenance and bug fixes to ensure stability on the 1.20.x branch.
- NeoForge replaced Forge as the primary loader for Minecraft 1.20.5 and newer versions.
- Ongoing improvements to the data-driven book rendering engine for better reliability.
Pros and Cons
Pros
- No coding knowledge required — JSON-only book creation
- Supports all four major mod loaders
- Extremely wide version support from 1.12.2 to 1.21.1
- Multiblock visualization saves players significant building time
- Advancement-gated content adds guided progression
- Massive community adoption — trusted dependency for hundreds of mods
Cons
- Adds no standalone gameplay — only useful alongside mods or packs that create books
- Learning the JSON book format still requires reading external wiki documentation
- Players cannot create or edit books themselves without access to the resource/data pack files
Alternatives to Patchouli Mod
- FTB Library — A shared library mod from the FTB team that provides common utilities and UI components for the FTB mod suite, serving a similar dependency role.
- JEI (Just Enough Items) — While not a documentation mod, JEI provides in-game recipe browsing that complements Patchouli's guide books by covering crafting lookup needs.
- EMI — A modern recipe viewer alternative that offers clean UI and mod integration, working alongside Patchouli to give players complete in-game reference tools.
Download Patchouli Mod
| Minecraft Version | Fabric | Forge | NeoForge | Quilt |
|---|---|---|---|---|
| For Minecraft 1.21.1 | Download | — | Download | Download |
| For Minecraft 1.21 | Download | — | Download | Download |
| For Minecraft 1.20.6 | Download | — | Download | Download |
| For Minecraft 1.20.4 | Download | — | Download | Download |
| For Minecraft 1.20.1 | Download | Download | — | Download |
| For Minecraft 1.19.4 | Download | Download | — | Download |
| For Minecraft 1.19.3 | Download | Download | — | Download |
| For Minecraft 1.19.2 | Download | Download | — | Download |
| For Minecraft 1.19 | Download | Download | — | Download |
| For Minecraft 1.18.2 | Download | Download | — | Download |
| For Minecraft 1.18.1 | Download | Download | — | — |
| For Minecraft 1.17.1 | Download | Download | — | — |
Always download mods from official sources to stay safe.
Frequently Asked Questions
Is Patchouli required to play modded Minecraft?
It depends on your mod list — Patchouli is a dependency for many popular mods including Botania, Hexcasting, and others. If any mod in your pack requires Patchouli, the game will not launch without it. Check your mod list for dependency requirements before removing it.
Does Patchouli work on Fabric?
Yes — Patchouli supports Fabric for Minecraft versions ranging from 1.14.4 all the way up to 1.21.1. You will also need Fabric API installed alongside it for full functionality on the Fabric loader.
Can I use Patchouli to make a guide book for my modpack?
Yes, absolutely. Patchouli was specifically designed for both mod developers and modpack makers. You can create complete guide books using only JSON data files placed in a resource pack or data pack, with no Java code or compilation required.
Does Patchouli affect game performance?
Patchouli appears to be lightweight since it only renders book content when a player opens a guide book. As a library mod, it loads passively in the background and does not run continuous processes or heavy calculations during normal gameplay.
Is Patchouli available for NeoForge?
Yes — Patchouli supports NeoForge starting from Minecraft 1.20.4 onward, including the latest 1.21.1 release. For Minecraft 1.20.1 and older versions, use the Forge version instead, as NeoForge did not exist for those releases.
