Minecraft logo

How To Install Modpacks On Your Minecraft Java Edition Server

Learn how to install and update modpacks on your Minecraft server from the panel or manually.

By the GhostCap teamUpdated

In this guide, we will show you how to install a modpack on your Minecraft server. We recommend installing modpacks to a fresh Minecraft server to avoid possible conflicts.

To connect to modded servers, we recommend using the CurseForge App to install modpacks to your local Minecraft client.

Tip

Larger packs may need more RAM allocated to your game client. You can adjust this in the CurseForge launcher settings.

Installing Modpacks

  1. Log in to the GhostCap Panel and select your Minecraft server.
  2. Open Modpacks.
  3. Search for the modpack you want.
  4. Click Install to install the latest version, or click the arrow next to Install to pick a version.
  5. Read the warning and click Install to confirm.

Your server starts by itself once the modpack is installed. You can follow the progress in Console.

Danger

Installing a modpack deletes every file on your server, including your world. If you wish to keep a copy of the current world, make sure to create a backup first! This installer does NOT create a backup of your world.

Updating an Existing Modpack

If you already have a modpack installed and want to update it to a newer version, or move back to an older one, the panel can switch versions for you.

  1. Log in to the GhostCap Panel and select your Minecraft server.
  2. Create a backup of your server in case you want to go back.
  3. Open Modpacks.
  4. Under Installed modpack, click Update to latest. To pick a different version, choose it from the Change version list and click Switch version.
  5. Read the warning and click Change version to confirm.

Updating replaces the modpack's folders, such as mods, config, libraries, kubejs, and scripts, with the new version, including any mods you added and any config edits you made. Your world, server.properties, and backups are kept.

Manually Installing Modpacks

We recommend using CurseForge to find and install modpacks to your server and game client. Modpacks on CurseForge normally have a separate download for servers. This guide is suitable for most cases.

  1. Log in to the GhostCap Panel and select your Minecraft server.
  2. Click the version chip at the top of your server's page (it shows your current version, or Set version).
  3. Pick the mod loader your modpack uses, such as Forge or Fabric, and choose Delete and reinstall.
  4. Pick the Minecraft version your modpack needs and click Install.
  5. Use SFTP to upload the Modpack.zip to your server's home directory.
  6. Once uploaded, open Files, open the menu on Modpack.zip, and click Extract.
  7. Start your server.
Tip

Uploading a .zip is preferred as it's faster, but you can also upload everything uncompressed if you're having trouble. Normally, you'll only need the mods and configs folders uploaded.

Troubleshooting

Here are the most common issues you may run into when installing mods to your Minecraft server. We recommend following these in order.

Immediate Crashing

This may be because the server is using an incompatible Java version. Try these steps:

  • Double-check that Server Jar File is set correctly in Settings.
  • Change the Java version in the docker_overwrite file and restart your server. See how to change your Java version.
  • Make sure the upload was successful. Files larger than 1GB need to be uploaded using SFTP.

Version Compatibility

Some modpacks won't have a premade server download and will need additional configuration. The easiest way to solve this is:

  • Check the modpack's compatible mod loader and version on its download page.
  • Make sure your Minecraft server has the correct game version installed if the modpack didn't include a .jar file.
  • Mod loaders such as Forge and NeoForge are different. While they may have similar names, they are NOT cross-compatible.

World Generation Crashing

Larger modpacks WILL require more resources. If your server is crashing when trying to generate the world:

  • At the bottom of your server's page, under Advanced, click Activity and choose Crashes, or watch your resources. If this is the issue, you will need to upgrade your server.

Connection Refused

If you've just manually installed a modpack and can't connect to your server, and your error message is just "connection refused" with no information:

  • Restart your server.
  • Make sure you've installed the modpack to your own game client.
  • Ensure you're connecting with the correct IP address.
  • If you're still unable to connect, reach out to us on Discord.

Mismatched Mods

Mods in modpacks will also need to be installed locally to your game client. If you have problems such as mismatched mods when trying to connect:

  • Download the missing mods.
  • Delete them from your game and server files then try again.