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]
mNo edit summary
 
m (→‎Existing Mods: Use Eco Discord template.)
(18 intermediate revisions by 7 users not shown)
Line 1: Line 1:
[[File:mods.jpg|Modding a [[Torch]] in Unity|thumb|600px]]
[[File:mods.jpg|Modding a [[Torch]] in Unity|thumb|600px]]
 
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.
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 ==
== 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).
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).


Line 11: Line 8:
Server owners can now use [http://Mod.io Mod.io] and modders should consider putting mods there.
Server owners can now use [http://Mod.io Mod.io] and modders should consider putting mods there.


Here is a simple video on how to install mods to your eco server:
<youtube dimensions="400x240" description="How To Install A Mod Onto An Eco Server" container="frame">7pTrGbWl20E</youtube>
== Existing Mods ==
== Existing Mods ==
'''NOTE:''' It is against Eco Wiki rules to post advertisements for specific mods ''anywhere'' on the Wiki.
'''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:
For now, most mods are hosted on third-party websites. The best places to find mods currently are:
* [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.
* [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.
* {{Eco Discord}} 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!
See [[Mod Development]]
 
== Localization ==
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.
=== Crowdin localization testing ===
 
# Go to [https://crowdin.com/project/eco-by-strange-loop-games Crowdin Site].
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.
# Download latest archive [https://crowdin.com/backend/download/project/eco-by-strange-loop-games.zip archive].
 
# Go to Eco Server directory.
=== Tools ===
# Create folder if not exists `Mods\Translations`.
 
# Extract `defaultstrings.csv` into the `Mods\Translations` directory.
[[Strange Loop Games]] recommends using the latest versions of Visual Studio and Unity.
# 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.
* [https://www.visualstudio.com/downloads/ Visual Studio 2017]
=== Mods Translation ===
* [https://store.unity.com/ Unity]
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`.
 
[[Category: Modding]]
=== Resources ===
 
* [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 19:19, 4 March 2022

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.


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.
  • 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`.