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 28: | Line 28: | ||
===== Set server description ===== | ===== Set server description ===== | ||
* DetailedDescription — Sets the long-form description of your server when people click on it in the server browser. Adding this description helps the server show up more prominently in the browser. | * DetailedDescription — Sets the long-form description of your server when people click on it in the server browser. Adding this description helps the server show up more prominently in the browser. | ||
* | |||
===== Set server category ===== | ===== Set server category ===== | ||
* ServerCategory — Choose from 1 of 4 categories that will show up when players first click on “New Game” in the Eco client. Selecting a category makes it much more likely new players will join your server. Strings available for this option are: | * ServerCategory — Choose from 1 of 4 categories that will show up when players first click on “New Game” in the Eco client. Selecting a category makes it much more likely new players will join your server. Strings available for this option are: | ||
Line 46: | Line 47: | ||
* 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 62: | ||
* 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 93: | ||
===== 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 SLG support staff: | |||
* (72,72) — 0.52km<sup>2</sup> — This is the default size for when first launching the Eco server. | |||
* (100,100) — 1km<sup>2</sup> — Maximum size for EcoServer32.exe | |||
* (140,140) — 1.96km<sup>2</sup> | |||
* (172,172) — 2.96km<sup>2</sup> | |||
* (200,200) — 4km<sup>2</sup> | |||
The following worlds have been tested for 50 hours and are likely to be stable. They are, however, only suitable for powerful servers. | |||
* (224,224) — 5.02km<sup>2</sup> | |||
* (240,240) — 5.76km<sup>2</sup> | |||
* (248,248) — 6.15km<sup>2</sup> | |||
* (272,272) — 7.4km<sup>2</sup> | |||
* (296,296) — 8.76km<sup>2</sup> | |||
* (300,300) — 9km<sup>2</sup> | |||
* (360,360) — 12.6km<sup>2</sup> | |||
* (400,400) — 16km<sup>2</sup> | |||
Worlds over 400x400 may be possible to generate, but are very likely to be unstable. | |||
===== Change World Shape ===== | ===== Change World Shape ===== | ||
* WaterLevel — Sea level height. | * WaterLevel — Sea level height. | ||
Line 142: | Line 132: | ||
* Changes in EcoSim.eco are accepted when the server is restarted. However, the new values will only occur in newly planted / grown plants and trees. | * Changes in EcoSim.eco are accepted when the server is restarted. However, the new values will only occur in newly planted / grown plants and trees. | ||
* Changes in the full range of mods require the deletion of "Eco.Mods.dll" to take effect. | * Changes in the full range of mods require the deletion of "Eco.Mods.dll" to take effect. | ||
''Note:'' This configuration guide is based on player tests and crowd-sourcing. No information in this guide has not been confirmed by [[SLG]]. | |||
''Note: This configuration guide is based on player tests and crowd-sourcing. No information in this guide has been confirmed by | |||
=== 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 140: | ||
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 160: | ||
|<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 ressources 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 192: | ||
* <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 212: | ||
| 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 223: | ||
|- | |- | ||
| 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 234: | ||
| 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 245: | ||
|- | |- | ||
| 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 256: | ||
| 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 267: | ||
|- | |- | ||
| 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 278: | ||
| 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. | ||
*<code>CreateMeteor</code> (default : true) Defines if there is a meteor or not. | |||
*<code>MeteorImpactDays</code> (default : 30.0) Number of days before meteore. Real time defined. | |||
==== 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 299: | ||
** <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 422: | Line 318: | ||
*<code>GameServerPort</code> (default : 3000) Port to join server. | *<code>GameServerPort</code> (default : 3000) Port to join server. | ||
*<code>WebServerPort</code> (default : 3001) Web application port. | *<code>WebServerPort</code> (default : 3001) Web application port. | ||
*<code>Rate</code> The network rate used to communicate between server and client. | *<code>Rate</code> The network rate used to communicate between server and client. | ||
**A low rate will cause slow updates in the world. | **A low rate will cause slow updates in the world. | ||
Line 472: | Line 367: | ||
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. |