Editing Server Configuration
From Eco - English Wiki
Your changes will be displayed to readers once an authorized user accepts them. (help)
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 1: | Line 1: | ||
[[Server Configuration]] can be done either through the server GUI or by directly editing configuration files. The latter option is only recommended for advanced users. Many aspects of the world, items, and player settings can be changed in this way. | [[Server Configuration]] can be done either through the server GUI or by directly editing configuration files. The latter option is only recommended for advanced users. Many aspects of the world, items, and player settings can be changed in this way. | ||
''This configuration guide is based on player tests and crowd-sourcing. No information in this guide has been confirmed by | ''This configuration guide is based on player tests and crowd-sourcing. No information in this guide has been confirmed by [[SLG]].'' | ||
== Basic server configuration == | == Basic server configuration == | ||
[[File:ServerConfig_Example.jpg|300px|thumb|Setting a server's public status to "True" and adding a server description, both done in the Config tab of the Network plugin.]] | [[File:ServerConfig_Example.jpg|300px|thumb|Setting a server's public status to "True" and adding a server description, both done in the Config tab of the Network plugin.]] | ||
Line 19: | Line 19: | ||
** <code>"Playtime": "110000011111111122222222 110000011111111122222222 110000011111111122222222 110000011111111122222222 111110011111111122222222 221110012222222222222222 221110012222222222222222",</code> | ** <code>"Playtime": "110000011111111122222222 110000011111111122222222 110000011111111122222222 110000011111111122222222 111110011111111122222222 221110012222222222222222 221110012222222222222222",</code> | ||
** 1=Sometimes, 2= Regular, 0=Rarely. | ** 1=Sometimes, 2= Regular, 0=Rarely. | ||
** | ** Each line here represents a day. Remove all spaces and linebreaks when adding it to the config. If it contains and spaces or linebreaks it will crash the server on startup. | ||
===== Set server Discord ===== | ===== Set server Discord ===== | ||
* Discord Address — Adding the unique ID of a Discord server (after the “discord.gg/”) will provide a link to the Discord server from the tutorial. | * Discord Address — Adding the unique ID of a Discord server (after the “discord.gg/”) will provide a link to the Discord server from the tutorial. | ||
Line 46: | Line 46: | ||
* Specialty Cost Multiplier — Adjusts the required amount of XP required to reach the next star using a multiplier based on the following baseline values 0, 20, 50, 100, 200, 400, 800, 1600 after the 8th each stars baseline is 1600). | * Specialty Cost Multiplier — Adjusts the required amount of XP required to reach the next star using a multiplier based on the following baseline values 0, 20, 50, 100, 200, 400, 800, 1600 after the 8th each stars baseline is 1600). | ||
* Skill Gain Multiplier — Adjusts the rate of skill points gained over time from food and housing. | * Skill Gain Multiplier — Adjusts the rate of skill points gained over time from food and housing. | ||
* Specialty Experience Divisor — Reduces experience rate based on number of specialties learned. Has no effect as of | * Specialty Experience Divisor — Reduces experience rate based on number of specialties learned. Has no effect as of Beta 8.0.1. | ||
* Specialty Experience PerLevel — Experience required to level up each specialty tier. | * Specialty Experience PerLevel — Experience required to level up each specialty tier. | ||
* Craft Resource Multiplier — Adjusts the amount of materials required to craft a recipe. | * Craft Resource Multiplier — Adjusts the amount of materials required to craft a recipe. | ||
* Craft Time Multiplier — Adjusts the amount of time that a recipe takes to craft. | * Craft Time Multiplier — Adjusts the amount of time that a recipe takes to craft. | ||
* Player Experience per Specialty — Gives player XP for improving at your chosen field. ''Note: This is not recommended for public servers because it essentially means that those in front will generally get further in front.'' | * Player Experience per Specialty — Gives player XP for improving at your chosen field. ''Note: This is not recommended for public servers because it essentially means that those in front will generally get further in front.'' | ||
* Unlearn Refund Rate — Obsolete as of | * Unlearn Refund Rate — Obsolete as of Beta 8.0. Has no effect. | ||
* End Game Craft Cost — Includes two options, "Normal and "Expensive" which will alter the crafting costs for the [[Laser]] and [[Computer Lab]]. Does not affect work orders in process. | * End Game Craft Cost — Includes two options, "Normal and "Expensive" which will alter the crafting costs for the [[Laser]] and [[Computer Lab]]. Does not affect work orders in process. | ||
==== Meteor Settings ==== | ==== Meteor Settings ==== | ||
Line 61: | Line 61: | ||
* Require Authentication — True/False. Validates users with Eco servers. Set to True by default. False has unknown effects and is not recommended. | * Require Authentication — True/False. Validates users with Eco servers. Set to True by default. False has unknown effects and is not recommended. | ||
* Allow Debug Calls — True/False. Allows debug calls to be made to the webserver. Unknown effect. | * Allow Debug Calls — True/False. Allows debug calls to be made to the webserver. Unknown effect. | ||
* White List — Whitelist selected players. Enter each individual player ID. Press | * White List — Whitelist selected players. Enter each individual player ID. Press Enter/Return between each ID. | ||
* Black List — Blacklist selected players. Enter each individual player ID. Press | * Black List — Blacklist selected players. Enter each individual player ID. Press Enter/Return between each ID. | ||
* Admins — Give selected players ''full'' admin rights. Enter each individual player ID. Press | * Admins — Give selected players ''full'' admin rights. Enter each individual player ID. Press Enter/Return between each ID. Having an admin online helps the server show up more prominently in the server browser. | ||
''Note:'' Whitelist, Blacklist, and Admins all use player IDs. Use the <code>/whois</code> [[command]] to see their ID. You will need to enter the proper ID when editing these lists manually. | ''Note:'' Whitelist, Blacklist, and Admins all use player IDs. Use the <code>/whois</code> [[command]] to see their ID. You will need to enter the proper ID when editing these lists manually. | ||
Use the | Use the SLG ID unless the user is a Steam-only user. | ||
{|class="wikitable" | {|class="wikitable" | ||
| | | SLG only account || use SLG ID | ||
|- | |- | ||
| Steam only account || use STEAMID64 | | Steam only account || use STEAMID64 | ||
|- | |- | ||
| | | SLG + Steam linked account || use SLG ID | ||
|} | |} | ||
You are able to use the player's name when running the corresponding commands from inside the game. | You are able to use the player's name when running the corresponding commands from inside the game. | ||
Line 92: | Line 92: | ||
===== Change World Size ===== | ===== Change World Size ===== | ||
* Dimensions — Changes the size of the world. The X and Y values ''must'' be the same and divisible by 4. However, not all worlds with dimensions that follow these rules will be stable. | * Dimensions — Changes the size of the world. The X and Y values ''must'' be the same and divisible by 4. However, not all worlds with dimensions that follow these rules will be stable. | ||
NOTE: The server (EcoServer32.exe) that is bundled with the Eco game client can only run worlds up to 100x100. To run larger worlds, the server must be downloaded separately, through Steam or the | NOTE: The server (EcoServer32.exe) that is bundled with the Eco game client can only run worlds up to 100x100. To run larger worlds, the server must be downloaded separately, through Steam or the SLG website. | ||
Below are the current recommendations for world sizes. Worlds built outside these recommendations may experience playability, performance, and stability issues that are outside the capabilities of | Below are the current recommendations for world sizes. Worlds built outside these recommendations may experience playability, performance, and stability issues that are outside the capabilities of SLG support staff: | ||
* (72,72) — | * (72,72) — 0.52km<sup>2</sup> — This is the default size for when first launching the Eco server. | ||
* (100,100) — | * (100,100) — 1km<sup>2</sup> — Maximum size for EcoServer32.exe and the recommended size for small public servers. | ||
* (140,140) — | * (140,140) — 1.96km<sup>2</sup> — Recommended size for medium to large public servers. | ||
*(160,160) — | *(160,160) — 2.56km<sup>2</sup> — The biggest size supported by Strange Loop Games, recommended for the biggest public servers out there. (Used by White-Tiger) | ||
The following world sizes are known to be stable on servers with an above average performance, but are not recommended to be used, given they will not allow any meaningful impact on Ecology. Strange Loop Games does not guarantee to provide support for worlds of this size. | The following world sizes are known to be stable on servers with an above average performance, but are not recommended to be used, given they will not allow any meaningful impact on Ecology. Strange Loop Games does not guarantee to provide support for worlds of this size. | ||
* (172,172) — | * (172,172) — 2.96km<sup>2</sup> | ||
* (200,200) — | * (200,200) — 4km<sup>2</sup> | ||
The following world sizes can be stable on servers and for clients that are both having strong to extremely strong performance, but are not recommended to be used, given they will not allow any meaningful impact on Ecology and are not suitable for the vast majority of use cases. Strange Loop Games does not provide support for worlds of these sizes and does not guarantee to take bug reports that involve worlds of these sizes. | The following world sizes can be stable on servers and for clients that are both having strong to extremely strong performance, but are not recommended to be used, given they will not allow any meaningful impact on Ecology and are not suitable for the vast majority of use cases. Strange Loop Games does not provide support for worlds of these sizes and does not guarantee to take bug reports that involve worlds of these sizes. | ||
* (224,224) — | *(224,224) — 5.02km<sup>2</sup> | ||
* (240,240) — | * (240,240) — 5.76km<sup>2</sup> | ||
* (248,248) — | * (248,248) — 6.15km<sup>2</sup> | ||
* (272,272) — | * (272,272) — 7.4km<sup>2</sup> | ||
* (296,296) — | * (296,296) — 8.76km<sup>2</sup> | ||
* (300,300) — | * (300,300) — 9km<sup>2</sup> | ||
* (360,360) — | * (360,360) — 12.6km<sup>2</sup> | ||
* (400,400) — | * (400,400) — 16km<sup>2</sup> | ||
Worlds over 400x400 may be possible to generate without the server crashing, but are extremely likely to be unstable, even with the most performant hardware available on clients and the server. Strange Loop Games does generally not provide any support nor take bug reports for worlds with such sizes. | |||
Worlds over 400x400 may be possible to generate without the server crashing, but are extremely likely to be unstable, even with the most performant hardware available on clients and the server. Strange Loop Games does generally not provide any support nor take bug reports for worlds with such sizes. | Worlds over 400x400 may be possible to generate without the server crashing, but are extremely likely to be unstable, even with the most performant hardware available on clients and the server. Strange Loop Games does generally not provide any support nor take bug reports for worlds with such sizes. | ||
===== Change World Shape ===== | ===== Change World Shape ===== | ||
* WaterLevel — Sea level height. | * WaterLevel — Sea level height. | ||
Line 144: | Line 141: | ||
''Note: This configuration guide is based on player tests and crowd-sourcing. No information in this guide has been confirmed by | ''Note: This configuration guide is based on player tests and crowd-sourcing. No information in this guide has been confirmed by [[SLG]].'' | ||
=== List of configuration files === | === List of configuration files === | ||
The standard configuration files are located in ''Eco\Eco_Data\Server\configs'' | The standard configuration files are located in ''Eco\Eco_Data\Server\configs'' | ||
Line 152: | Line 149: | ||
Controls whether to keep backup save files, and how often to create them. | Controls whether to keep backup save files, and how often to create them. | ||
==== Difficulty.eco ==== | ==== Difficulty.eco ==== | ||
Many of these settings were made obsolete with version 0.8, but may remain in the config files. See also [[Server Configuration#EcoSim.eco]] for the base skill gain rate. | |||
{| class="wikitable sortable mw-collapsible" | {| class="wikitable sortable mw-collapsible" | ||
|+ | |+ | ||
Line 171: | Line 169: | ||
|<code>1.0</code> | |<code>1.0</code> | ||
| | | | ||
| | |Lower = faster star progression. | ||
|- | |- | ||
|<code>SkillGainMultiplier</code> | |<code>SkillGainMultiplier</code> | ||
|<code>1.0</code> | |<code>1.0</code> | ||
| | | | ||
| | |Higher = quicker XP. | ||
|- | |- | ||
|<code>SpecialtyExperiencePerLevel</code> | |<code>SpecialtyExperiencePerLevel</code> | ||
|<code>25.0</code> | |<code>25.0</code> | ||
| | | | ||
| | |Higher = longer. | ||
|- | |- | ||
|<code>CraftResourceModifier</code> | |<code>CraftResourceModifier</code> | ||
|<code>1.0</code> | |<code>1.0</code> | ||
| | | | ||
| | |Modifies how many resources players need for crafting | ||
|- | |- | ||
|<code>CraftTimeMultiplier</code> | |<code>CraftTimeMultiplier</code> | ||
|<code>1.0</code> | |<code>1.0</code> | ||
| | | | ||
| | |Modifies the crafting time | ||
|- | |- | ||
|<code>PlayerExperiencePerSpecialtyExperience</code> | |<code>PlayerExperiencePerSpecialtyExperience</code> | ||
|<code>0.0</code> | |<code>0.0</code> | ||
| | | | ||
| | | | ||
|- | |- | ||
|<code>EndgameCraftCost</code> | |<code>EndgameCraftCost</code> | ||
Line 251: | Line 201: | ||
* <code>Normal</code> | * <code>Normal</code> | ||
* <code>Expensive</code> | * <code>Expensive</code> | ||
| | | | ||
|} | |} | ||
The following presets are available by default | The following presets are available by default: | ||
{| class="wikitable mw-collapsible mw-collapsed" | {| class="wikitable mw-collapsible mw-collapsed" | ||
! No Collaboration ( | ! No Collaboration (0-3 players) | ||
|- | |- | ||
| Specialty Cost Multiplier || 0.1 | | Specialty Cost Multiplier || 0.1 | ||
|- | |- | ||
| Skill Gain Multiplier || 5 | | Skill Gain Multiplier || 5 | ||
|- | |||
| Specialty Experience Divisor || 20 | |||
|- | |||
| Specialty Experience Per Level || 25 | |||
|- | |||
| Unlearn Refund Rate || 0.5 | |||
|- | |- | ||
| Craft Resource Modifier || 0.5 | | Craft Resource Modifier || 0.5 | ||
Line 291: | Line 221: | ||
| Craft Time Multiplier || 0.5 | | Craft Time Multiplier || 0.5 | ||
|- | |- | ||
| | | Player Experience Per Specialty || 0 | ||
| | |||
|- | |- | ||
| | | End Game Craft Cost || Normal | ||
|- | |- | ||
|} | |} | ||
{| class="wikitable mw-collapsible mw-collapsed" | {| class="wikitable mw-collapsible mw-collapsed" | ||
Line 305: | Line 232: | ||
|- | |- | ||
| Skill Gain Multiplier || 2 | | Skill Gain Multiplier || 2 | ||
|- | |||
| Specialty Experience Divisor || 20 | |||
|- | |||
| Specialty Experience Per Level || 25 | |||
|- | |||
| Unlearn Refund Rate || 0.5 | |||
|- | |- | ||
| Craft Resource Modifier || 1 | | Craft Resource Modifier || 1 | ||
Line 310: | Line 243: | ||
| Craft Time Multiplier || 1 | | Craft Time Multiplier || 1 | ||
|- | |- | ||
| | | Player Experience Per Specialty || 0 | ||
| | |||
|- | |- | ||
| | | End Game Craft Cost || Normal | ||
|- | |- | ||
|} | |} | ||
{| class="wikitable mw-collapsible mw-collapsed" | {| class="wikitable mw-collapsible mw-collapsed" | ||
Line 324: | Line 254: | ||
|- | |- | ||
| Skill Gain Multiplier || 1 | | Skill Gain Multiplier || 1 | ||
|- | |||
| Specialty Experience Divisor || 20 | |||
|- | |||
| Specialty Experience Per Level || 25 | |||
|- | |||
| Unlearn Refund Rate || 0.5 | |||
|- | |- | ||
| Craft Resource Modifier || 1 | | Craft Resource Modifier || 1 | ||
Line 329: | Line 265: | ||
| Craft Time Multiplier || 1 | | Craft Time Multiplier || 1 | ||
|- | |- | ||
| | | Player Experience Per Specialty || 0 | ||
| | |||
|- | |- | ||
| | | End Game Craft Cost || Normal | ||
|- | |- | ||
|} | |} | ||
{| class="wikitable mw-collapsible mw-collapsed" | {| class="wikitable mw-collapsible mw-collapsed" | ||
Line 343: | Line 276: | ||
|- | |- | ||
| Skill Gain Multiplier || 1 | | Skill Gain Multiplier || 1 | ||
|- | |||
| Specialty Experience Divisor || 20 | |||
|- | |||
| Specialty Experience Per Level || 25 | |||
|- | |||
| Unlearn Refund Rate || 0.5 | |||
|- | |- | ||
| Craft Resource Modifier || 1 | | Craft Resource Modifier || 1 | ||
Line 348: | Line 287: | ||
| Craft Time Multiplier || 1 | | Craft Time Multiplier || 1 | ||
|- | |- | ||
| | | Player Experience Per Specialty || 0 | ||
| | |||
|- | |- | ||
| | | End Game Craft Cost || Expensive | ||
|- | |- | ||
|} | |} | ||
==== Disasters.eco ==== | ==== Disasters.eco ==== | ||
File use to configure the meteor. | File use to configure the meteor. | ||
Line 379: | Line 313: | ||
|} | |} | ||
* | * | ||
==== EcoSim.eco ==== | ==== EcoSim.eco ==== | ||
Contains settings for atmosphere, [[pollution]] rates (e.g. from [[tailings]]) and sea level rise, as well as [[biome]] definitions and simulation interactions like rainfall. | Contains settings for atmosphere, [[pollution]] rates (e.g. from [[tailings]]) and sea level rise, as well as [[biome]] definitions and simulation interactions like rainfall. | ||
Line 398: | Line 325: | ||
** <code>English</code> English | ** <code>English</code> English | ||
** <code>French</code> Français | ** <code>French</code> Français | ||
==== ModKit.eco ==== | ==== ModKit.eco ==== | ||
Controls mod loading. | Controls mod loading. | ||
Line 472: | Line 394: | ||
File use to configure world's generator. Settings here will only take effect when generating a new world. | File use to configure world's generator. Settings here will only take effect when generating a new world. | ||
*<code>Seed</code> Determines the randomizer seed used for world generation. Two identical config files with the same seed will generate identical worlds. Identical config files with different seeds will generate similar (i.e. based on the same parameters) but different worlds. | *<code>Seed</code> Determines the randomizer seed used for world generation. Two identical config files with the same seed will generate identical worlds. Identical config files with different seeds will generate similar (i.e. based on the same parameters) but different worlds. | ||
*<code>Dimensions</code> Both values must be equal, and must be multiples of 4 (or the server won't launch). Larger world will be more resistant to pollution and have more natural resources. These values correspond to tens of meters (not blocks), so the default 72x72 world is 720 meters in each direction, or | *<code>Dimensions</code> Both values must be equal, and must be multiples of 4 (or the server won't launch). Larger world will be more resistant to pollution and have more natural resources. These values correspond to tens of meters (not blocks), so the default 72x72 world is 720 meters in each direction, or 0.52 km<sup>2</sup>. See also [[Server Configuration#Change World Size]]. | ||
*<code>WaterLevel</code> At which height level the water's surface is. Defaults to a multiple of 4. Other values (e.g. 62 instead of the default 60) will cause water to reach only partially up the side of blocks. If that is a problem is unknown. | *<code>WaterLevel</code> At which height level the water's surface is. Defaults to a multiple of 4. Other values (e.g. 62 instead of the default 60) will cause water to reach only partially up the side of blocks. If that is a problem is unknown. | ||
*<code>Height</code> The maximum world terrain elevation, probably. | *<code>Height</code> The maximum world terrain elevation, probably. |