How to add mods to your server

How to Add Mods to a Minecraft Server

This doc shows server owners how to upload individual mods to a Forge, Fabric, or NeoForge server, match versions on the client, and fix the errors that show up when something doesn't load.

Before you start

• Make sure your server already runs Forge, Fabric, or NeoForge. Check this on Startup.
• Restart the server after uploading. The mod won't load until you do.

Steps

1. 1Check your loader and Minecraft version on Startup.
2. 2Download the mod's .jar from CurseForge or Modrinth. Pick the build made for your loader and version.
3. 3Go to Files, open /mods. Create the folder if it's not there.
4. 4Upload the .jar.
5. 5Restart the server.

Over SFTP instead: connect, then drop the .jar straight into /mods.

If the mod affects gameplay, tell your players to install the same .jar, same version, in their own mods folder before they join.

Verify

Restart, then watch Console. Confirm the mod's name shows up in the loading lines, and check the count matches what's in /mods.

If it doesn't work

• Server won't start: wrong loader. Redownload the build made for your loader and reupload it.
• Errors in Console after it loads: missing dependency. Check the mod's page for required libraries, like Fabric API, download those too, then restart.
• Players get kicked with a mod list on connect: send them the exact .jar you used, same version, to install on their end.
• Mod does nothing in game: wrong Minecraft version. Download the build for your server's version instead.