Back to 9Minecraft
Wiki 9Minecraft Wiki 9Minecraft

Modonomicon FAQ

20 questions players actually ask, answered.

How do I get the Modonomicon book in-game?
The Modonomicon item is typically given by the mod that ships the book, either as a starting item, a craftable item, or via a command. If you're the pack author, you can hand it out with a give command or place it in a loot table. Check the mod that provides the book for its specific acquisition method.
How do I open the Modonomicon once I have it?
Hold the Modonomicon and right-click (use) it to open the guide interface. If nothing happens, make sure you're holding the correct book item and not a different mod's guide.
Why does my Modonomicon book show blank pages?
Blank pages usually mean the book's JSON content failed to load, often from a syntax error or a missing referenced entry. Check your datapack or mod's log for parsing errors and verify the entry and page files exist in the expected folder.
How do I add a new entry to a Modonomicon book?
Create a JSON file for the entry in the book's data folder, then reference it from the book's category or index file. Each entry needs an ID, a title, and one or more pages with content.
How do I unlock a Modonomicon entry so players can see it?
Entries can be gated behind advancements, items, or other conditions defined in the entry JSON. Until the condition is met, the entry stays hidden or locked in the book. Remove the condition or grant the advancement to make it visible.
Can I use Modonomicon without writing any code?
Yes, if the book content is defined through datapack JSON files rather than Java. You can add entries, pages, and categories by editing JSON, but the book itself must already be registered by a mod.
What's the difference between a category, an entry, and a page in Modonomicon?
A category is a top-level tab or section in the book, an entry is a single topic within a category, and a page is one screen of content inside an entry. Entries can contain multiple pages that players flip through.
Why isn't my Modonomicon book showing up in the creative menu or JEI?
The book item only appears if the mod that registers it is loaded and the item is added to a creative tab or search index. If you're a pack author, add it to a creative tab or it won't show in search.
Does Modonomicon work on a server with clients that don't have the mod?
Modonomicon is a content and UI library, so clients generally need it installed to render the book interface. Check the mod's requirements for whether it's client-side, server-side, or both.
Does Modonomicon affect performance or cause lag?
Modonomicon itself is lightweight since it mainly loads JSON content and renders a book UI. Lag is more likely from a very large number of entries or pages, or from other mods, rather than the book system itself.
What is the Modonomicon Mod?
Modonomicon is an in-game documentation mod inspired by Thaumcraft's Thaumonomicon and Patchouli. It lets you create books that display text, recipes, images, items and more.
How do you create a book in Modonomicon?
Books are fully data-driven and created via datapack, so both modpacks and mods can add books. You do not craft them in-game.
Does Modonomicon work with modpacks?
Yes, use in modpacks is allowed without restrictions as long as the MIT and CC-BY-4.0 license conditions are fulfilled. Linking to the project page counts as fulfilling them.
What Minecraft versions does Modonomicon support?
The listed Minecraft versions are 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2 and 26.3. It is available for Fabric, Forge and NeoForge.
Does Modonomicon support Fabric, Forge and NeoForge?
Yes, Modonomicon lists fabric, forge and neoforge as its loaders.
What can Modonomicon pages display?
There are various page types to display text, recipes, images, items and more. Content can be styled with extended Markdown syntax.
How do you unlock entries in Modonomicon?
Modonomicon has an extensible condition system to unlock entries. Unlock conditions are one of the features shown on its project page.
Does Modonomicon support multiblocks?
Yes, it has Patchouli-like multiblocks, but they are fully data driven.
Can other mods add features to Modonomicon?
Yes, Modonomicon is made to be extensible, so mods can add new features such as recipe pages for mod-specific crafting methods.
What config options does Modonomicon have?
The mod config includes enableSmoothZoom, fontFallbackLocales, qol and storeLastOpenPageWhenClosingEntry.