Open the Modding tab, click Mods, search for the mod and click Install. The panel picks the newest build for your Minecraft version and loader, adds the libraries it needs, and puts everything in the mods folder. Restart the server afterwards, because mods are only read when it starts.
Mods need a mod loader: Fabric, Forge, NeoForge or Quilt (the hybrids Magma, Ketting and Mohist also run Forge mods). If your server runs Paper, Purpur or Spigot, there is no Mods tab and a line under the tabs says so. Change the server type first: see How to change your Minecraft version or server type. For server-side extras such as homes or ranks, plugins are simpler: see How to install plugins on Paper, Spigot and Purpur.
A mod can stop your server from starting, and a mod that adds blocks changes your world. Take a backup first. See How to create, download and restore backups.
Install a mod
- Open your server in the panel and click the Modding tab, then Mods.
- Type the mod's name in Search mods. Source searches All sources, or only Modrinth or only CurseForge. Under the filters, Runs on shows your loader with
decided by your server. - Check the row. A mod made for another loader says Won’t run here, with a reason such as
Built for forge, and this server runs Fabric. - Click Install.
- If the mod needs libraries, a window titled Install and the mod's name lists them, each
required bythe mod, and says they are installed with itbecause the mod will not load without it.Click Install 2 files (the number counts every file). - The panel says
<name> is being installed. It will appear under Installed once the server has it. - Restart the server. The panel does not restart it after an install. See How to start, stop, restart and force-stop your server.
You need permission to create files to install.
Loaders and versions
Each mod is built for one loader and a few Minecraft versions:
- A Fabric server takes mods listed for Fabric. Most Fabric mods need the Fabric API mod too, which the install window adds when the mod's page lists it.
- A Quilt server takes mods listed for Quilt or Fabric.
- A Forge server takes Forge mods, and a NeoForge server takes NeoForge mods. The panel keeps the two apart: a mod built for one does not load on the other on current versions.
Install takes the newest stable build for your exact Minecraft version. If there is none, it takes the closest older build on the same version line only (for example another 1.21 build for a 1.21 server), because a mod built for another line crashes the server. If only a beta or development build fits, the message says so. To pick a build yourself, install the mod, then use Choose a version: see How to update plugins and mods on your Minecraft server.
What the panel checks first
Nothing is written until these checks pass:
- A library with no build for your server. The window title says the mod
cannot run hereand explainsInstalled as it is, your server would not start.Only Close is offered. Pick another version of the mod, or another mod. - A newer Java. If the mod needs a newer Java than your server runs, the panel stops with a message such as
<mod> needs Java 25, and this server runs Java 21. Installing it would stop your server starting.It tells you which Java setting to choose, or to pick an older version of the mod. See How to change the Java version of your Minecraft server.
All the refusals and their fixes are in A plugin or mod will not install on your Minecraft server.
Check that it loaded
- After the restart, open the Console and watch the start. The loader lists the mods it loads, and errors name the mod that caused them.
- Open Modding, Mods, Installed. The mod is listed with its version.
- Join with the same mods on your own computer and look for what the mod adds.
If the server stops while it starts, the Why your server stopped card on Overview names the cause. See How to see why your Minecraft server stopped. Common causes have their own guides: A Minecraft mod needs another mod that is not installed, A mod is made for a different Minecraft version and A client-only mod stops your Minecraft server.
Your players need the mods too
Mods that add blocks, items or mobs must be on every player's computer as well, with the same loader and Minecraft version. Mods that only change a player's screen belong on their computer only. See How to get your players ready for a modded Minecraft server.
Good to know
- Change a mod's settings: How to edit plugin and mod settings on your Minecraft server.
- Update, switch off or remove a mod: How to update plugins and mods on your Minecraft server and How to switch off or uninstall a plugin or mod on your Minecraft server.
- A mod from another site: How to upload your own plugins or mods to your Minecraft server.
- A whole set of mods at once: How to install a modpack on your Minecraft server.
- Magma, Ketting and Mohist run Forge mods and Bukkit plugins together, so they show both Plugins and Mods. See Minecraft server types explained.



