Guide

[CHANGELOG] Version 1.3.0 (NeoForge)

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.
• Full Feature Parity with Forge 1.5.0 — The NeoForge branch now ships the same feature set as Forge: themes, visual effects, per-book overrides and hot-reload support.

🔧 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.
• JDK 21 Support — Build and runtime now target Java 21 to match NeoForge 21.1 requirements.
• NeoForge 21.x Migration — Updated to the latest NeoForge modding conventions.

🐛 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.