promotional bannermobile promotional banner

Guide

An interactive in-game guidebook mod featuring smooth UI rendering, Markdown parsing, and 3D multiblock previews.
Back to Files

Guide Forge 1.3.2 (Server Fix)

File nameguide-1.3.2.jar
Uploader
deaddieseldeaddiesel
Uploaded
Aug 3, 2026
Downloads
660
Size
8.4 MB
Mod Loaders
Forge
File ID
8570820
Type
B
Beta
Supported game versions
  • 1.20.1

Curse Maven Snippet

Forge

implementation fg.deobf("curse.maven:guide-1570742:8570820")

Learn more aboutΒ Curse Maven

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.