Guide
- By
An interactive in-game guidebook mod featuring smooth UI rendering, Markdown parsing, and 3D multiblock previews.
Curse Maven Snippet
What's new
📘 Version 1.5.0 (Forge) — Themes, External Libraries, Hotfix
🛠️ Changes:
• External Library Download — FFmpeg, JavaCPP and JavaCV are no longer bundled inside the mod JAR. They are now downloaded at runtime from an external source, and the correct build is chosen automatically based on the player's operating system (Windows, macOS or Linux).
• Faster First Launch Setup — Libraries are fetched once and cached locally. Subsequent launches skip the download entirely.
• Updated Library Extractor —
JavaCvResourceExtractor now copies only the required JARs (ffmpeg, javacpp, javacv and their platform-specific natives) into the cache folder instead of the full suite.• Build Configuration Cleanup — Removed platform-specific native libraries from
build.gradle; the mod no longer ships any native binaries directly.• Theme System — Fully JSON-driven UI theming. Custom themes live in
config/guide/themes/, support per-book overrides via book.json ("theme": "<id>"), and can be globally locked through config/guide-client.toml (locked_theme).• Six New Built-in Themes —
blood, forest, cyberTech, matrix, sakura and honey. Each theme ships with its own color palette and matching visual effect.• Built-in Visual Effects — Each theme can enable exactly one animated effect to avoid visual artifacts:
–
bloodEffects — screen shake, border pulse, red flashes. –
forestEffects — wind, rustling leaves, green highlights. –
cyberTechEffects — neon lines, flicker. –
matrixEffects — falling characters, green glow. –
sakuraEffects — pink petals, gentle sway. –
honeyEffects — warm tones, animated honey drops and bees.• Hot-Reload for Themes — Edit any theme file on disk and run
/guide reload to apply changes instantly, without restarting the game.• Per-Book Theme Overrides — Any book can force its own theme via the
theme field in book.json. The book theme has priority over the global theme and is restored when the book is closed.
🔧 Improvements:
• Smooth Theme Interpolation — Panels, borders, scrollbars and text now interpolate colors smoothly when switching themes.
• Translation-Aware Theme Names — Theme
displayName supports translation keys with fallback to per-book lang files, shared cache and built-in mod lang.
🐛 Fixes:
• Reduced JAR Size — Mod file size cut down from 40+ MB to 9+ MB by removing bundled native libraries and unused resources from the mod archive.
• Compatibility with Upload Limits — The smaller JAR now fits within strict platform upload limits without any loss of functionality.
• No Functional Changes — All features work exactly as before. Only the packaging of native libraries was changed.
![]()
This mod has no additional files