generator_settings.md

Generator Settings

20w21a

Table of Contents
Noise size_horizontal and size_vertical density_factor and density_offset sampling top_slide and bottom_slide
Structures spacing and separation salt

External Links

• Wiki Documentation
• Dimension Generator

Noise

size_horizontal and size_vertical

Integers between 1 and 4.

→ size_horizontal
↓ size_vertical

	1	2	4
1
2
3
4

Surprisingly, when size_horizontal is 3, it generates this interesting pattern

density_factor and density_offset

When editing these values, you need to keep in mind the following formula.

terrain height = ((density_offset / density_factor) + 1) * height / 2

density_factor	density_offset
0.5	-0.25
1	-0.5
2	-1
4	-2

sampling

xz_scale

0.25	1	8

Setting xz_scale to 0 will cause a flat surface.

xz_factor

20	80	320

top_slide and bottom_slide

WIP

target

size

offset

Structures

spacing and separation

spacing determines the maximum space in chunks between two structures of this type. separation determines the minimum space in chunks. spacing must be larger than separation. A grid pattern forms when spacing is one larger than separation.

→ separation
↓ spacing

	1	2	3
2
3
4
5

salt

Determines the random placement of the structures after being combined with the seed.

Whoa, did you actually try all these worlds?

@ManosSef Haha yes. And a lot more then the screenshots for figuring it out first. I got a lot of help from the Minecraft Commands discord.

Do you by chance know any default values for density_factor, density_offset, size_horizontal, size_vertical, xz_scale, xz_factor, y_scale, y_factor.
It looked like you had a normal world that you started with in some of the pictures.

Here is a link to the world settings for vanilla dimensions with their default values.

For the overworld, the defaults are "density_factor": 1.0 and "density_offset": -0.46875

Thanks, a ton! Outside of you I don't think anyone else actually had the default values. Now I can work on those floating islands!

Wow, those default values are the file I've been relentlessly scouring the internet for. Thanks!

I'm curious, how did you find these default values?

Amber on the Minecraft Commands discord looked at the source code to find these. If you're interested to join: https://discord.gg/QAFXFtZ

Awesome, thanks!

The stuff in that discord link is excellent. Thanks a ton for sharing that. However, I noticed it doesn't have the default biome parameters for overworld biomes. Do you happen to know where I may be able to find them? I was attempting to make a snowy dimension, but it's not using the biomes correctly, and some biomes are unused. I believe bad parameters are the problem.

Overworld biomes don't use the multi_noise setting, thus they don't have biome parameters. Instead they use a hardcoded system vanilla_layered. You'll have to experiment a bit when you want a custom overworld biome distribution.

Unfortunately the world preset generator is broken, I can't use it anymore. It's not up-to-date.

@HexBugOrion Sorry for the delay. I have just implemented the missing features. It should now be up-to-date and working in 1.16 RC-1. Don't hesitate to mention if there is something unclear or not working 🙂

I'd like to know more about how density_offset works in the nether where the density_factor is 0 by default which would lead to division by zero in your formula.

That is also the part that confuses me still. The formula is only an observation and a trick to make it easier to work with them. I believe you can see it as the baseline/terrain height being at infinity and the mountains spanning infinite blocks outwards. Thus creating a uniform distribution across the whole height.

Where do I place this file for server jar?

Anybody have the default Vanilla worldgen as a json for the new snapshot? I'm considering adding custom dimensions to an existing world but unsure how to do that safely.

Slicedlime shared the default vanilla worldgen files in a tweet.

The "checkerboard" type for the custom dimension generator doesn't seem to be generating syntax that's acceptable to the game. (As of 1.16.3

I finally figured out why a size_horizontal of 3 causes the grid like patterns to occur. In one of the classes relating to world generation, the extracted size_horizontal is converted using bit shift operators to a different number. This number is usually a multiple of 16 if the size_horizontal number is either 1,2 or 4. However, for if it is 3, the conversion method spits out a 12.

This matters because in the chunk generator class, 16 is divided by the conversion value, and is usually resulted in an integer that is greater than 1. So, for a size_horizontal of 3, the conversion value is 12, and so, 16/12 = 1.333333.....; This value is taken into a for-loop(have not figured out what it does), and the iteration index is compared to if it is less than the states value above, and so it essentially is rounded down to 1. I would assume that this causes 1/4 of a chunk to not be generated. More testing is still needed. I will post a more detailed comment later on; still at work.