The two ways to add mods to a server
Adding a mod to a Minecraft server depends on whether you run the server yourself or play on someone else's server. If you own the server, you install mods on the server files and restart it — everyone who joins will use those mods automatically. If you play on someone else's server, you install mods only on your own game client, and only mods the server owner has already approved will actually work when you join.
Most players run into trouble because they try to add mods the wrong way for their situation. This guide covers both paths so you know which one applies to you.
Key Takeaways
- Server-side mods go into the server's files and affect everyone who joins; client-side mods go on your own computer and only work if the server allows them.
- You need a mod loader like Forge or Fabric installed on your server before you can add any mods to it.
- The server version and your game version must match, or mods will not load and the server will not start.
- Restarting the server after adding mods is required — changes do not take effect while the server is running.
- Not all mods work together; adding too many at once makes it harder to find which one breaks the server if something goes wrong.
Adding mods if you own the server
Start by checking what mod loader your server uses. The two most common are Forge and Fabric. If you do not know which one your server has, look in your server folder for a file named "forge-installer.jar" or "fabric-installer.jar", or check the startup script (usually called "start.bat" on Windows or "start.sh" on Mac/Linux) to see which one is mentioned.
If your server does not have a mod loader yet, you need to install one first. Download the installer for your server version from the official Forge or Fabric website. Run the installer, point it to your server folder, and let it finish. Then start your server once to let it generate the necessary files, then stop it again.
Once the mod loader is in place, download the mod file you want (it will be a .jar file). Open your server folder and look for a folder called "mods". If it does not exist, create it. Drag the mod .jar file into the mods folder. Do not unzip it or change its name — leave it exactly as it is.
Stop the server if it is running, then start it again. Watch the startup messages in the server console. If the mod loaded correctly, you will see its name listed among the mods that are loading. If the server crashes or refuses to start, the mod may not be compatible with your server version or with other mods you have installed. Remove the mod file from the mods folder, restart the server, and try a different mod or a different version of the same mod.
Adding mods if you play on someone else's server
First, ask the server owner which mods are installed on their server. This is important because client-side mods only work if the server has them too, or if the server owner has said they allow that specific mod. Installing a mod your server does not support will not break anything, but the mod will not do anything either.
Install a mod loader on your own game client. Download Forge or Fabric for the same Minecraft version your server runs. Run the installer and choose "Install client" when it asks. This adds the mod loader to your game launcher.
In your game launcher, create a new installation that uses the Forge or Fabric profile you just installed. Launch the game once with this profile to generate the mods folder, then close the game.
Find your Minecraft folder on your computer. On Windows, it is usually in AppData\Roaming\.minecraft. On Mac, it is in Library/Application Support/minecraft. On Linux, it is in .minecraft in your home folder. Inside the Minecraft folder, open the mods folder. Download the mod files the server owner told you about and drag them into this mods folder.
Launch the game using your mod loader profile, join the server, and the mods should work. If they do not, double-check that you downloaded the right version of each mod for your Minecraft version.
Matching your mod version to your server version
This is the single most common reason mods fail to load. Every mod is built for a specific Minecraft version and a specific mod loader version. If you download a mod for Minecraft 1.19 but your server runs 1.20, the mod will not work.
Before you download any mod, check what version of Minecraft your server runs. If you own the server, look at your server.properties file and find the line that says "server-version" or check your server startup script. If you play on someone else's server, ask them or look at the server description in your multiplayer menu.
When you download a mod, the download page will list which Minecraft versions it supports. Make sure your server version is in that list. If it is not, look for a different mod that does the same thing, or wait for the mod author to release a version for your server version.
Troubleshooting when mods will not load
If your server crashes after you add a mod, the first step is to remove the mod and restart the server to confirm it works again. Then add mods one at a time instead of all at once. This way, if something breaks, you know exactly which mod caused it.
Check the server console for error messages. If you see a message that says "missing dependency" or "required mod not found", the mod you added depends on another mod that is not installed. Look at the mod's download page — it will list what other mods it needs. Download and install those first.
If the server starts but the mod does not appear to work in-game, make sure you are using the right mod loader profile in your launcher. Some players install Forge but then launch the game with the vanilla launcher by mistake, which means the mods never load.
If you see a message about "incompatible versions", the mod loader version does not match your Minecraft version. Reinstall the mod loader, making sure you download it for the exact Minecraft version your server runs.
Mods that commonly cause problems together
Some mods change the same parts of the game and conflict with each other. Large mods like Twilight Forest and Biomes O' Plenty both add new biomes, and running them together can cause world generation to break or the server to crash on startup.
Mods that change how the world generates — called "world gen" mods — are the most likely to conflict. If you want to use multiple world gen mods, research whether other players have run them together successfully. Check the mod's discussion page or Discord server to ask.
Performance mods like Optifine are client-side only and generally do not conflict with server mods. However, some mods are not compatible with Optifine, so if your game crashes after installing both, try removing Optifine to see if that fixes it.
Frequently Asked Questions
Do I need to restart the server after adding a mod?
Yes. The server reads mod files only when it starts up. If you add a mod while the server is running and then restart it, the mod will load. If you add a mod and do not restart, the mod will not be active.
Can I add mods to a server I do not own?
You can install mods on your own game client, but they will only work if the server owner has installed the same mods on the server. Ask the server owner which mods are available before you download anything.
What happens if I add a mod that is not compatible with my server version?
The server will either refuse to start or crash during startup. Remove the mod from the mods folder, restart the server, and download a version of that mod built for your Minecraft version instead.
Can I use mods from different mod loaders on the same server?
No. A server runs either Forge or Fabric, not both. All mods on that server must be built for the same loader. Check each mod's download page to confirm it supports your server's loader before you install it.
Why does my mod not work even though the server started?
The most common reason is that you are not using the mod loader profile in your launcher. Make sure you launch the game with the Forge or Fabric profile, not the vanilla launcher. If you own the server, also confirm that the mod is actually in the server's mods folder and that the server restarted after you added it.