What Patchouli works with.
| Platform | Java Edition |
|---|---|
| Loaders | Fabric, Forge, NeoForge, Quilt |
| Minecraft versions | 1.12.2, 1.16.5, 1.18.2, 1.19.4, 1.20.1, 1.21.1, 26.1, 26.1.2 |
| Environment | Client, Server |
Patchouli is a Minecraft Java library mod that adds a data-driven, dependency-free in-game guidebook system, letting other mods ship a readable, illustrated book instead of a separate wiki page. Fabric, NeoForge, and Quilt builds reach current 26.x releases, while the Forge line stops earlier. It runs on both the client and the server.
What the Patchouli book system does
A Patchouli book is defined in JSON, not hand-coded UI. Mod and modpack authors write entries made of text pages, crafting recipe pages, and multiblock diagrams, and Patchouli renders them as an in-game book the player can open, flip through, and search. Nothing about the format needs an external wiki or website, which is the dependency-free documentation the project name refers to.
Which mods use Patchouli
Two widely used mods declare Patchouli as a required dependency on Modrinth. Botania, from the same author, uses it to power its own in-game guide book. Ars Nouveau, a separate magic mod, does the same for its documentation. Installing either mod pulls Patchouli in automatically, and a modpack that includes them needs to bundle Patchouli alongside.
Installing Patchouli on Fabric, Forge, NeoForge, and Quilt
Drop the jar matching your loader into the mods folder; Patchouli needs no extra setup beyond that. The Fabric and Quilt builds also require Fabric API installed, since Patchouli calls into it for rendering. The NeoForge and Forge builds have no extra required dependency.
- Fabric: 26.1-94-beta for Minecraft 26.1 through 26.1.2, requires Fabric API
- NeoForge: 26.1-94-beta for Minecraft 26.1 through 26.1.2, no extra dependency
- Quilt: 26.1-94-beta for Minecraft 26.1 through 26.1.2, requires Fabric API
- Forge: 1.20.1-85-forge for Minecraft 1.20.1, no extra dependency
Questions about Patchouli.
5 questions
Why is Patchouli in my mods folder?
You probably did not download it on purpose. Patchouli is a shared library that mods like Botania and Ars Nouveau require to display their in-game guide books, so any mod loader or modpack that includes one of those mods pulls Patchouli in automatically.
Is Patchouli on 26.x?
Yes, on Fabric, NeoForge, and Quilt, where the 26.1-94-beta build covers Minecraft 26.1 through 26.1.2. The Forge release line stopped at 1.20.1, so Forge players on a newer Minecraft version need a NeoForge or Fabric build instead, which means switching loaders.
Does Patchouli mod fabric need Fabric API?
Yes. The Fabric and Quilt builds of Patchouli both declare Fabric API as a required dependency, so the game will fail to load without it. The NeoForge and Forge builds do not need any extra dependency.
Which mods use Patchouli?
Botania and Ars Nouveau both declare Patchouli as a required dependency on Modrinth, and use it to render their in-game guide books. Many smaller mods and modpacks build a Patchouli book of their own, so it can also show up as a dependency of projects outside this pair.
Is Patchouli safe to install?
Patchouli is distributed through Modrinth under a CC BY-NC-SA 3.0 license, with the project maintained by Vazkii, the same developer behind Botania and Quark. Download it from the official Modrinth page rather than a third-party mirror, and match the loader and version to your instance.
