Server Configuration/WorldGenerator.eco
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
|
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
|
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
|
1.0 - 3.0
|
The number of continents to spawn. |
ContinentAvoidRange.min
|
8.0 - 16.0
|
Range that continents avoid other landmasses. |
NumSmallIslandsRange.min
|
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
|
0.0008 - 0.0018
|
Size range to spawn lakes. |
NumLakesRange.min
|
4.0 - 8.0
|
The number of lakes to spawn. |
NumRiversRange.min
|
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
|
5.0 - 50.0
|
The radius range of the crater in blocks. |
DepthRange.min
|
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
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.
