☰

Minimap Mod Installed on Server

A minimap mod (such as JourneyMap or Xaero's) was put on the server and crashed it. Minimaps render an on-screen map on the client and have no place on a dedicated server.

What does this error mean?
Minimap mods draw map overlays using client rendering. On a server they try to load client-only classes for the DEDICATED_SERVER dist and fail. Some minimaps offer an optional server companion, but the main mod is client-side. 
Attempted to load class net/minecraft/client/... for invalid dist DEDICATED_SERVER
Most Common Causes
  • The client minimap jar placed in the server mods folder.
  • Copying all client mods to the server.
  • Confusing the client mod with its optional server add-on.
  • A pack that did not exclude the minimap.
  • Assuming the minimap needs to be server-side.
How To Diagnose
  1. Confirm the crash names the minimap mod / a client class.
  2. Check the server mods folder for the minimap jar.
  3. See whether the mod offers a separate server companion.
  4. Look for other client-only mods present.
Recommended Fixes
  • Remove the minimap mod
    Delete the client minimap from the server, players keep it on their clients.
  • Add only the server companion
    If the minimap has an optional server-side add-on (e.g. for cave/radar control), install just that.
  • Keep minimaps client-side
    Minimaps are a client convenience, they belong on each player's client.
  • Audit client mods
    Remove other client-only mods from the server folder.
Analyze My Log
Frequently Asked Questions

Yes, it runs on your client. It just cannot be on the server.

Some minimaps ship a small optional server plugin/mod, that one is server-safe, the main mod is not.

It tries to load client rendering code that does not exist on a dedicated server.