Skip to main content

Install and manage mods

Mods change the game itself: new blocks, creatures, machines and mechanics. On a mod server, the Mods page lets you find and install mods from Modrinth directly from the panel.

The Mods page replaces Plugins in the MINECRAFT sidebar group when your server runs a mod loader: Fabric, Forge or NeoForge. To switch loader, see Versions. If you want plugins, not mods, see Plugins.

The page header shows what your server runs, for example "Fabric · Minecraft 1.21.4", so you know which mods will fit.

Install a mod​

  1. Open Mods in the MINECRAFT group.
  2. On the Browse tab, look through the list or use Search.
  3. Click Install on the mod you want. The panel picks the file that matches your loader and Minecraft version for you.
  4. Restart the server from the Console. The page reminds you to restart after installing, updating or deleting a mod.

If the panel cannot confirm which loader or version your server runs, installing is disabled and the page explains why. Check your software on Versions and try again.

Manage installed mods​

Open the Installed tab.

  • Update available appears when a newer file exists. Click Update, then restart.
  • Delete removes the mod. Restart afterwards.
  • Config folder is a shortcut to the mod configuration files in Files.

Dependencies and duplicates​

Many mods need another mod to work (a library or API). The page helps you spot problems:

  • Another mod needs this one warns you before you delete a mod that something else depends on.
  • Possible duplicate warns you when two installed mods look like the same mod. Keep only one.

If the server crashes on start, the console usually names the missing or conflicting mod. Install the missing one, or remove the duplicate.

Players need the same mods​

Unlike plugins, mods run on both sides. Every player must install a matching loader and the same mods (with the same Minecraft version) on their own game to join. Some mods that only add server-side features do not need to be on the client, but if you are not sure, assume they do.

Tell your players exactly which loader, Minecraft version and mods you use.

Modpacks​

The Mods page installs mods one at a time. For a modpack, you have two options:

  • Install each mod of the pack individually from the page, if they are available on Modrinth.
  • Upload the mod files yourself. Open Files, go into the mods folder, click Upload, and choose the .jar files. You can also use SFTP; the connection details are in the SFTP box on the Files page.

Make sure the pack's Minecraft version and loader match what is shown on Versions. Restart the server after uploading.

tip

Modded servers use more memory. Watch the MEMORY card on the Console after adding large mods. If it stays close to full, consider fewer mods or a larger plan.

Common problems​

  • The server does not start after adding a mod. Look at the console for the mod name in the error. Delete that mod, or add the missing dependency.
  • Players cannot join: mod mismatch. Their mods or Minecraft version differ from the server. Match them exactly.
  • The mod needs a different loader. A Forge mod will not run on Fabric. Choose the right loader on Versions.
  • A change broke the server. Restore a backup from Backups.

FenixAI can read the console and explain mod errors in plain English.