Fabric or Forge
Mods need a mod loader on the server. Fabric and Forge are the two you can pick. A mod built for one doesn't load on the other, so pick the loader your mods were made for.
Mods and Paper plugins don't mix. A Fabric or Forge server ignores the plugins folder.
Switch the server type
- Make a backup in Backups.
- Open Startup in the panel.
- Set Server type (SERVER_TYPE) to fabric or forge.
- Check that Minecraft version (MINECRAFT_VERSION) matches the version your mods are for.
- Press Save variables. The server stops and reinstalls with the new software.
- Start the server again once the reinstall is done.
Add mods
- Open Mods and plugins in the panel and search for the mod. The page shows only mods for your loader and Minecraft version.
- Press Install, pick a version and press Install again. The server downloads it from Modrinth into the mods folder.
- Restart the server.
For a mod that isn't on Modrinth, open Files. If there's no mods folder, press New folder and name it mods. Open mods and press Upload for each mod's .jar file.
Many Fabric mods also need the Fabric API mod. Each mod's download page lists what else it needs.
Watch out: The preview accepts uploads up to 512 KB and the server is simulated, so mods don't really load yet.
What your players need
Mods that add blocks, items or creatures usually need to be on every player's game too, with the same loader and versions. Mods that only change the server, such as performance mods, don't.
Big modpacks can need more memory than Rookie's 2 GB. Switch the server to the free Turbo tier for 6 GB, add RAM in the Market, or make it premium if it still runs short.