When running or updating a modded Forge server, you can sometimes run into issues with mods or configs being different between the server and the client. While your server can sometimes automatically fix this issue, mainly in the case of configs being different, this can lead to players being unable to connect to the server. You can fix this issue by manually re-synchronising the mods and configurations on your server with the ones on your client, ensuring that they are the same.
Prevention Methods
To prevent running into mod mismatch errors, there are a few suggestions we have to avoid the potential of these occurring.
- Using official modpacks from our Minecraft modpack installer - These are mod packs that are already made by other players, which you can install on your client with programs such as CurseForge or the FTP app.
- When doing this, please ensure that the version of the modpack matches both on the client & server.
- Manually installing server packs - Our Minecraft modpack installer may not have the modpack/version you desire, so you may be required to install the server pack. Please be aware that not all modpacks have an available server pack, therefore we would recommend avoiding installing these to servers as it's very likely to contain many client-side mods that will break your server.
Resolving a Mod Mismatch
To resolve a mod mismatch, please follow the steps below.
- Access your control panel and Stop your server.
- As you will be deleting server files in order to update them, it is highly advisable to create a backup of your server prior to making any file edits. You can read our guide on how to do this here: How to Manually Backup Your Minecraft Server
- Access your server files via FTP, we suggest using FileZilla.
- Delete both the mods and config folders from your server. These are the two main folders that can lead to mods being mismatched; configs for mods also need to be synchronised for connections to be successful.
- Locate the modpack install folder for the modpack you are using. If you are using a modpack provided by an external launcher, you will be able to find the install folder according to this guide: How to Locate Your Minecraft Modpack Folder
If you are using a self-made modpack that you installed manually, this will be in the .minecraft folder wherever you installed the game. This varies per operating system and install, but should look something like this depending on your platform:
- Windows:
%AppData%/.minecraftorC:/Users/(username)/AppData/Roaming/.minecraft - MacOS:
~/Library/Application Support/minecraft - Linux:
~/.minecraft
- Windows:
- After locating your modpack install folder, open it and upload both the mods and config folders.
- Once the uploads are complete, start your server! Your server should now be running with the same mods and configs as your client, and you should now be able to connect successfully.
It's important to remember that some mods, such as OptiFine or any minimap mods, only work on the client and not the server. While Forge tries its best to disable these mods by detecting that they're client-only, sometimes this doesn't work and will result in your server crashing while loading. If this happens to be the case, simply remove any mods that are client-side only, or contact our support team for assistance! We're always on hand to help you resolve server issues.
If you require any further assistance, please contact our support at: https://shockbyte.com/billing/submitticket.php