ATTENTION! The process of updating WiKi to version Eco 10.x has begun. Those wishing to participate can find out more Information on our ECO Contribution Wiki Discord.

Modding: Difference between revisions

From Eco - English Wiki
[unchecked revision][checked revision]
(→‎Existing Mods: Fixed link to Eco forums to point directly to the modding section. Added links to the Eco Discord server, and the Eco forum filebase.)
(8 intermediate revisions by 5 users not shown)
Line 17: Line 17:


* [https://eco.mod.io/ 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.
* [https://eco.mod.io/ 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.
* [http://ecoforum.strangeloopgames.com/category/20/modding Modding | Eco Forums] — Official forums modding section
* [https://forum.play.eco/filebase/ Eco Forums filebase] — Many more mods than Mod.io, but has no API and is not searchable.
* [https://eco-mods.com/ Eco-mods.com] — Unofficial mod hosting site
* [https://forum.play.eco/board/10-modding/ Eco Modding Forums] — The modding section of the official forums.
* [https://discord.com/invite/eco Eco Discord server] — The offical Discord server has several modding channels.


== Mod Development ==
== Mod Development ==
'''NOTE:''' The modding system is under ''heavy development''. APIs are expected to change, which may break existing mods!


For those wanting to learn about how to develop mods, the [https://github.com/StrangeLoopGames/EcoModKit/wiki Eco ModKit wiki] is a great place to start.
See [[Mod Development]]


It contains a link to download the modkit, as well as tutorials on how to make different types of mods. Read through each tutorial to learn how to use the Eco ModKit.
== Localization ==
 
=== Tools ===
 
[[Strange Loop Games]] recommends using the latest versions of Visual Studio and Unity.
 
* [https://www.visualstudio.com/downloads/ Visual Studio 2017]
* [https://store.unity.com/ Unity]


=== Crowdin localization testing ===
=== Crowdin localization testing ===
Line 49: Line 42:
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`.
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`.


=== Resources ===
[[Category: Modding]]
 
* [https://github.com/StrangeLoopGames/EcoModKit Eco Modkit] (check Wiki tab for documentation)
* [https://github.com/StrangeLoopGames/EcoModKit/wiki/Tutorial-Ceiling-Fan-Light Tutorial: Ceiling Fan Light]
* [https://github.com/StrangeLoopGames/EcoModKit/wiki/ Eco Modding Wiki](Wiki for Modding Tutorials)
 
For more discussion about modding with Eco, visit the #modding channel in the [https://www.discord.gg/eco Eco Discord] server.
 
[[ja:Modding]]

Revision as of 21:48, 4 October 2020

Modding a Torch in Unity

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.

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 and is not searchable.
  • Eco Modding Forums — The modding section of the official forums.
  • Eco Discord server — The offical Discord server has several modding channels.

Mod Development

See Mod Development

Localization

Crowdin localization testing

  1. Go to Crowdin Site.
  2. Download latest archive archive.
  3. Go to Eco Server directory.
  4. Create folder if not exists `Mods\Translations`.
  5. Extract `defaultstrings.csv` into the `Mods\Translations` directory.
  6. 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`.