1. Guides
  2. Game
  3. Minecraft
  4. How to Install Modpacks on Your Minecraft Java Edition Server
4 min read

How to Install Modpacks on Your Minecraft Java Edition Server

This is what you do if you need to install a modpack to 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.

Installing Modpacks

  1. 1
    Log in to Bropanel and select your Minecraft server.
  2. 2
    In the sidebar, go to Modpacks.
  3. 3
    Find the modpack you want and click Install.
  4. 4
    Pick a version, then confirm. This overwrites all current server files, so download a backup first if you want to keep them.

Updating an Existing Modpack

If you already have a modpack installed and want to update it to a newer version, follow these steps for a clean update.

  1. 1
    Log in to Bropanel and Stop your server.
  2. 2
    Download a backup from your server, manually or with our backup feature.
  3. 3
    In the sidebar, go to Files and delete the following folders for a clean installation:
    • libraries
    • mods
    • scripts
    • kubejs
    • config
  4. 4
    Install the updated modpack using the steps above, WITHOUT enabling format.
  5. 5
    Start your server.

Tip

Not all modpack updates require the deletion of all these folders, at minimum delete libraries and mods prior to updating. The key is to remove old mod and library files to prevent conflicts with the updated version.

Manually Installing Modpacks to Your Server

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. 1
    Log in to Bropanel and select your Minecraft server.
  2. 2
    On the Overview page, click Change Version and pick the compatible server type for your modpack.
  3. 3
    Select Delete and reinstall for a fresh installation.
  4. 4
    Choose the version you need to install. Once completed, Stop your server.
  5. 5
    Upload the Modpack.zip to your server's home directory.
  6. 6
    Once uploaded, in Files, click the three dots to Extract your Modpack.zip.
    • 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.
    • For most Forge versions and modpacks, after uploading and extracting, your server should now look something like this:
    Files
    server.jar
    libraries
    mods
    configs
    ..
  7. 7
    Restart your server.

Troubleshooting

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

Immediate Crashing

This may be because the server is using an incompatible java version. Try these steps to troubleshoot it:

  • Double-check that the server .jar file is set correctly in Settings.
  • In Settings, change the Java version and restart your server. You may need to try this a couple of times. Automatic works for 99% of cases.
  • 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. This will be something you will have to look out for. The easiest way to solve this is by doing the following:

  • 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.

As a tip, mod loaders such as Forge and NeoForge are different. While they may have similar names, they are NOT cross-compatible.

Generating World Crashing

Larger modpacks WILL require more resources. If your server is crashing when trying to generate the world, here's how to check if you have enough resources to run the modpack:

  • Check your Console by scrolling down to Recent Activity and clicking View audit logs, or watch your resources to check. 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, try the following:

  • 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, please contact a bro on Discord.

Mismatched Mods

Mods in modpacks will also need to be installed locally to your game client. When trying to connect to your server, if you have any problems such as mismatched mods, try these steps:

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

These are the most common troubleshooting methods. If you're still unable to get connected or if you get stuck at any time, you can reach out to a bro on Discord.