How to Install Minecraft Server Mods

Check the requirements

1. Read the mod author’s supported game versions, loader and dependencies. Check your installed loader in Console.
2. Use server or shared mods. Leave client only mods, such as rendering changes, off the server.
3. Back up and stop the server before changing its mod set.

Use the Mods page

1. Open Mods and search for the mod.
2. Choose Select version and pick a release for your game version and loader.
3. Install required library mods too. Fabric API is separate from Fabric Loader.
4. Wait for installation to finish, then start the server and check Console.

Upload a JAR manually

1. With the server stopped, open mods in the main server folder. Create it if the loader has not done so.
2. Upload the mod .jar, not the loader installer. Replace old versions instead of keeping duplicate JARs.
3. Start the server and join with the matching game, loader and any required client mods.

If startup or joining fails

Read the first dependency or version error in Console or logs/latest.log. Compare client and server releases. Removing a mod can remove its blocks and items from a saved world, so restore the matching world and mod backup when rolling back.

Further help: Fabric mod compatibility, Fabric server requirements and NeoForge server setup.

Related: Choose a loader · Install a modpack · Minecraft hosting.