# How To Install Mods On Your Eco Server (/docs/eco/install-mods)



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

Eco supports server-side mods that add new content, change gameplay mechanics, and add quality-of-life features. Mods are installed by placing them in the server's **Mods** folder.

Where to Find Mods [#where-to-find-mods]

* **[mod.io/g/eco](https://mod.io/g/eco)** — community mod repository (largest source)
* **[Eco Modkit on GitHub](https://github.com/StrangeLoopGames)** — official modding resources from Strange Loop Games
* **Steam Workshop** — some mods are distributed through the Workshop, but server-side mods typically need manual installation

Mods are usually distributed as `.zip` or `.dll` files.

Mod Folder Structure [#mod-folder-structure]

<Files>
  <Folder name="(server root)" defaultOpen>
    <Folder name="Mods" defaultOpen>
      <Folder name="MyMod" defaultOpen>
        <File name="MyMod.dll" />

        <File name="MyMod.eco" />
      </Folder>
    </Folder>

    <Folder name="Configs" />
  </Folder>
</Files>

Install a Mod [#install-a-mod]

<Steps>
  <Step>
    Download the mod [#download-the-mod]

    Find a mod on mod.io or another source and download the files to your computer.
  </Step>

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

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

  <Step>
    Open the Mods folder [#open-the-mods-folder]

    Click **Files** in the sidebar. Open the **Mods** folder. If it doesn't exist, create one in the server root.

    {/* Screenshot needed: File Manager showing Mods folder */}
  </Step>

  <Step>
    Upload the mod files [#upload-the-mod-files]

    Click **Upload** and upload the mod files. If the mod is a `.zip`, upload it then **Unarchive** in the panel. The mod's files should sit directly inside `Mods/<ModName>/` (or a subfolder if the mod's instructions specify).
  </Step>

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

    Start from **Console**. Eco automatically detects and loads mods from the `Mods` folder on startup. Check **Console** to verify the mod loaded — look for messages mentioning the mod name during startup.
  </Step>
</Steps>

Configuring a Mod [#configuring-a-mod]

Many mods generate their own config files on first run.

<Steps>
  <Step>
    Run the server once with the mod [#run-the-server-once-with-the-mod]

    Start the server with the mod installed. The mod creates its default config file.
  </Step>

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

    Stop from **Console** to safely edit configs.
  </Step>

  <Step>
    Edit the mod config [#edit-the-mod-config]

    In **Files**, check both `Mods/<ModName>/` and the `Configs` folder for the mod's `.eco` config file. Open it and adjust settings.
  </Step>

  <Step>
    Save and restart [#save-and-restart]

    Click **Save Content** and start the server.
  </Step>
</Steps>

Removing a Mod [#removing-a-mod]

<Steps>
  <Step>
    Stop the server [#stop-the-server-2]

    Stop from **Console**.
  </Step>

  <Step>
    Delete the mod files [#delete-the-mod-files]

    In **Files**, navigate to **Mods** and delete the mod's folder.
  </Step>

  <Step>
    Optionally clean up configs [#optionally-clean-up-configs]

    If the mod created files in `Configs/`, you can delete those too.
  </Step>

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

    Start from **Console**.
  </Step>
</Steps>

> **Warning:** Removing mods that added new items, blocks, or recipes may cause issues with existing worlds if players already used those items. Consider [resetting the server](/docs/eco/reset-server) when removing major content mods.

Mod Compatibility [#mod-compatibility]

| Consideration                  | Why It Matters                                                                                                                   |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
| **Game version**               | Mods must match your server's Eco version. Update mods after game patches                                                        |
| **Mod conflicts**              | Some mods modify the same systems and can conflict. If a server crashes after adding a mod, remove it and add mods one at a time |
| **Client-side vs server-side** | Server-side mods apply automatically. Some require players to install a client component — check the mod docs                    |
| **Performance impact**         | Complex simulation mods can increase server load. Monitor performance after installing                                           |

Troubleshooting [#troubleshooting]

| Problem                             | Fix                                                                         |
| ----------------------------------- | --------------------------------------------------------------------------- |
| Server won't start after adding mod | Check **Console** for error messages — they usually mention the failing mod |
| Mod not loading                     | Verify the mod folder is directly inside `Mods/`, not nested deeper         |
| Mod compatibility error             | Check the mod page — it must support your Eco version                       |
| Multiple mods crashing              | Remove all mods, then re-add one at a time to find the conflict             |

> **Tip:** Always create a backup in **Backups** before installing or removing mods, in case something goes wrong.

Related Guides [#related-guides]

* [Configure Your Server](/docs/eco/configure-your-server)
* [Reset Your Server](/docs/eco/reset-server)