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.0.1 (NeoForge) — Complete client/server architecture separation, dedicated server compatibility for NeoForge 1.21.1.
🔧 Core Architecture & Server Safety:
• Full Client/Server Decoupling — Completely refactored the mod's class hierarchy to strictly separate client-side GUI and rendering logic from server-side data and networking. All screens, renderers, and input handlers are now annotated with
@OnlyIn(Dist.CLIENT), preventing any accidental classloading on dedicated servers.• Safe Screen Opener Proxy — Introduced
GuideScreenOpener as a client-only bridge to safely instantiate screens without exposing Screen subclasses to server code, eliminating BootstrapMethodError crashes when opening the guide book.• Fixed AutomaticEventSubscriber Loading — Ensured that all client-only subscribers (commands, key mappings, GUI events) explicitly use
@EventBusSubscriber(value = Dist.CLIENT), preventing the NeoForge AutomaticEventSubscriber from loading them on dedicated servers.• FMLEnvironment-Aware Invocation — Replaced all direct references to client classes from common items with
FMLEnvironment.dist.isClient() checks, guaranteeing zero classloading violations on the server side.• Modern Network Layer — Ported the mod's packet system to NeoForge's
CustomPacketPayload and PayloadRegistrar, ensuring seamless multiplayer quest synchronization without legacy channel overhead.
✨ What This Means:
✅ NeoForge servers no longer crash on startup when Guide is installed.
✅ Mod can be safely added to any NeoForge 1.21.1 modpack without server-side issues.
✅ All client features (GUI, projection, sounds, mob renderers) remain fully functional in singleplayer and on servers for connected clients.
✅ Achieves feature parity with the Forge branch while utilizing native NeoForge APIs.
This mod has no additional files