Install a Mod to a Server

Each mod is built to work on specific Minecraft Versions and Mod Loader, so when adding Mods to a server, make sure to check if the Mod is compatible with the game and server. You can check if the Mod is compatible with the game version and Mod Loader by checking the file information on Curseforge.

The following information is required before uploading a mod to a server:

  • Game Version - Can be found in the project description or mod version.
  • Mod Loader - Can be found on the project description. Examples of a Mod Loader include Minecraft Forge, Fabric, or NeoForge.
  • Loader Version - If the game can launch, use the version installed on the client. Mods that detect an outdated Mod Loader will show in the error which version is required.
  • Dependency Version (Optional) - Some Mods may require another mod in order to load. Make sure to also have this noted down for Modpacks.
🚧

Before uploading to a server, check that the game is runnable

Most mods are able to run if the game and Mod Loader versions are correct. However, there are some cases where a mod may simply not load even if the requirements are met. Possible causes can include compatibility issues with other mods, a buggy mod, or the mod is incompatible with the specific Mod Loader version.

Make sure to run the game in Single Player first before uploading the files onto a server to check if the Mods can run. If the game is unable to launch, the Mod should not be uploaded.

Add a Mod to a new Server

To install Mods to a server, the server will need a Mod Loader installed first. Without a Mod Loader, Mods cannot be installed.

Install a Mod Loader to a Server

If you have not got a server yet, the first thing to do will be to install the Mod Loader. You will need the Mod Loader and Loader Version from the start of the guide to create a server.

  1. Login to the Server Dashboard.
  2. Select Minecraft for the game, then search for Advanced Installations to pick a Mod Loader.
  3. Select the required Mod Loader, then select the Loader Version under Version.
  4. Fill in the rest of the server details and click Create Server.
📘

Unable to find the Mod Loader or Version?

If you are unable to find the specific version required for the Mod Loader, contact support and our friendly support team can help!

For Mod Loaders unavailable in the server installer, check out this guide on manually installing a Mod Loader. Be warned that this should only be used as a last resort if the server installer options are not available.

Upload the Mod files

Once you have a server ready, the Mod files can be uploaded to the server.

  1. Login via SFTP.
  2. Open the server folder and open the mods folder.
  3. Copy the mod JAR files directly into the mods folder. Uploading the mods as a ZIP or inside other folders will not work.
  4. Start the server. Check the console for any errors or if the server can start.

Add a Mod to an existing Modpack

If there are any additions to a modpack, those can also be installed to a server. Be aware that making changes to a modpack can cause unintended issues such as bugs, crashes, or unusual mod interactions. As such, adding an extra mod to a server should be done with precautions. If you have an existing server, make sure to create a backup before installing extra mods.

Install a Modpack to a server

If you have not set up a server with a modpack yet, make sure to create a server first.

  1. Login to the Server Dashboard.
  2. Click on the Add Server button to create a new server.
  3. Click on Minecraft or click on the Minecraft server option, then click on a modpack of your choice.

Upload the Mod files

Once the server has finished installing, you can install mods to the server.

  1. Login via SFTP.
  2. Open the server folder and open the mods folder.
  3. Copy the mod JAR files directly into the mods folder. Uploading the mods as a ZIP or inside other folders will not work. For modpack servers, make sure to check there are no duplicate mods uploaded.
  4. Start the server. Check the console for any errors or if the server can start.

Did this page help you?