Summoning Ritual Template: Quick Ritual Documentation for Patchouli
For years, Patchouli has been the go-to framework for crafting interactive guidebooks inside Minecraft. Modpack authors rely on it to walk players through intricate mechanics, from complex crafting chains to multi-stage rituals. Yet, building those pages from scratch is a tedious affair, especially when documenting custom summoning circles. That is where Summoning Ritual Template: Quick Ritual Documentation for Patchouli steps in, offering a streamlined solution for creators who want polished documentation without the grunt work.
This template is purpose-built for documenting rituals added through the Zen Summoning system. Instead of wrestling with raw JSON and layout guesswork, you get a pre-structured page that handles the circle visual, ingredient slots, and explanatory notes. The result is a professional-looking entry in your Patchouli book, ready for players to consult.
Who Benefits from This Template
Let us be clear from the outset: this add-on does not introduce new items, blocks, or rituals into your game. It is a developer tool, not a gameplay expansion. If you are a player who simply enjoys exploring modpacks, this template will not change your experience. However, if you are assembling your own mod collection and leveraging Zen Summoning to create unique rites, this resource is a genuine time-saver.
The template was originally tested on Minecraft 1.12.2, and official compatibility with newer releases is not guaranteed. That said, Patchouli's file structure has remained remarkably stable across versions. Many creators have successfully adapted it for 1.16.5 and 1.18.2 with minor manual adjustments. The core logic holds up, so do not let the version tag scare you off.
Installation Steps
Getting the template into your workspace is straightforward, though you will need to pay attention to folder paths. First, download Summoning Ritual Template: Quick Ritual Documentation for Patchouli and extract the archive directly into your Minecraft root directory, the same place where your mods, config, and resourcepacks folders reside. After extraction, you will find the relevant file at:
patchouli_books\ThanasiShadoW's Patchouli Templates\en_us\templates
This text file contains the template markup. Copy it into the templates folder of your own Patchouli book. If you have never worked with Patchouli templates before, do not worry. The format is JSON-like and easily editable in any plain text editor, even Notepad. The structure is forgiving enough for beginners while remaining powerful for veterans.
For those who prefer a more managed workflow, using a launcher that simplifies mod installation can speed things up considerably. Many creators find that a launcher with built-in mod management lets them test templates like this one without manually digging through directories each time. It is a small convenience that adds up over a long modding session.
Breaking Down the Template Parameters
The true value of this template lies in its thoughtful field structure. You simply fill in the values, and the page assembles itself. Here is a closer look at each parameter.
Catalyst
This field defines the item used to activate the ritual. In Zen Summoning terms, this is the trigger that kicks off the entire sequence. You specify it as an ItemStack, such as minecraft:blaze_powder. If your ritual requires clicking the altar with a particular item, this is where you note it. Getting this right ensures players know exactly what to use to start the summoning.
Circle Type
This mandatory text parameter determines the visual style of the magic circle displayed in the book. The available options are:
- eldritch - an otherworldly design with tentacles and a dark aesthetic
- floral - a botanical pattern with flower motifs
- gear - a mechanical, cog-based look
- kaleidoscope - a swirling, multicolored pattern
- lunar - a moon-themed design with silver glow and phases
- peacock - a vibrant, feather-inspired arrangement
- plain - a simple, unadorned circle
Your choice here dramatically affects the page's atmosphere. Match the circle type to your ritual's theme for maximum impact. Leaving this field empty will break the template, so always specify a value. Also, note that the strings are case-sensitive; use lowercase exactly as listed.
Ingredient Slots
Eight slots, labeled input1 through input8, hold the items arranged around the circle. Input1 sits at the top center position, with the rest following clockwise. Each parameter accepts an ItemStack. For a classic elemental summoning, you might place minecraft:water_bucket, minecraft:lava_bucket, and minecraft:feather in sequence. If your ritual uses fewer than eight items, leave the remaining slots empty; they will simply not render.
Notes Field
This free-text area is for additional instructions. Add special conditions like moon phase, time of day, required experience level, or safety warnings. Players will see this text beneath the circle image, so keep it concise and clear. A well-written note can prevent frustration and make your ritual feel thoughtfully designed.
Integrating the Template into Your Book
Imagine you have designed a boss summoning ritual through Zen Summoning. You want players to find the instructions in your in-game handbook. Copy the template file into your book's templates folder, rename it to something like boss_summon.json, and fill in the fields. Next, add an entry in your book's main file using the patchouli:summoning_ritual type and reference the template. After restarting the game, the page appears automatically.
Working with Patchouli templates requires care with file paths and naming conventions, but the process is no more complex than configuring crafting recipes. Once you get the hang of it, you can rapidly produce documentation for every ritual in your pack.
Common Pitfalls and Solutions
New modpack makers often forget to set circle_type or mistype it. Remember that the value must be lowercase; "eldritch" works, while "Eldritch" will fail to load the texture. Double-check the item paths in your input slots as well. If a referenced mod is not installed, the book may fail to open entirely. Before publishing your pack, test every ritual page in-game to catch these issues early.
Another frequent mistake is placing the template file in the wrong directory. The templates folder must exist inside your book's namespace folder. If you are unsure, compare your structure with an existing Patchouli book from a known mod to verify the layout.
Final Thoughts
Summoning Ritual Template: Quick Ritual Documentation for Patchouli is an essential companion for creators building custom rituals through Zen Summoning. It eliminates repetitive layout work, giving you a ready-made structure with a visual circle and ingredient slots. While the template targets Minecraft 1.12.2, its underlying logic translates well to later versions with minor tweaks. By mastering this tool, you spend less time on technical details and more on the creative side of your modpack. Whether you are documenting a simple elemental rite or an elaborate boss encounter, this template helps you present your work with clarity and polish. For anyone serious about modpack development, it is worth a try.