Guide Forge 1.3.2 (Server Fix)
Curse Maven Snippet
What's new
📘 Version 1.3.2 (Forge) — Complete client/server architecture separation, dedicated server compatibility achieved.
🔧 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.• Cleaned Event Bus Registrations — Removed manual
MinecraftForge.EVENT_BUS.register(PlacementProjector.class) from the mod constructor, relying solely on the automatic @Mod.EventBusSubscriber annotation with value = Dist.CLIENT. This ensures projection logic never loads on a dedicated server.• DistExecutor-Free Invocation — Replaced risky
DistExecutor calls in ModItems with a safe call to the client-only GuideScreenOpener, guaranteeing zero classloading violations when the book item is used on a server.• Network & Quest Sync — Maintained full
SimpleChannel networking with proper server-authoritative quest state handling and client synchronization, keeping multiplayer functionality intact.
✨ What This Means:
✅ Servers no longer crash on startup when Guide is installed.
✅ Mod can be safely added to any Forge 1.20.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.
This mod has no additional files

