Minecraft Mod Manager
License Required
The Minecraft mod manager requires the Minecraft Mods license add-on. Without this license, the Minecraft mod manager will not be available.
BadgerPanel includes a built-in mod manager for Minecraft servers. Users can search, browse, and install mods directly from the panel without manually downloading files.
Supported Sources
| Source | Description |
|---|---|
| Modrinth | Open-source mod repository with a large library of mods and modpacks |
| CurseForge | Popular mod platform (requires a CurseForge API key - see Settings) |
Browsing Mods
- Navigate to your Minecraft server and open the Mods tab from the sidebar.
- Use the search bar to find mods by name.
- Browse results with mod descriptions, download counts, and version compatibility.
- Filter by mod loader (Fabric, Forge, Quilt) and Minecraft version.
Installing a Mod
- Find the mod you want and click Install.
- Select the version compatible with your server's Minecraft version and mod loader.
- Click Confirm. The mod file is downloaded directly to your server's mods directory.
The server should be restarted after installing mods for them to take effect.
Managing Installed Mods
View all installed mods on the Mods tab. For each mod you can:
- Update - if a newer compatible version is available
- Remove - delete the mod file from the server
Modpack Browser
Browse and install complete modpacks:
- Switch to the Modpacks tab.
- Browse available modpacks from Modrinth.
- Click a modpack to see its description, mod list, and version history.
- Click Install to download and configure the modpack on your server.
Installing a modpack may replace existing mods and configuration files. Back up your server before installing a modpack.
Version Switching
Change your Minecraft server version or mod loader:
- Navigate to the server's Startup tab.
- Change the Minecraft Version variable.
- Select the appropriate Docker Image for your mod loader (Paper, Fabric, Forge, etc.).
- Restart the server.
Changing versions may require updating or removing incompatible mods.
Requirements
- The mod manager is available for Minecraft Java Edition servers
- Your server must use an egg that supports the mod manager feature
- CurseForge integration requires a CurseForge API key configured in Admin > Settings > Integrations
Next Steps
- Server Management - other server management features
- Eggs & Nests - configuring Minecraft egg templates