Forge Server Tools · every failure mode · guides

Players getting kicked from a modded server for a mod mismatch

Why clients bounce at Joining world, which mods must match and which must not, and how to read the rejection list.

What the server is telling you

Clients disconnect at "Joining world", or with a list of mods in the kick message. Forge compares the client's registry and mod list against the server's, and refuses anything that does not line up.

The rule that resolves most of these

Mods fall into three groups, and people routinely treat them as one:

A client-only mod is not something to "add to the server so it matches". Mark it client-side in your pack config instead.

Read the rejection list properly

The kick message names what disagreed. Two patterns worth knowing:

After changing the pack

Everyone must have the same pack version. The usual failure is one player who did not re-download. Bump the pack version so the launcher forces an update rather than relying on people to do it.

See the full mod-rejection write-up.

Doing this automatically

Forge Server Doctor performs the whole procedure above — reads the report, finds the real cause under the wrappers, skips the vanilla frames, and names the mod jar. 24 failure modes, each with its fix. The free edition covers the six most common startup failures.