# How To Install Mods on Your Starbound Server (/docs/starbound/install-mods)



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

Starbound supports mods through the Steam Workshop and manual installation. Mods can add new races, items, planets, quests, and more to your server.

> 📝 **Note:** All players connecting to a modded server typically need the same mods installed on their client. Make sure to share your mod list with players.

Installing Steam Workshop Mods [#installing-steam-workshop-mods]

<div className="fd-steps">
  <div className="fd-step">
    Find Mods to Install [#1-find-mods-to-install]

    Browse the [Starbound Steam Workshop](https://steamcommunity.com/app/211820/workshop/) and note the mod IDs or download the mod files.
  </div>

  <div className="fd-step">
    Open the XGamingServer Panel [#2-open-the-xgamingserver-panel]

    Log in to the [XGamingServer Panel](https://panel.xgamingserver.com).
  </div>

  <div className="fd-step">
    Stop Your Server [#3-stop-your-server]

    Make sure your server is **stopped** before installing mods.
  </div>

  <div className="fd-step">
    Open Files [#4-open-files]

    In the sidebar, click **Files**.
  </div>

  <div className="fd-step">
    Navigate to the Mods Directory [#5-navigate-to-the-mods-directory]

    Navigate to the `mods/` directory in your server root. If it does not exist, create it.
  </div>

  <div className="fd-step">
    Upload the Mod Files [#6-upload-the-mod-files]

    Download the mod files (`.pak` files) and upload them to the `mods/` directory. Click **Upload** and select the mod files from your computer.
  </div>

  <div className="fd-step">
    Start Your Server [#7-start-your-server]

    Click **Start** to launch your server with the mods loaded.
  </div>

  <div className="fd-step">
    Verify the Mods [#8-verify-the-mods]

    Check the **Console** in the panel to make sure the mods loaded without errors.
  </div>
</div>

Manual Mod Installation [#manual-mod-installation]

For mods not available on the Steam Workshop:

<div className="fd-steps">
  <div className="fd-step">
    Download the Mod [#1-download-the-mod]

    Download the mod from its source (typically a `.pak` file or a folder containing mod assets).
  </div>

  <div className="fd-step">
    Upload to the Mods Directory [#2-upload-to-the-mods-directory]

    Upload the mod files to the `mods/` directory on your server.
  </div>

  <div className="fd-step">
    Start Your Server [#3-start-your-server]

    Start the server and check the console for any errors.
  </div>
</div>

Removing Mods [#removing-mods]

To remove a mod, delete its `.pak` file or folder from the `mods/` directory and restart your server.

> ⚠️ **Warning:** Removing mods from an existing world may cause issues if the world contains modded content. Consider starting a fresh world after removing mods.

> 💡 **Tip:** If you want to enforce that all players have the same mods, set `allowAssetsMismatch` to `false` in your [server configuration](/docs/starbound/configure-your-server). This will prevent players with different mods from connecting.