Unconfusion
by Blue-Beaker
Unconfusion is a Forge utility for 1.12.2 that turns in-game manuals into paged, structured tutorials for modpacks and the players who use them.
What it does
Modpack authors can write manual entries as pages built from elements, so a page can present a GUI, a recipe, or a detailed explanation of a machine. Pages are defined with CraftTweaker ZenScript, and the mod supports ZenUtils hot reload to speed up editing. Entries added to JEI need a game restart before they take effect.
The structure view renders a multiblock or build directly on a page, which helps players see how a machine is assembled. A structure is loaded into a single dummy world, so some blocks with custom rendering that depends on a normal client and server setup may not display properly there. The mod includes built-in compatibility fixes for several known mods to address this.
Unconfusion runs on the client only, so players install it and servers do not need it. It is open source under the MIT License and has its latest Forge file, 0.2.2 for 1.12.2, published on 2026-07-22 in the beta channel. The first release came out on 2026-04-22.
Key features
Paged manual entries
Manual entries are split into pages, and each page is assembled from elements that present content in a readable order.
Structure view pages
A page can show a rendered structure, letting players inspect a build from every side before they place it.
Scripted entries
Entries and pages are written in CraftTweaker ZenScript, so pack authors can add manuals without writing Java.
Built-in compatibility fixes
Render and savedata fixes cover IC2 tile entities, EnderIO cables, BuildCraft tile entities, and ForgeMultiPart and CBE microblocks.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Who it’s for: Modpack authors who want to add tutorials and manuals to a 1.12.2 pack, and players who use those packs and need guidance on machines and systems.
How it compares
LootTweaker is a Forge tool for 1.10.2 – 1.12.2 that edits loot tables from the server side, so it is server required and client optional, and it is open source under the MIT License. Immersive Engineering Blueprint Tweaker targets only Forge 1.7.10, is also server required with an optional client, and is open source under the MIT License. Unconfusion differs from both by being client-side only and focused on manuals rather than data changes.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Unconfusion | Forge | 1.12.2 | Client-side only | 2026-07-22 |
| LootTweaker | Forge | 1.10.2 – 1.12.2 | Server required, client optional | 2026-02-27 |
| Immersive Engineering Blueprint Tweaker | Forge | 1.7.10 | Server required, client optional | 2022-07-14 |
Questions
Does Unconfusion need to be installed on the server?
Why do new JEI entries not appear immediately?
Why do some blocks render incorrectly in the structure view?
In the catalog
Unconfusion is one of 36,990 Utility mods on ModsFinder, and one of 14,575 Utility mods for Forge. 2,920 mods support Minecraft 1.12.2.
More from Blue-Beaker
Similar mods
What the author says
Features: - Paged manual entries - Structure view pages - Element-based pages, can be used to represent GUIs, or provide detailed explanations. - Uses CraftTweaker ZenScript to create entries and pages - Support ZenUtils' hot reload feature (note that JEI entries needs restart to take effect) Notes: - In structure…
Official listing
- Modrinth page
- modrinth.com/mod/unconfusion
- Owner
- Blue-Beaker
- Published
- 2026-04-22
- Updated on Modrinth
- 2026-07-22
- Facts verified
- 2026-10-15