ModsFinder

Patchouli

by Vazkii

Patchouli lets modders and pack makers build in-game guidebooks from data files, without writing code for each page.

FabricForgeNeoForgeQuiltClient and serverCC-BY-NC-SA-3.01.12.2 – 26.1.2

What it does

Books are defined in data, so a book can be created or changed without compiling a Java mod. Each book holds nested categories and entries that players can bookmark, and the mod supplies ready-made page types such as text, crafting and image pages. A template system lets authors define custom page types when the built-in ones are not enough.

Patchouli also includes an in-game text preview for checking how a page will look, a formatting system with macros, and advancement-driven entries that appear as players progress. Multiblock pages show how a structure is assembled. Installing it on Fabric requires Fabric API, and the mod is published for Fabric, Forge, NeoForge and Quilt across 20 release versions, covering 1.12.2 – 26.1.2. It is licensed under CC-BY-NC-SA-3.0 and is not open source.

Key features

  1. Data-driven books

    Books, categories and entries are written as data, so content can be authored without writing code.

  2. Ready-made page types

    Text, crafting and image pages are included, along with other built-in types that do not need custom code.

  3. Advancement-gated entries

    Entries can be tied to advancements, so the book shows material as the player progresses.

  4. Multiblock visualization

    Multiblock pages display the layout of a structure so players can see how to build it.

  5. Custom page templates

    A template system allows authors to define new page types for content the built-in pages do not cover.

Compatibility

Latest build for each game version and loader.

26.x3 of 3 versions with builds
26.1.226.1-94-betaNot available26.1-94-beta26.1-94-beta
26.1.126.1-94-betaNot available26.1-94-beta26.1-94-beta
26.126.1-94-betaNot available26.1-94-beta26.1-94-beta
1.21.x2 of 2 versions with builds
1.21.11.21.1-93-fabricNot available1.21.1-93-neoforge1.21.1-93-fabric
1.211.21-89-fabricNot available1.21-89-neoforge1.21-89-fabric
1.20.x3 of 3 versions with builds
1.20.61.20.6-86.1-fabricNot available1.20.6-86.1-neoforge1.20.6-86.1-fabric
1.20.41.20.4-85-fabricNot available1.20.4-85-neoforge1.20.4-85-fabric
1.20.11.20.1-85-fabric1.20.1-85-forgeNot available1.20.1-85-fabric
1.19.x4 of 4 versions with builds
1.19.41.19.4-79.1-fabric1.19.4-79.1-forgeNot available1.19.4-79.1-fabric
1.19.31.19.3-78-fabric1.19.3-78-forgeNot available1.19.3-78-fabric
1.19.21.19.2-77-fabric1.19.2-77-forgeNot available1.19.2-77-fabric
1.191.19-74-fabric1.19-75-forgeNot available1.19-74-fabric
1.18.x2 of 2 versions with builds
1.17.x1 of 1 version with builds
1.16.x2 of 2 versions with builds
1.15.x1 of 1 version with builds
1.14.x1 of 1 version with builds
1.12.x1 of 1 version with builds
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Requirements

Dependencies declared by the latest file for each loader.

Required 1

Fabric APILightweight and modular API providing common hooks and intercompatibility measures utilized by mods using the Fabric toolchain.
Required

Required by 170 mods

Goety - The Dark Arts1.16.5 – 1.21.1Botania1.6.4 – 1.20.1Cobblemon Poképedia: Cobblepedia1.19.2 – 1.21.1Mythic Mounts1.16.5 – 1.20.1Enigmatic Legacy1.14.4 – 1.20.1L2 Hostility1.20.1 – 1.21.1

Use cases

Mod documentation

Mod authors can ship a guidebook inside their mod instead of maintaining separate external documentation.

Modpack guides

Pack makers can write a book that explains the pack's systems, recipes and progression inside the game.

Who it’s for: Mod developers who want an in-game guide for their content, and modpack makers who need to explain progression to players. Players see the books these mods provide.

How it compares

Full comparison

Jade is published for 1.16.4 – 26.3 under a Creative Commons Attribution Non Commercial Share Alike 4.0 license, and it is not open source. It works on either side, and neither side needs it. Just Enough Items (JEI) is open source under the MIT License and runs on Fabric, Forge and NeoForge for 1.8 – 26.3. Installing it on either side is enough, and neither side is required. Geckolib is open source under the MIT License and covers Fabric, Forge, NeoForge and Quilt for 1.12.2 – 26.3; the client needs it, while the server may skip it.

ModLoadersGame versionsEnvironmentUpdated
PatchouliFabric, Forge, NeoForge and Quilt1.12.2 – 26.1.2Client and server2026-07-10
Jade 🔍Fabric, Forge, NeoForge and Quilt1.16.4 – 26.3Client or server, optional2026-10-13
Just Enough Items (JEI)Fabric, Forge and NeoForge1.8 – 26.3Client or server, optional2026-10-15
GeckolibFabric, Forge, NeoForge and Quilt1.12.2 – 26.3Client required, server optional2026-09-22

Questions

Does Patchouli need Fabric API?

Yes. On Fabric, the required dependency Fabric API must be installed next to Patchouli.

Is Patchouli installed on both sides?

Yes. Because it is client and server, both the server and the player's client need the mod for books to work fully.

Which versions have files for Patchouli?

Release files cover 20 versions, with 1.12.2 and 26.1.2 at the ends of the range, and the latest Forge file for 1.20.1 published on 2026-03-08.

Which mods depend on Patchouli?

170 other mods require it, for example Goety - The Dark Arts, Botania, Mythic Mounts and Enigmatic Legacy.

In the catalog

Patchouli is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 15,189 mods support Minecraft 26.1.2.

Library mods3,514Fabric modsMods for 26.1.215,189

More from Vazkii

All projects
Quark1.9.4 – 1.21.1Zeta1.20.1 – 1.21.1Neat1.7.10 – 26.2Botania1.6.4 – 1.20.1AutoRegLib1.12.2 – 1.19.2Quark Oddities1.12.2 – 1.21.1

Similar mods

Fabric API1.14 – 26.3Cloth Config API1.14 – 26.3YetAnotherConfigLib (YACL)1.19 – 26.3Architectury API1.16.5 – 26.3Text Placeholder API1.17 – 26.3Forge Config API Port1.16 – 26.3

What the author says

Patchouli is a mod that aims to provide easy to implement, data-driven documentation for minecraft modders and modpack makers alike. Patchouli's systems allow any modder or modpack maker to quickly create beautiful books full of user experience enhancing features. The user-facing feature set of the mod is designed in…
Vazkii, on the Modrinth page

Official listing

Owner
Vazkii
Published
2021-12-23
Updated on Modrinth
2026-07-10
Facts verified
2026-10-15

Tags

LibraryUtility
Open on ModrinthCompare