# How to Install a Modpack on Your Minecraft Server (/docs/minecraft/modpack-setup)



import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
import { Step, Steps } from 'fumadocs-ui/components/steps';

Modpacks bundle dozens or hundreds of mods together for a curated experience — Better Minecraft, RLCraft, All the Mods, FTB packs, ATM packs, etc. Most modpacks include a "server pack" you can drop into your server folder.

Install a CurseForge Modpack [#install-a-curseforge-modpack]

<Tabs items={['Official Server Pack (Easiest)', 'Manual Install']}>
  <Tab value="Official Server Pack (Easiest)">
    <Steps>
      <Step>
        Find the modpack on CurseForge [#find-the-modpack-on-curseforge]

        Browse to [CurseForge Modpacks](https://www.curseforge.com/minecraft/modpacks) and find the modpack you want.
      </Step>

      <Step>
        Download the server pack [#download-the-server-pack]

        On the modpack page, click the **Files** tab. Look for **"Server Files"** or a download labeled "Server Pack". This is different from the regular client pack.

        > Some modpacks don't have a separate server pack — in that case, follow the **Manual Install** tab.
      </Step>

      <Step>
        Stop your server [#stop-your-server]

        In the [XGamingServer Panel](https://panel.xgamingserver.com), go to **Console** and stop your server.
      </Step>

      <Step>
        Back up the existing world [#back-up-the-existing-world]

        Go to **Backups** and create a backup before wiping the existing server.
      </Step>

      <Step>
        Delete existing server files [#delete-existing-server-files]

        In **Files**, select all current files and delete them. (Or do a fresh **Reinstall Server** from the **Dashboard**.)
      </Step>

      <Step>
        Upload the server pack [#upload-the-server-pack]

        Upload the server pack `.zip` to the server root, then **Unarchive** it. The contents should include `mods/`, `config/`, a startup script, and the loader's `.jar` file.
      </Step>

      <Step>
        Set the Java version [#set-the-java-version]

        Most modern modpacks require **Java 17** or **Java 21**. In **Startup**, select the matching Java version. See [Java Version](/docs/minecraft/java-version).
      </Step>

      <Step>
        Start the server [#start-the-server]

        Start from **Console**. The first start can take several minutes as mods initialize and generate config files.
      </Step>
    </Steps>
  </Tab>

  <Tab value="Manual Install">
    <Steps>
      <Step>
        Identify the mod loader [#identify-the-mod-loader]

        Check whether the modpack uses **Forge**, **NeoForge**, or **Fabric** (usually in the modpack description).
      </Step>

      <Step>
        Switch to the correct server type [#switch-to-the-correct-server-type]

        In **Startup**, select the matching loader. Reinstall the server with that loader.
      </Step>

      <Step>
        Download the modpack files [#download-the-modpack-files]

        Download all the modpack's `.jar` files manually from CurseForge or Modrinth (or extract them from a client pack zip).
      </Step>

      <Step>
        Stop the server [#stop-the-server]
      </Step>

      <Step>
        Upload mods [#upload-mods]

        In **Files**, navigate to `mods/` and upload all the mod `.jar` files.
      </Step>

      <Step>
        Upload configs [#upload-configs]

        If the modpack has custom configs, upload them to `config/`.
      </Step>

      <Step>
        Set the Java version [#set-the-java-version-1]
      </Step>

      <Step>
        Start the server [#start-the-server-1]
      </Step>
    </Steps>
  </Tab>
</Tabs>

Players Need the Same Pack [#players-need-the-same-pack]

Every player connecting to a modded server **needs the same modpack installed locally**. The easiest way:

| Launcher           | Notes                                                         |
| ------------------ | ------------------------------------------------------------- |
| **CurseForge App** | Best for CurseForge packs — auto-installs the entire pack     |
| **ATLauncher**     | Cross-platform, supports CurseForge + ATLauncher packs        |
| **Prism Launcher** | Open-source launcher with great modpack support               |
| **MultiMC**        | Original modpack-friendly launcher (less actively maintained) |

Tell your players: "Install \[Modpack Name] from \[launcher]. Connect to `<your IP>`."

Update a Modpack [#update-a-modpack]

<Steps>
  <Step>
    Back up everything [#back-up-everything]

    Go to **Backups** and save your current state. Modpack updates can break worlds.
  </Step>

  <Step>
    Download the new server pack [#download-the-new-server-pack]

    Get the new version from CurseForge.
  </Step>

  <Step>
    Stop the server [#stop-the-server-1]
  </Step>

  <Step>
    Delete old mods [#delete-old-mods]

    In **Files**, delete the contents of `mods/` (but **keep your `world/` folder**).
  </Step>

  <Step>
    Upload new mods [#upload-new-mods]

    Upload the new pack's mods to `mods/`. Replace any updated configs as well.
  </Step>

  <Step>
    Start the server [#start-the-server-2]

    If something breaks, restore from your backup.
  </Step>
</Steps>

> **Warning:** Modpack updates that **remove mods** can corrupt your world if those mods added blocks/items players have placed/collected. Always back up before updating, and test in a separate world if possible.

Common Issues [#common-issues]

| Problem                       | Fix                                                                                                                         |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Server runs out of memory** | Modpacks are RAM-hungry. Increase RAM allocation in **Startup**. See [How Much RAM](/docs/minecraft/how-much-ram)           |
| **Wrong Java version**        | Modern modpacks need Java 17/21. Set in **Startup**                                                                         |
| **Crash on startup**          | Check **Console** for the failing mod. Remove or update it                                                                  |
| **Players can't connect**     | They don't have the same modpack installed. Send them the launcher link                                                     |
| **No server pack available**  | Use the manual install method, or try [downloading a client pack and removing client-only mods](https://www.curseforge.com) |

Related Guides [#related-guides]

* [Install Mods Manually](/docs/minecraft/mod-setup)
* [Java Version](/docs/minecraft/java-version)
* [How Much RAM](/docs/minecraft/how-much-ram)
* [Performance Optimization](/docs/minecraft/optimize-server)
* [Update Modpacks](/docs/minecraft/update-modpacks)