Mods change the game itself: new blocks, mobs, dimensions and machines. Unlike plugins, every player needs the same mods installed on their own game too.
Install a whole modpack (easiest)
- Take a backup first: installing a pack replaces your server files.
- Open your server in the game panel and go to Modpack Installer.
- Search for the pack. Sources: CurseForge, Modrinth, ATLauncher and Technic.
- Pick the version and press Install. The panel sets up the right Forge or Fabric version for you.
- Start the server. The first start of a big pack can take a few minutes.
Players install the same pack and version with the CurseForge app, Modrinth app or ATLauncher, then join your server address.
Add single mods
- Make sure your server runs Forge or Fabric. Switch with the Version Changer if needed (take a backup first).
- Go to Mod Installer, search on Modrinth or CurseForge, and pick the version for your Minecraft version and loader.
- Restart the server.
Some mods are client-only (like minimaps or shaders) and don’t belong on the server.
Mods that aren’t in the installer
Upload the .jar into the mods folder with Files or SFTP, then manage and update it with the Custom Mod Manager.
Common problems
- Server crashes on start: a mod is for the wrong Minecraft version or loader, or it needs another mod. The console names the mod.
- ”Mod rejections” when joining: the player’s mods don’t match the server. Use the same pack version.
- Lag: big packs need more RAM. See Choose the right Minecraft plan.