How To Install Mods On Your Eco Server
Learn how to install mods on your Eco dedicated server by uploading them to the Mods folder via the XGamingServer panel.
Eco supports server-side mods that can add new content, change gameplay mechanics, add quality-of-life features, and more. Mods are installed by placing them in the server's Mods folder through the XGamingServer panel's file manager.
Installing a Mod
Download the mod
Find and download the mod you want to install. Popular sources for Eco mods include:
- Eco Modkit on GitHub — Official modding resources from Strange Loop Games
- mod.io/g/eco — Community mod repository
- Steam Workshop — Some mods are distributed through the Steam Workshop, though server-side mods typically need manual installation
Download the mod files to your computer. Mods are usually distributed as .zip or .dll files.
Open the XGamingServer panel
Log in to the XGamingServer Panel and select your Eco server. Stop the server before installing mods.
Navigate to the Mods folder
Click Files in the sidebar. Open the Mods folder. If no Mods folder exists, create one in the root server directory.
Upload the mod files
Click the Upload button and upload the mod files. If the mod came as a .zip file, upload the zip and then extract it — the mod's files should be placed directly inside the Mods folder (or in a subfolder if the mod's instructions specify one).
A typical mod structure looks like:
Mods/
├── MyMod/
│ ├── MyMod.dll
│ └── MyMod.eco (optional config)Restart the server
Start your server. Eco will automatically detect and load mods from the Mods folder on startup. Check the Console in the panel to verify the mod loaded successfully — look for messages mentioning the mod name during startup.
Configuring Mods
Many Eco mods include their own configuration files (usually .eco files) that get created in the Mods folder or the Configs folder after the first server start with the mod installed:
Install the mod and start the server once
Follow the steps above to install the mod and start the server. The mod will generate its default config file.
Stop the server
Stop the server to safely edit the config file.
Edit the mod config
Navigate to the mod's config file in Files (check both the Mods/<ModName>/ folder and the Configs folder). Edit the settings as needed.
Save and restart
Save the config file and restart the server.
💡 Tip: Always read the mod's documentation or readme file for specific installation instructions. Some mods have dependencies on other mods or require specific configuration steps beyond just uploading files.
Removing a Mod
Stop the server
Log in to the XGamingServer Panel and stop your Eco server.
Delete the mod files
Navigate to Files → Mods and delete the mod's folder or files.
Clean up config files
If the mod created configuration files in the Configs folder, you can optionally delete those as well to keep things tidy.
Restart the server
Start the server. The mod will no longer be loaded.
⚠️ Warning: Removing mods that add new items, blocks, or recipes may cause issues with existing worlds if players have already used those items. Consider resetting the server if you're removing major content mods.
Mod Compatibility
Keep these considerations in mind when running mods:
- Game version compatibility — Mods must be compatible with your server's Eco version. After a game update, check that your mods have been updated as well.
- Mod conflicts — Some mods may conflict with each other if they modify the same game systems. If your server crashes after installing a new mod, try removing it and adding mods back one at a time.
- Client-side vs. server-side — Server-side mods run on the server and apply to all players automatically. Some mods also require players to install a client-side component — check the mod's documentation.
- Performance impact — Mods that add complex simulations or many new items can increase server load. Monitor performance after installing new mods.
Troubleshooting Mod Issues
If a mod isn't working or your server won't start after installing mods:
- Check the Console — Look for error messages in the Console tab on the XGamingServer panel. Mod-related errors usually mention the mod name or file.
- Verify file placement — Make sure mod files are in the correct location inside the
Modsfolder. - Check compatibility — Verify the mod supports your server's Eco version.
- Remove and test — Remove the mod and see if the server starts normally, then re-add it to confirm it's the cause.
📝 Note: After installing or removing mods, it's a good idea to create a backup of your server before restarting, in case something goes wrong and you need to roll back.
If you get stuck at any time, you can join our Discord.
How is this guide?
