Server Configuration/WorldGenerator.eco: Difference between revisions

From Eco - English Wiki
[checked revision][checked revision]
undoPwnerdonor (talk | contribs)
Autochecked users
509 edits
VisualWikitext
Created page with "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>Dimensions</code> Both values must be equal, and must be multiples of 4 (or the server won't launch). Larger world will be..."
 
Updating with latest config information
 
Line 1: Line 1:
Settings here will only take effect when generating a new world.
[[Category:Server Management]]
*<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.
The settings in this file can be accessed in-game by using the /serverui command and navigating to Sim -> World Generator
*<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.52km2. 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>Height</code> The maximum world terrain elevation, probably.


*<code>LandPercentageRange</code> an upper and lower bound for how much of the world can be made into landmass during world generation. Anything that isn't land will be made into ocean. Keep in mind that more land will mean more vegetation and animals, which may shift the difficulty of the game as these affect pollution outcomes and available resources.
The server UI allows you to preview the settings to see how a generated world might look, which takes much less time than generating the entire world.
*<code>CoastlineSize</code> Size of land coast (beach)
 
*<code>ShallowOceanSize</code> Unknown, may be related to how much shallow water surrounds landmasses.
Note: Most or all of these settings will not take effect until the world is re-generated.
*<code>BiomePercent</code> How much of the landmass will be of a certain biome type, adjustable for each kind of biome (e.g. WarmForestPercent). Uses a decimal value rather than percentages in the config file. The sum of these values must add up to less than a hundred percent so that the remainder can be made into grasslands.
{| class="wikitable sortable"
*<code>NumContinentsRange</code> Determines how many continents may be created. Set max and min values to the same (e.g. 2) to ensure exactly that many continents are generated.
!Setting
*<code>ContinentAvoidRange</code> How far apart continents will be. Unknown what the values actually mean.
!Default
*<code>IslandPercent</code> How much of the world (or remaining ocean, maybe) will be dotted with islands.
!Description
*<code>NumSmallIslandsRange</code> Determines the number of islands. Combined with IslandPercent, determines the size and number of islands present.
|-
*<code>IslandAvoidRange</code> Determines how far from other landmasses islands will be generated. Unknown what the values actually mean.
|<code>MapSizePreset</code>
*<code>NumBiome</code> One setting for each type (e.g. NumRainforests, etc.), determining how many will be generated. Combine with BiomePercent to make, for example, many small or fewer large such biomes.
|<code>Small</code>
*<code>LakeSizeRange</code> Range of how many blocks the lakes will take up.
|Valid values: <code>Small</code>, <code>Medium</code>, <code>Large</code>
*<code>NumLakesRange</code> Range of how many lakes canspawn.
Changing this preset in the UI will change the dimensions to 72x72 , 100x100, or 160x160, respectively.
*<code>NumRiversRange</code> Range of how many rivers can spawn.
|-
*<code>RiverAvoidance</code> Distance between the spawned rivers.
|<code>Dimensions.WorldWidth</code>
*<code>RiverWidth</code> Width of the River in blocks.
<code>Dimensions.WorldHeight</code>
*<code>MaxElevationOceanDistance</code> Unknown.
|<code>72x72</code>
*<code>ElevationPower</code> Unknown.
|Chunk dimensions of the world along X-Y. Both dimensions must have the same value and be divisible by 4. For larger worlds (around 250x250), <code>MaxBuildHeight</code> may be reduced on server start if the dimensions and height would generate a world that is too large. See [[Server Configuration/WorldGenerator.eco#Change World Size|Change World Size]] section below for more details.
*<code>AutoScale</code> Unknown.
|-
*<code>AutoScaleExponent</code> Unknown.
|<code>WaterLevel</code>
*<code>SaveTerrainImage</code> Creates a biomes.png image in the server folder after worldgen if set to true.
|<code>60</code>
|The sea level.
|-
|<code>MaxGenerationHeight</code>
|<code>120</code>
|Maximum height where terrain may appear during world generation.
|-
|<code>MaxBuildHeight</code>
|<code>160</code>
|Maximum height of the world citizens may build to. Can't be lowered after world creation. Note that values bigger than 160 will heavily increase hardware usage on the server. Has hard limit of 320. Should never be lower than <code>MaxGenerationHeight</code>. This value may be reduced on server start if world dimensions and height would generate a world that is too large. See [[Server Configuration/WorldGenerator.eco#Change World Size|Change World Size]] section below for more details.
|-
! colspan="2" |'''Heightmap Module'''
|Collection containing configuration related world biome generation.
|-
|<code>Seed</code>
|<code>0</code>
|The seed to use to generate the world which can be used to generate the same world again. Note that if you want to duplicate a world off of a seed, you need to match the settings in WorldGenerator.eco for that world as well as the seed. Changing any setting in the file will likely cause a completely different world to generate.
|-
|<code>LandPercentRange.Min</code>
<code>LandPercentRange.Max</code>
|<code>0.65 - 0.75</code>
|The percentage of the world that will be land. The rest will be ocean.
|-
|<code>CoastlineSize</code>
|<code>1</code>
|
|-
|<code>ShallowOceanSize</code>
|<code>2</code>
|
|-
|<code>DesertWeight</code>
|<code>0.15</code>
|Weight of land to spawn for this biome.
|-
|<code>WarmForestWeight</code>
|<code>0.2</code>
|Weight of land to spawn for this biome.
|-
|<code>CoolForestWeight</code>
|<code>0.22</code>
|Weight of land to spawn for this biome.
|-
|<code>TaigaWeight</code>
|<code>0.08</code>
|Weight of land to spawn for this biome.
|-
|<code>TundraWeight</code>
|<code>0.03</code>
|Weight of land to spawn for this biome.
|-
|<code>IceWeight</code>
|<code>0.01</code>
|Weight of land to spawn for this biome.
|-
|<code>RainforestWeight</code>
|<code>0.15</code>
|Weight of land to spawn for this biome.
|-
|<code>WetlandWeight</code>
|<code>0.04</code>
|Weight of land to spawn for this biome.
|-
|<code>SteppeWeight</code>
|<code>0.1</code>
|Weight of land to spawn for this biome.
|-
|<code>HighDesertWeight</code>
|<code>0.05</code>
|Weight of land to spawn for this biome.
|-
|<code>NumContinentsRange.min</code>
<code>NumContinentsRange.max</code>
|<code>1.0 - 3.0</code>
|The number of continents to spawn.
|-
|<code>ContinentAvoidRange.min</code>
<code>ContinentAvoidRange.max</code>
|<code>8.0 - 16.0</code>
|Range that continents avoid other landmasses.
|-
|<code>NumSmallIslandsRange.min</code>
<code>NumSmallIslandsRange.max</code>
|<code>1.0 - 3.0</code>
|The number of small islands that will spawn.
|-
|<code>IslandAvoidRange</code>
|<code>4.0 - 8.0</code>
|Range that islands avoid other landmasses.
|-
|<code>IslandWeight</code>
|<code>0.05</code>
|Weight of lands to spawn as smaller islands.
|-
|<code>NumRainforests</code>
|<code>1</code>
|Minimum number of this biome to spawn. Multiple biomes can merge into one larger biome.
|-
|<code>NumWarmForests</code>
|<code>1</code>
|Minimum number of this biome to spawn. Multiple biomes can merge into one larger biome.
|-
|<code>NumCoolForests</code>
|<code>1</code>
|Minimum number of this biome to spawn. Multiple biomes can merge into one larger biome.
|-
|<code>NumTaigas</code>
|<code>1</code>
|Minimum number of this biome to spawn. Multiple biomes can merge into one larger biome.
|-
|<code>NumTundras</code>
|<code>1</code>
|Minimum number of this biome to spawn. Multiple biomes can merge into one larger biome.
|-
|<code>NumIces</code>
|<code>1</code>
|Minimum number of this biome to spawn. Multiple biomes can merge into one larger biome.
|-
|<code>NumDeserts</code>
|<code>1</code>
|Minimum number of this biome to spawn. Multiple biomes can merge into one larger biome.
|-
|<code>NumWetlands</code>
|<code>1</code>
|Minimum number of this biome to spawn. Multiple biomes can merge into one larger biome.
|-
|<code>NumHighDeserts</code>
|<code>1</code>
|Minimum number of this biome to spawn. Multiple biomes can merge into one larger biome.
|-
|<code>NumSteppes</code>
|<code>1</code>
|Minimum number of this biome to spawn. Multiple biomes can merge into one larger biome.
|-
|<code>LakeSizeRange.min</code>
<code>LakeSizeRange.max</code>
|<code>0.0008 - 0.0018</code>
|Size range to spawn lakes.
|-
|<code>NumLakesRange.min</code>
<code>NumLakesRange.max</code>
|<code>4.0 - 8.0</code>
|The number of lakes to spawn.
|-
|<code>NumRiversRange.min</code>
<code>NumRiversRange.max</code>
|<code>2.0 - 5.0</code>
|The number of rivers to spawn.
|-
|<code>RiverCellAvoidance</code>
|<code>2</code>
|The distance in meters that rivers avoid themselves and other rivers.
|-
|<code>RiverCellWidth</code>
|<code>10.0</code>
|Approximate width of rivers.
|-
|<code>MaxElevationOceanDistance</code>
|<code>10.0</code>
|The distance in meters from the ocean where the maximum world elevation is allowed.
|-
|<code>ElevationPower</code>
|<code>2.0</code>
|The power or rate of change in elevation from the ocean.
|-
|<code>AutoScale</code>
|<code>true</code>
|Autoscales features based on world size compared to default. Internally affects the number of biomes and continent size. For finer control of larger worlds, disable this feature.
|-
|<code>AutoScaleExponent</code>
|<code>0.25</code>
|Power used in the autoscale function (worldSize / defaultWorldSize) ^ exponent
|-
! colspan="2" |'''Water Module'''
|Collection that appears to contain no useful configuration.
|-
! colspan="2" |'''Ranfall Module'''
|Collection that appears to contain no useful configuration.
|-
! colspan="2" |'''Temperature Module'''
|Collection that appears to contain no useful configuration.
|-
! colspan="2" |'''Crater'''
|Collection containing configuration related to crater generation.
|-
|<code>Frequency</code>
|<code>0.0</code>
|Frequency of craters (should be very low)
|-
|<code>RadiusRange.min</code>
<code>RadiusRange.max</code>
|<code>5.0 - 50.0</code>
|The radius range of the crater in blocks.
|-
|<code>DepthRange.min</code>
<code>DepthRange.max</code>
|<code>0.1 - 0.5</code>
|The depth range of the crater.
|-
! colspan="2" |'''TerrainModule'''
|This collection contains a detailed list of where each block can appear in a biome. It does not appear to include ore. Modifying these values could affect where certain blocks spawn but changing these values may cause strange behavior.
|}
=== Change World Size ===
The X and Y values ​​<i>must</i> be the same and divisible by 4.
 
Below are the current recommendations for world sizes:
* (72,72) — 0.52 km2 — "Small", this is the default size, recommended for singleplayer and co-op games.
* (100,100) — 1 km2 —"Medium", this size is often used for small public servers.
* (160,160) — 2.56 km2 — "Large", this is the largest size that can be generated from "Host a World", but not the largest world that can be generated.
 
The following world sizes are known work on servers with above average performance, but are not recommended to be used, given they will not allow any meaningful impact on ecology.
* (172,172) — 2.96 km2
* (200,200) — 4 km2
 
The following world sizes can work on servers and clients with strong performance, but are not recommended to be used, given they will not allow any meaningful impact on ecology and will likely not perform well.
* (224,224) — 5.02 km2
* (240,240) — 5.76 km2
* (248,248) — 6.15 km2
* (272,272) — 7.4 km2
* (296,296) — 8.76 km2
* (300,300) — 9 km2
* (360,360) — 12.6 km2
* (400,400) — 16 km2
 
Worlds over 400x400 may be possible to generate, but are extremely likely to be unstable, even with the most performant hardware available on clients and server.
 
Note: The maximum world volume is ((L*10)*(W*10)*H) = 2,147,483,647. Attempting to create a world larger than this will cause the server to scale down the settings to their maximum supported values.

Latest revision as of 10:56, 14 January 2026

The settings in this file can be accessed in-game by using the /serverui command and navigating to Sim -> World Generator

The server UI allows you to preview the settings to see how a generated world might look, which takes much less time than generating the entire world.

Note: Most or all of these settings will not take effect until the world is re-generated.

Setting Default Description
MapSizePreset Small Valid values: Small, Medium, Large

Changing this preset in the UI will change the dimensions to 72x72 , 100x100, or 160x160, respectively.

Dimensions.WorldWidth

Dimensions.WorldHeight

72x72 Chunk dimensions of the world along X-Y. Both dimensions must have the same value and be divisible by 4. For larger worlds (around 250x250), MaxBuildHeight may be reduced on server start if the dimensions and height would generate a world that is too large. See Change World Size section below for more details.
WaterLevel 60 The sea level.
MaxGenerationHeight 120 Maximum height where terrain may appear during world generation.
MaxBuildHeight 160 Maximum height of the world citizens may build to. Can't be lowered after world creation. Note that values bigger than 160 will heavily increase hardware usage on the server. Has hard limit of 320. Should never be lower than MaxGenerationHeight. This value may be reduced on server start if world dimensions and height would generate a world that is too large. See Change World Size section below for more details.
Heightmap Module Collection containing configuration related world biome generation.
Seed 0 The seed to use to generate the world which can be used to generate the same world again. Note that if you want to duplicate a world off of a seed, you need to match the settings in WorldGenerator.eco for that world as well as the seed. Changing any setting in the file will likely cause a completely different world to generate.
LandPercentRange.Min

LandPercentRange.Max

0.65 - 0.75 The percentage of the world that will be land. The rest will be ocean.
CoastlineSize 1
ShallowOceanSize 2
DesertWeight 0.15 Weight of land to spawn for this biome.
WarmForestWeight 0.2 Weight of land to spawn for this biome.
CoolForestWeight 0.22 Weight of land to spawn for this biome.
TaigaWeight 0.08 Weight of land to spawn for this biome.
TundraWeight 0.03 Weight of land to spawn for this biome.
IceWeight 0.01 Weight of land to spawn for this biome.
RainforestWeight 0.15 Weight of land to spawn for this biome.
WetlandWeight 0.04 Weight of land to spawn for this biome.
SteppeWeight 0.1 Weight of land to spawn for this biome.
HighDesertWeight 0.05 Weight of land to spawn for this biome.
NumContinentsRange.min

NumContinentsRange.max

1.0 - 3.0 The number of continents to spawn.
ContinentAvoidRange.min

ContinentAvoidRange.max

8.0 - 16.0 Range that continents avoid other landmasses.
NumSmallIslandsRange.min

NumSmallIslandsRange.max

1.0 - 3.0 The number of small islands that will spawn.
IslandAvoidRange 4.0 - 8.0 Range that islands avoid other landmasses.
IslandWeight 0.05 Weight of lands to spawn as smaller islands.
NumRainforests 1 Minimum number of this biome to spawn. Multiple biomes can merge into one larger biome.
NumWarmForests 1 Minimum number of this biome to spawn. Multiple biomes can merge into one larger biome.
NumCoolForests 1 Minimum number of this biome to spawn. Multiple biomes can merge into one larger biome.
NumTaigas 1 Minimum number of this biome to spawn. Multiple biomes can merge into one larger biome.
NumTundras 1 Minimum number of this biome to spawn. Multiple biomes can merge into one larger biome.
NumIces 1 Minimum number of this biome to spawn. Multiple biomes can merge into one larger biome.
NumDeserts 1 Minimum number of this biome to spawn. Multiple biomes can merge into one larger biome.
NumWetlands 1 Minimum number of this biome to spawn. Multiple biomes can merge into one larger biome.
NumHighDeserts 1 Minimum number of this biome to spawn. Multiple biomes can merge into one larger biome.
NumSteppes 1 Minimum number of this biome to spawn. Multiple biomes can merge into one larger biome.
LakeSizeRange.min

LakeSizeRange.max

0.0008 - 0.0018 Size range to spawn lakes.
NumLakesRange.min

NumLakesRange.max

4.0 - 8.0 The number of lakes to spawn.
NumRiversRange.min

NumRiversRange.max

2.0 - 5.0 The number of rivers to spawn.
RiverCellAvoidance 2 The distance in meters that rivers avoid themselves and other rivers.
RiverCellWidth 10.0 Approximate width of rivers.
MaxElevationOceanDistance 10.0 The distance in meters from the ocean where the maximum world elevation is allowed.
ElevationPower 2.0 The power or rate of change in elevation from the ocean.
AutoScale true Autoscales features based on world size compared to default. Internally affects the number of biomes and continent size. For finer control of larger worlds, disable this feature.
AutoScaleExponent 0.25 Power used in the autoscale function (worldSize / defaultWorldSize) ^ exponent
Water Module Collection that appears to contain no useful configuration.
Ranfall Module Collection that appears to contain no useful configuration.
Temperature Module Collection that appears to contain no useful configuration.
Crater Collection containing configuration related to crater generation.
Frequency 0.0 Frequency of craters (should be very low)
RadiusRange.min

RadiusRange.max

5.0 - 50.0 The radius range of the crater in blocks.
DepthRange.min

DepthRange.max

0.1 - 0.5 The depth range of the crater.
TerrainModule This collection contains a detailed list of where each block can appear in a biome. It does not appear to include ore. Modifying these values could affect where certain blocks spawn but changing these values may cause strange behavior.

Change World Size

[edit | edit source]

The X and Y values ​​must be the same and divisible by 4.

Below are the current recommendations for world sizes:

  • (72,72) — 0.52 km2 — "Small", this is the default size, recommended for singleplayer and co-op games.
  • (100,100) — 1 km2 —"Medium", this size is often used for small public servers.
  • (160,160) — 2.56 km2 — "Large", this is the largest size that can be generated from "Host a World", but not the largest world that can be generated.

The following world sizes are known work on servers with above average performance, but are not recommended to be used, given they will not allow any meaningful impact on ecology.

  • (172,172) — 2.96 km2
  • (200,200) — 4 km2

The following world sizes can work on servers and clients with strong performance, but are not recommended to be used, given they will not allow any meaningful impact on ecology and will likely not perform well.

  • (224,224) — 5.02 km2
  • (240,240) — 5.76 km2
  • (248,248) — 6.15 km2
  • (272,272) — 7.4 km2
  • (296,296) — 8.76 km2
  • (300,300) — 9 km2
  • (360,360) — 12.6 km2
  • (400,400) — 16 km2

Worlds over 400x400 may be possible to generate, but are extremely likely to be unstable, even with the most performant hardware available on clients and server.

Note: The maximum world volume is ((L*10)*(W*10)*H) = 2,147,483,647. Attempting to create a world larger than this will cause the server to scale down the settings to their maximum supported values.

Retrieved from "https://wiki.play.eco/en/index.php?title=Server_Configuration/WorldGenerator.eco&oldid=16081"
CC BY-NC-SA 4.0
Powered by MediaWiki