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.
All Relations
- All Relations
- Embedded Library
- Optional Dependency
- Required Dependency
- Tool
- Incompatible
- Include

