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
30
Size
8.4 MB
Mod Loaders
Forge
File ID
8570820
Type
R
Release
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.

This mod has no additional files