How To Install Mods On Your Eco Server
Install Eco server mods by uploading them to the Mods folder via the XGamingServer panel, with config, troubleshooting, and removal steps.
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
- mod.io/g/eco — community mod repository (largest source)
- Eco Modkit on GitHub — 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
Install a Mod
Download the mod
Find a mod on mod.io or another source and download the files to your computer.
Stop the server
In the XGamingServer Panel, go to Console and stop your server.
Open the Mods folder
Click Files in the sidebar. Open the Mods folder. If it doesn't exist, create one in the server root.
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).
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.
Configuring a Mod
Many mods generate their own config files on first run.
Run the server once with the mod
Start the server with the mod installed. The mod creates its default config file.
Stop the server
Stop from Console to safely edit configs.
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.
Save and restart
Click Save Content and start the server.
Removing a Mod
Stop the server
Stop from Console.
Delete the mod files
In Files, navigate to Mods and delete the mod's folder.
Optionally clean up configs
If the mod created files in Configs/, you can delete those too.
Start the server
Start from Console.
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 when removing major content mods.
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
| 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
How is this guide?
How to Set Up DiscordLink on Your Eco Server
Install and configure the DiscordLink plugin for your Eco dedicated server — chat bridge, election notifications, and Discord bot commands.
How To Set Max Players On Your Eco Server
Adjust the maximum player count on your Eco dedicated server using MaxConnections in Network.eco, with recommended counts by world size.