Guide

[CHANGELOG] Version: 1.3.2 (Forge)

Complete client/server architecture separation — dedicated server compatibility finally achieved for Forge 1.20.1, eliminating all startup crashes while keeping every client feature intact.

Core Architecture & Server Safety:

• Full Client/Server Decoupling — Every screen, renderer, and input handler now strictly lives behind client-only boundaries. The server no longer attempts to load GUI classes, preventing the infamous Screen loading crash on startup.

• Safe Screen Opener Proxy — A dedicated client-side bridge now handles opening the book interface without ever exposing screen subclasses to common server code, completely removing BootstrapMethodError risks.

• Clean Event Bus Registrations — Removed all manual client-side registrations from the mod constructor and switched entirely to automatic EventBusSubscriber with explicit client-side distribution flags, ensuring projection and rendering hooks never load on dedicated servers.

• DistExecutor-Free Item Logic — Replaced ambiguous DistExecutor calls in book items with direct safe invocations to the client-only opener, guaranteeing zero classloading violations when the book is used on a server.

• Persistent Multiplayer Sync — Quest states, favorites, and network synchronization remain fully functional through the existing SimpleChannel pipeline, keeping multiplayer compatibility robust.

What This Means for Players & Server Owners:

✅ Forge 1.20.1 servers no longer crash when Guide is installed — the mod is now fully dedicated-server safe.

✅ All client-side features (animated GIFs, 3D mobs, soundscapes, placement projector) continue to work flawlessly in singleplayer and for connected clients on multiplayer servers.

✅ The mod can be safely added to any modpack without requiring server-side workarounds or removal of the JAR.