Minecraft Guidebook System
Patchouli Mod for Minecraft A Flexible Guidebook System for Modders
Patchouli Mod brings clear, interactive guide books to Minecraft: Java Edition, helping players explore crafting recipes, understand multiblock structures and follow modpack progression without leaving the game. Create organised documentation with custom categories, visual pages and advancement-based unlocks, all defined in simple JSON files.
What Is Patchouli Mod?
Patchouli Mod is a flexible Minecraft guidebook system that gives mods and modpacks their in-game documentation.
Patchouli is a documentation library for Minecraft: Java Edition, created by Vazkii, the developer behind Botania. It powers the guide books found in many mods and modpacks: the books players open to learn what an item does, how a machine works or which structure to build next.
As a Minecraft guidebook system for modders, Patchouli turns JSON files into customizable, page-turning books with categories, entries, recipe displays and multiblock previews. The project describes itself as accessible, data-driven and dependency-free.
On its own, Patchouli adds the book system rather than a book. The content comes from mods that include a Patchouli book, or from modpack makers who write their own.
Key Features of Patchouli Mod
Patchouli Mod gives writers everything a guide book needs, defined in data files instead of code.
JSON-driven books
Books, categories and entries are plain JSON files, so writers can build a full guide without touching Java code.
Categories and entries
Organise content into nested categories and entries with icons, descriptions and sort order for easy browsing.
Ready-made page types
Text, image, crafting, smelting, spotlight, entity, link, relations, quest and empty pages are built in.
Multiblock previews
Multiblock pages show a structure in the book, and a Visualize button helps players build it in the world.
Advancement locks
Hide entries or pages until the player earns an advancement, keeping progression guides free of spoilers.
Translations
Add a language folder next to en_us and override only the files you translate; the rest falls back to English.
How It Works
Patchouli Mod reads book files from a mod or modpack and turns them into an interactive book in the game.
- Step 01
Install the library
Put the Patchouli jar that matches your Minecraft version and loader into the mods folder.
- Step 02
Add a book
A mod ships its own book, or a modpack maker adds one under patchouli_books in the game folder.
- Step 03
Write the content
Categories and entries are JSON files whose pages use the built-in page types or custom templates.
- Step 04
Read it in game
Players open the guide book from a creative tab, a recipe or an advancement reward.
Download Patchouli Mod
Get the Forge build for Minecraft 1.20.1 and prepare your in-game guide books.
Bring your Minecraft guides to life.
Patchouli Mod puts recipes, structures and progression guides inside your game. Start with the build that matches your setup.
Patchouli for Forge
- Minecraft
- Java Edition 1.20.1
- Mod loader
- Forge
- Build
- 85
- Source
- CurseForge
Patchouli-1.20.1-85-FORGE.jar
Download Patchouli ModUse with Forge 1.20.1. Other versions and loaders require a matching build.
View installation steps →Why Use Patchouli Mod in Minecraft?
Help that lives inside the game is easier to follow than a browser tab.
Patchouli Mod keeps documentation where players already are. Instead of switching to an external wiki, players open a book that shows recipes, structures and progression notes while they play.
For mod authors and pack makers, books are written as data, so updating a guide is as simple as editing a JSON file and reloading the book.
Writers do not need to code
Anyone comfortable with a text editor and JSON can produce a polished guide.
Help stays inside the game
Players read instructions without alt-tabbing to a browser or an external wiki.
Quick edits
Shift-click the pencil in the book to reload entries without restarting the game.
A familiar interface
Many mods use the same book layout, so players already know how to navigate it.
Spoiler control
Advancement locks keep later content hidden until it becomes relevant.
Works with vanilla systems
Books integrate with data pack recipes and advancements rather than replacing them.
How to Install Patchouli Mod
Patchouli Mod installation needs a file that matches both your Minecraft: Java Edition version and your mod loader. Follow these four steps to prepare your game.
- Step 01
Step 1: Check Your Version
Confirm the Minecraft: Java Edition version of the profile or modpack you plan to play.
- Step 02
Step 2: Choose the Loader
Use the loader the profile runs: Forge, NeoForge, Fabric or Quilt. Each needs its own Patchouli file.
- Step 03
Step 3: Add the Mod File
Place the matching jar, such as
Patchouli-1.20.1-85-FORGE.jar, in your mods folder. Do not unzip it. - Step 04
Step 4: Launch Minecraft
Start the game with the same loader profile, then open a mod or modpack book to confirm it works.
Safe Download Tips
Simple habits that keep your game and worlds safe when you add Patchouli Mod.
Use a known source
The download here links directly to the file hosted by CurseForge. Avoid re-uploads on unfamiliar sites.
Check the file
Expect a single .jar named for its loader and version, such as Patchouli-1.20.1-85-FORGE.jar. Never run an .exe that claims to be Patchouli.
Back up your worlds
Copy your saves before adding or replacing mods in an existing world or modpack.
Keep versions in step
Update Patchouli together with your modpack so every mod expects the same library build.
Compatibility and Requirements
Patchouli Mod compatibility depends on your Minecraft: Java Edition version and your installed mod loader.
Minecraft: Java Edition
Patchouli is a Java Edition mod. Listings run from 1.12.2 up to the 26.1.x line, including 1.20.1 and 1.21.1.
Supported Mod Loaders
Builds are published for Forge, NeoForge and Fabric. The Fabric builds are also marked for Quilt.
Exact Version Matters
Every file targets one game version and one loader. A Forge jar will not load on Fabric, and a 1.21.1 file is not meant for 1.21.11.
Bedrock Edition Note
There is no Bedrock Edition version. Bedrock does not load Java mods, so treat any "Patchouli Bedrock" file as unofficial.
How to Use Patchouli Mod in Minecraft
Find, read and even write guide books once Patchouli Mod is installed.
Find a book. Mods that support Patchouli add their own guide book. On modern versions, books usually appear in the Tools & Utilities creative tab, though authors can choose a different tab, give the book through a recipe or hand it out as an advancement reward.
Read and navigate. The landing page lists categories. Open a category to see its entries, follow links between entries and use the Visualize button on multiblock pages to preview a structure in the world.
Write your own. Modpack makers can add a book under .minecraft/patchouli_books/. After editing entries, shift-click the pencil icon in the bottom-left corner of the book to reload it. Changes to book.json need a restart.
Patchouli Mod vs. Book and Quill
Players often compare Patchouli Mod with the vanilla Book and Quill. The two do different jobs.
| Point | Patchouli Mod | Book and Quill |
|---|---|---|
| Purpose | Guide books shipped by mods and modpacks | A book players write in during normal play |
| Where content comes from | JSON files written by a mod author or pack maker | Text typed by a player in the game |
| Recipes and structures | Crafting, smelting, spotlight and multiblock pages | Plain text only |
| Navigation | Categories, entries, links and bookmarks | Page by page |
| Progression | Entries can stay hidden until an advancement is earned | No unlock system |
| Installation | Requires the Patchouli library mod | Built into Minecraft |
Pros and Cons
A balanced look at what Patchouli Mod does well and where its limits are.
Pros
- Guide books are written in JSON, with no Java code needed for content.
- Built-in page types cover text, recipes, entities, links, quests and multiblocks.
- Advancement locks support spoiler-free progression guides.
- Builds exist for Forge, NeoForge, Fabric and Quilt.
- Covers a long range of game versions, from 1.12.2 to the 26.1.x line.
- Translations are supported through simple language folders.
Cons
- Adds nothing visible by itself; a mod or modpack has to provide a book.
- Each loader and game version needs its own file, so it is easy to grab the wrong one.
- Minecraft: Java Edition only, with no Bedrock Edition version.
- A JSON syntax error can leave pages blank until it is fixed.
- The official docs focus on the latest version, so older versions rely on archived docs.
Common Patchouli Mod Issues and Fixes
Patchouli Mod problems usually come from a version mismatch, a missing book or a JSON mistake.
Game crashes on startup
The jar usually targets another loader or game version. Check the file name, remove duplicates and keep one matching Patchouli file.
No guide book appears
Patchouli does not add a book of its own. Install a mod that provides one, or create a book, then check the creative inventory.
Pages are blank or show errors
Custom books often have a JSON syntax mistake or a wrong entry or category ID. Validate the files and check namespaces.
Edits do not show up
Shift-click the pencil in the bottom-left of the book to reload content. Changes to book.json need a restart.
Works alone, fails on a server
Install Patchouli on the server as well, and make sure the server and players use matching mod versions.
Not listed in the Mods menu
The jar may be in the wrong folder or a different launcher instance. Move it into the mods folder of the profile you launch.
Frequently Asked Questions
Patchouli Mod answers covering downloads, loaders, versions and writing books.
Download and Compatibility
Patchouli is a free library mod for Minecraft: Java Edition, made by Vazkii. It provides the data-driven guide book system that many mods and modpacks use to document their content inside the game.
Yes. Patchouli is free to download and use. Its listing on Modrinth shows the CC BY-NC-SA 3.0 license, so check the license before redistributing it.
It downloads Patchouli-1.20.1-85-FORGE.jar, the Forge build of Patchouli for Minecraft 1.20.1, served from CurseForge. Use it only with a Forge 1.20.1 profile.
Yes. Fabric builds are available and are also marked for Quilt. On CurseForge they are published as a separate Fabric/Quilt port page, while Modrinth lists every loader under one project.
Yes. NeoForge builds are listed for newer game versions, starting from versions such as 1.20.4 and continuing through 1.21.1 and the 26.1.x line.
Yes. For 1.20.1 the listings show a Forge build and a Fabric build, both at build 85. The Forge build is the file offered on this website.
When we checked in October 2026, the listings showed builds for 1.21 and 1.21.1 plus a newer 26.1.x line, but no file tagged for 1.21.11. Check the official files list before installing, and do not force a 1.21.1 jar onto 1.21.11. See the 1.21.11 guide.
Yes. 1.12.2 is the oldest version on the project's version list. Those setups use Forge, and older documentation is kept in archived form.
No. Patchouli is a Java Edition mod loaded by Forge, NeoForge, Fabric or Quilt. Bedrock Edition does not load Java mods, so any "Patchouli Bedrock" download is unofficial. Read the Bedrock guide.
Yes. Patchouli has a Modrinth project that lists Fabric, Forge, NeoForge and Quilt builds, marked for both client and server.
Using and Creating Books
Patchouli is a library, so it does not add a book by itself. Books are provided by mods that support it or created by modpack makers. Look in the creative inventory, or follow the mod's instructions for getting its guide.
Patchouli is listed for both client and server, and installing it on both gives full functionality. On multiplayer servers, keep the server and players on matching versions.
Patchouli is described as dependency-free, so it does not need other content mods. Always install anything that a specific file page lists as required for that build.
Modpack books live in .minecraft/patchouli_books/BOOK_NAME/, with book.json in that folder and categories and entries inside a language folder such as en_us.
Yes. Books are written as JSON files, so a text editor is enough. Our step-by-step tutorial walks through a first book with one category and one entry. Open the tutorial.
Open the book and shift-click the pencil icon in the bottom-left corner to reload its contents. Changes to book.json require a game restart.
The default types are text, image, crafting, smelting, multiblock, entity, spotlight, link, relations, quest and empty. Templates allow custom layouts.
Yes. Entries and pages can include an "advancement" field. The content stays hidden until the player earns that advancement, and players can turn locks off in the config.
Yes. Add a language folder such as zh_cn next to en_us and include only the files you translate. Missing files fall back to English.
The official documentation website for Patchouli acts as its wiki and is written for the latest version. Our wiki guide summarises books, page types, formatting and locks. Read the wiki guide.