Minecraft mod manager
Add mods and plugins to a Minecraft server from the panel.
License required
The Minecraft mod manager needs the Minecraft Tools license add-on. Without this add-on the tab does not appear.
The Minecraft Mod Manager finds mods, plugins, and modpacks and installs them onto a server. The manager can also switch the server to another Minecraft version or another server type.
Opening the manager
- Navigate to your Minecraft server.
- Open the Minecraft Mod Manager tab in the sidebar.
The tab appears when your license includes the add-on and an administrator turned the module on for the egg of the server. See the Modifications tab in Eggs.
The page has five sub-tabs:
| Sub-tab | Purpose |
|---|---|
| Installed | Everything that the manager installed on this server. |
| Mods | Search for mods. |
| Plugins | Search for plugins. |
| Modpacks | Search for complete modpacks. |
| Version | Change the Minecraft version or the server type. |
The page opens on Installed.
Sources
Each search tab has a row of source buttons.
| Sub-tab | Sources |
|---|---|
| Mods | All, Modrinth, CurseForge |
| Plugins | All, Modrinth, Spigot, Hangar |
| Modpacks | All, Modrinth, CurseForge |
CurseForge needs an API key. Without the key the manager searches the other sources and skips CurseForge. See Adding the CurseForge Key.
Finding a mod or a plugin
- Open the Mods tab or the Plugins tab.
- Type in the search box. The manager searches as you type.
- Click a source button to search one source only.
Leave the box empty to see the popular items for that tab.
Each result card shows the icon, the name, the author, a short description, the source, the download count, and the game versions.
The results run to more than one page. Use Previous and Next below the list. Each page holds 20 results.
There is no filter for the mod loader and no filter for the Minecraft version. Read the version list on each card, and read the loader chips in the version dialog, to find a compatible build.
Installing a mod or a plugin
- Click Install on the result card. A dialog opens.
- Read the version list. Each row shows the version, the file size, the Minecraft versions, and the loaders.
- Click a version to select it.
- Click Install.
The dialog closes and the item appears on the Installed tab. A mod goes into the mods directory. A plugin goes into the plugins directory.
Restart the server after an install. The item loads at the next start.
The manager does not install the dependencies of a mod. If a mod needs a library mod, search for that library and install it as well.
Managing installed items
The Installed tab lists every item with its name, its version, its source, its type, and its file name.
There is no update action. To move a mod to a new version, uninstall it and then install the version that you want.
To remove an item, click the red trash icon on the card. The dialog reads:
The mod file is deleted from the server. Anything in your world that depends on it may stop loading. Restart the server after this for the change to apply.
Click Uninstall to confirm.
Installing a modpack
- Open the Modpacks tab.
- Type at least two characters in the search box.
- Click the download icon on the modpack card.
The install starts at once. There is no version picker and no confirmation dialog. The manager installs the newest version of the modpack.
WARNING
Take a backup before you install a modpack. A modpack install replaces existing mods and configuration files. You cannot undo it from this tab.
Changing the version or the server type
The Version tab shows the current server type, the Minecraft version, the build number, and the Java version.
- Select a server type. The types are grouped under Vanilla, Plugin Servers, Modded Servers, Hybrid, and Proxies.
- Select a Minecraft Version.
- Select a Build, or leave the field on the latest build.
- Click the switch button at the bottom.
The confirmation dialog lists every step:
- Stop the server.
- Delete the current server jar and libraries.
- Download the new build.
- Update the Java version.
- Restart the server.
The Delete world data checkbox is off by default. With the box clear, the world, the configuration files, and the mods stay in place. With the box set, the panel deletes the world and the server builds a fresh one at the next start.
WARNING
A version change can break the installed mods. Check that each mod has a build for the new version before you switch.
Adding the CurseForge key
- Get an API key from the CurseForge Console.
- Navigate to Admin > Webhooks & Integrations and open the Modifications tab. You can also use Admin > Settings > Integrations.
- Paste the key into the API Key field of the CurseForge card.
- Click Save Changes.
The card then shows Configured.
Requirements
- The server must use a Minecraft egg with the module turned on.
- Your license must include the Minecraft Tools add-on.
- CurseForge search needs an API key.
Next steps
- Server Management - the other server features.
- Eggs - how to turn the module on for an egg.