The simplest way to add a mod to your server

Adding a mod to a Minecraft server means placing the mod file into a specific folder on the computer running the server, then restarting the server so it loads the new code. The exact process depends on whether you are running the server yourself on your home network or paying a hosting company to run it for you. If you host the server yourself, you read the mod file, move it into the mods folder, and restart. If a hosting company runs your server, you usually upload the mod file through their control panel instead.

The most common mistake is downloading a mod built for a different Minecraft version than your server runs. A mod for Minecraft 1.20 will not work on a server running 1.19, and the server will either crash or refuse to start. Before you read anything, check what version your server is actually running — not what you think it is.

Key Takeaways

  • Mods only work if they match your server's exact Minecraft version, so verify your version number before downloading.
  • Self-hosted servers require you to place mod files in the mods folder and restart the server; hosting companies require you to upload through their control panel.
  • Most mods need Forge or Fabric installed on the server first — these are mod loaders that let the server understand mod code.
  • After adding a mod, restart the server and check the server log to confirm the mod loaded without errors.
  • Mods can conflict with each other or with plugins, so add one mod at a time and test before adding more.

Check your server version and mod loader before downloading

Open your server's properties file or control panel and write down the exact Minecraft version number. It will look like "1.20.1" or "1.19.2" — the numbers matter. Then check whether your server is already running Forge or Fabric. These are mod loaders, which means they are programs that sit between Minecraft and your mods and translate the mod code so the server understands it. Most servers run one or the other; some run neither.

If your server does not have a mod loader installed yet, you will need to install one before any mods will work. Forge is older and more widely supported; Fabric is newer and lighter on system resources. For a home network server, either works, but check which one the mods you want actually support — a mod built for Forge will not load under Fabric.

Once you know your version and your mod loader, search for the mod by name on CurseForge or Modrinth, the two largest mod repositories. Both sites let you filter by version and mod loader, so you can find the exact file that matches your setup. read the .jar file — that is the mod file itself.

Adding a mod to a self-hosted server

Navigate to the folder where your server files live on your computer. Inside that folder, look for a folder named mods. If it does not exist, create a new folder and name it exactly "mods" — the spelling and lowercase letters matter. Drag the .jar file you downloaded into this mods folder.

Stop the server if it is currently running. On Windows, close the server window. On Mac or Linux, use the stop command in the server console. Wait 10 to 15 seconds for the server to shut down completely, then start it again. Watch the server log as it starts — you should see a line that says the mod loaded. If you see an error message instead, the mod version does not match your server version, or the mod loader is not installed.

Once the server finishes starting, join it and check that the mod is working. Some mods add new items or commands you can test when ready; others change how the world generates, so you may need to explore a new area to see the difference.

Adding a mod through a hosting company's control panel

Log into your hosting company's control panel — this is usually a website where you manage your server settings. Look for a section called "File Manager", "FTP", or "Mods". The exact name varies by company, but the idea is the same: you are uploading files to the server computer.

Navigate to the mods folder using the file manager. If no mods folder exists, create one. Click the upload button, select the .jar file you downloaded, and wait for the upload to finish. Then restart the server through the control panel — there is usually a red "Stop" button and a green "Start" button.

Check the server log after restart to confirm the mod loaded. Most hosting companies show you the log in the control panel itself, usually under a "Console" or "Logs" tab. If the mod did not load, the error message will tell you why — usually a version mismatch.

Testing the mod and troubleshooting common problems

Join the server and look for signs the mod is working. If the mod adds new blocks or items, use the creative inventory to find them. If it changes world generation, fly to a new chunk and look for the new structures or terrain. If nothing seems different, check the server log again — the mod may have loaded but encountered an error that prevented it from running.

The most common error is "mod version does not match server version". This means you downloaded a mod for Minecraft 1.20 but your server runs 1.19, for example. Go back to CurseForge or Modrinth, find the same mod in the version your server actually runs, and read that instead.

If you see "Forge not found" or "Fabric not found", the mod loader is not installed. You will need to install it before the mod can load. This is a separate process from adding the mod itself — your hosting company's documentation or support team can walk you through it.

If you added multiple mods at once and the server will not start, remove all of them and add them back one at a time. Mods can conflict with each other in ways that crash the server, and adding one at a time tells you which mod is causing the problem.

Understanding mod conflicts and when to ask for help

Two mods can conflict if they try to change the same part of Minecraft in different ways. The server will usually crash on startup if this happens. If you added two mods and the server stopped working, remove the most recent one and restart. If the server starts, the removed mod was the problem — either it does not work with the other mod, or it does not work with your server version.

Some mods also conflict with plugins, which are a different way to add features to a server. If your server runs plugins and you add a mod that changes the same mechanics, they may fight each other. Check the mod's documentation on CurseForge or Modrinth to see if it mentions known conflicts.

If the server log shows an error you do not recognize, copy the error message and search for it on the mod's page or on the Minecraft forums. Usually someone else has seen the same error and posted a solution. If you are using a hosting company, their support team can also help — include the full error message when you contact them.

Frequently Asked Questions

Do I need to install mods on the client side too, or just the server?

It depends on the mod. Server-side mods (like those that change world generation or add new blocks) only need to be on the server — players joining with vanilla Minecraft can see the changes. Client-side mods (like those that change how the player's screen looks) need to be installed on each player's computer. Some mods are hybrid and need to be on both. Check the mod's page on CurseForge or Modrinth to see which it is.

Can I add mods to a Minecraft Realms server?

No. Minecraft Realms is a hosting service run by Microsoft, and it does not let you upload mods. You can only use mods on a self-hosted server or a third-party hosting company that supports them. If you want mods, you will need to switch to one of those options.

What happens if I remove a mod after players have used it?

If the mod added blocks or items to the world, those blocks will turn into error blocks (usually purple and black checkerboard) when the mod is removed. The world will not break, but any structures built with the mod's blocks will look wrong. Players can still break and remove the error blocks. If the mod only changed mechanics without adding new blocks, removing it usually has no lasting effect.

How do I know if a mod is safe to read?

read mods only from CurseForge or Modrinth — these are the official repositories where mod creators post their work. Both sites scan uploads for malware. Avoid downloading mods from random websites or Discord links, as these are common sources of viruses and malware. Check the mod's page for a large number of downloads and recent updates, which usually means it is actively maintained and trustworthy.

Can I use mods from different mod loaders on the same server?

No. A server runs either Forge or Fabric, not both. All your mods must be built for whichever loader your server uses. If you want to use mods from both loaders, you will need to choose one loader and find alternative mods built for it, or run two separate servers.