
Patchouli Books
An add-on to Patchouli for 1.12.2
About this Mod

Welcome to Patchouli Books! This is an add-on for the Patchouli mod that adds various books for different mods, trying to document them as best as possible. Furthermore there are a few more QoL features I have in mind. This mod will only ever exist for 1.12.2 as I currently have no interest in doing anything on the newer versions of Minecraft. If you want to take a look at the things I encountered while working on this project, feel free to check out my project notes. Furthermore I made none of the art this mods uses. All the art used is either from Patchouli or sourced from various repositories. I've compiled a list of all the sources here together with the original authors and their respective licenses.

Stuff I have already implemented:
- added HEI/JEI integration (you can now open JEI for every item rendered inside a book using the same keybind as for JEI)
- improved JEI integration (relevant books will now show next to the recipe)
- backported Pamphlets from the 1.18 version of Patchouli (needs to be enabled in the config)
- backported PatchouliButton with a few more features
- new Page Types (an iteration of most of the existing ones as well as a new custom one for PedestalCrafting/ExtendedCrafting)
- of course a Patchouli Book explaining the features of this mod
- documentation for various mods (their respective books will only be loaded if the mod is present)

Stuff I may work on in the future:
- backporting PatchouliQuests
- implement the "inventory-scanning-to-open-a-book-entry" thing from Botania
- add new page types (e.g. Boss Info)

These mods are currently documented in this mod within their own books:
This list may seem a bit obscure as there aren't any big mods listed yet. This is because this project started with a few book I already made myself for my own modpack and these were already done before starting this. The list will most certainly grow in the future. Furthermore, I greatly appreciate any help with this project. If you're interested in helping me out, feel free to contact me on Discord or create an issue on this repository.
Available Versions
How to Install Patchouli Books on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set forge Loader
In the panel under "Egg", select the forge loader and matching Minecraft version (1.12.2).
Install Mod
Open the mod browser in the dashboard and search for "Patchouli Books". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.12.2
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Patchouli Books server crashes on startup – what to do?
Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.12.2). You can switch loaders with one click in the panel.
Is Patchouli Books compatible with forge?
Patchouli Books officially supports forge for Minecraft 1.12.2. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Patchouli Books – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Patchouli Books consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Patchouli Books with just one click on your server.
