Modding

A checked version of this page, approved on 19 March 2022, was based on this revision.

Modding is how the base game is extended with new features such as blocks, animals and additional game play rules. Some mods only change server-side functionality, while others may add additional visualizations and interactions on the client side. Mods may be developed by Strange Loop Games or independent developers and added to the game by server admins. There is no charge for access to the API and all of the tooling for mod development is freely available.

Installing Mods

Most mods can be installed by placing the mod's files into the Mods folder of an Eco server. Mods may add new files or replace some of the files already found in the Mods folder. Many mod authors will have instructions for installing their mod(s).

Mods that affect the client, such as custom items and models, only need to be installed on the server. The client will automatically receive the information it needs to run the mod from the server.

Server owners can now use Mod.io and modders should consider putting mods there.

Here is a simple video on how to install mods to your eco server:

How To Install A Mod Onto An Eco Server

Existing Mods

NOTE: It is against Eco Wiki rules to post advertisements for specific mods anywhere on the Wiki.

For now, most mods are hosted on third-party websites. The best places to find mods currently are:

Mod.io — Official host for Eco mods, with API available for mod management. This is the recommended place to download mods, especially if you are new to modding.
Eco Forums filebase — Many more mods than Mod.io, but has no API.
Eco Modding Forums — The modding section of the official forums.
Template:Eco Discord — The offical Discord server has several modding channels.

Mod Development

See Mod Development

Localization

Crowdin localization testing

Go to Crowdin Site.
Download latest archive archive.
Go to Eco Server directory.
Create folder if not exists `Mods\Translations`.
Extract `defaultstrings.csv` into the `Mods\Translations` directory.
You need to restart the server to use changed files.

Also you can open the CSV file and edit in in any text editor to test your translations without Crowdin.

Mods Translation

From previous article [Crowdin localization testing] you can get `.csv` file for reference. You should follow same format, but you can use any file name and put into under your mod directory into `Translations` directory. I.e. `Mods\MySuperMod\Translations\MySuperModStrings.csv`.