Minecraft Common Issues

Cannot Connect - "Connection Refused"

Verify the server is running (green "Online" status on your Dashboard).

Check the address. Copy the "Server Address" row from the Overview tab exactly - a hostname and a port together. The port is assigned by the platform, so it is not 25565 and players must always include it.

Make sure online-mode is true in Settings. Cracked clients cannot join a legitimate server.

If using a whitelist, add the player in Settings > Player Management > Whitelist, or run "whitelist add <name>" in the Console tab.

The Players figure on the Overview tab comes from a Server List Ping to your server. A dash means the ping got no answer; run "list" in the Console tab to see who is on.

Version Mismatch

Players must use the same Minecraft version as the server. The build your server is running is shown on the Admin tab, in the Game Updates card - not on the Overview tab.

Players change version in the Minecraft launcher by editing the profile.

If you want multiple versions, use a proxy like Velocity or BungeeCord (advanced - not supported out of the box on GameGrid).

For modded servers, players must use the same mod loader (Fabric/Forge/NeoForge) and version as the server.

Mod Conflict on Startup

Symptoms: server crashes on startup, "duplicate mod" or "missing dependency" errors in the console.

Check the Console tab for the specific error. It usually names the conflicting mods.

Remove the conflicting mod from the "mods" folder via the File Manager and restart.

Some mods require library mods (like Fabric API). Make sure all dependencies are installed.

Mods must match the mod loader. A Fabric mod will not load on Forge or NeoForge, a Forge mod will not load on NeoForge, and none of them load on Paper or Vanilla. They are all .jar files in mods/, so the wrong one goes in without complaint - re-check the loader label on each mod's download page.

World Corruption

Symptoms: server crashes when loading a specific area, chunks reset to default, players fall through the world.

Stop the server immediately. Do not keep restarting - each failed start can corrupt more data.

Restore the most recent backup from the Backups tab.

If no good backup exists, you can delete the corrupted region files via the Files tab. The Overworld is in <level-name>/region/. On Paper the Nether and End are separate top-level folders - <level-name>_nether/region/ and <level-name>_the_end/region/; on Vanilla, Fabric, Forge and NeoForge they are <level-name>/DIM-1/region/ and <level-name>/DIM1/region/. Deleting a region file loses those chunks and saves the rest of the world.