Custom dimension

Dimensions are JSON files located in data packs that define new dimensions for the game. These dimensions can be accessed with. Any dimensions are loaded once the world is opened, not on reload; so any change or addition to the file require the world to be restarted to apply, and not just running.

Usage
New dimensions are stored as JSON files within a data pack, at the path.

Dimension syntax

 * The root tag.
 * : The namespaced ID of the dimension type. Can be preset, , , , or a custom dimension type (configure via JSON files, see dimension type section).
 * : Generation settings used for that dimension.
 * (string): The ID of the generator. minecraft: followed by flat, noise or debug.
 * Other compounds (see below)

Generator types
The format of the compound is dependent on the value of its generator ID, or.

When the generator ID type is minecraft:noise:
 * Generation settings used for the dimension.
 * (string): The ID of the generator (in this case, minecraft:noise).
 * The seed used to generate the dimension. In most cases, this is exactly the same as the world seed, but can be different and the dimension generated is based upon this seed and not the world seed.
 * The noise settings used in the terrain generator. Can be set to a string to use a preset defined in the folder with a list of customized options. See Custom world generation for more information.
 * Settings dictating which biomes and biome shapes.
 * (integer): The seed used for biome generation. In most cases, this is exactly the same as the dimension seed (and by extension the world seed), but can be different and the biome generation for this dimension is based upon this seed and not the dimension seed.
 * (List): A list of biome IDs to generate.
 * (string): The type of biome generation. Arguments lie in the biome_source compound. Some possible values for include.
 * vanilla_layered: Default and large biome generation used in the overworld.
 * (Boolean): Whether the biomes are large. True for biomes generation in the "Large Biomes" world type.
 * (Boolean): Whether the world was default_1_1.
 * multi_noise: 3D biome generation used in the nether.
 * (string): A preset of the set of biomes to be used, mutually exclusive with the only valid that's currently supported is minecraft:nether.
 * A list of biomes, including their likelihood.
 * A biome and its properties
 * (string): The biome.
 * Represent optimal conditions for where the biome should be placed. These values do not affect the generation of terrain within biomes; they affect where the game chooses to place biomes. altitude, weirdness, humidity and temperature are each represented in a distinct contoured map generated by the seed. At any specific point, the biome having parameters most closely resembling the respective parameter on each noise map at that point is chosen. For example, if the point were to have values of -1 temperature, 0.2 humidity, 0.5 altitude and 0 weirdness then birch_forest_hills (-0.1t,0.2h,0.25a,0w) would be chosen over desert (0.5t,-0.5h,0a,0w).
 * (float): Used to place similar biomes near each other. Range: (-2.0 to 2.0).
 * (float): Defines how weird the biome is going to appear next to other biomes. Range: (-2.0 to 2.0).
 * (float): Range: (0.0 to 1.0). Similar to the other parameters but offset is 0 everywhere, thus setting this parameter nearer to 0 gives the biome a greater edge over others, all else being equal.
 * (float): Used to place similar biomes near each other. This is NOT the same as the temperature value listed on Biome, it does NOT affect rain/snow or the color of leaves and grass. Range: (-2.0 to 2.0).
 * (float): Used to place similar biomes near each other. Range: (-2.0 to 2.0).
 * An amplitude.
 * An amplitude.
 * An amplitude.
 * An amplitude.
 * the_end: Biome generation used in the end with biome minecraft:the_end in the center and other end biomes around.
 * fixed: a single biome.
 * The single biome to generate.
 * checkerboard: A biome generation in which biomes are square (or close to square) and repeat along the diagonals.
 * A list of biomes that repeat along the diagonals (can be more than 3).
 * Determines the size of the squares on an exponential scale.
 * An amplitude.
 * An amplitude.
 * the_end: Biome generation used in the end with biome minecraft:the_end in the center and other end biomes around.
 * fixed: a single biome.
 * The single biome to generate.
 * checkerboard: A biome generation in which biomes are square (or close to square) and repeat along the diagonals.
 * A list of biomes that repeat along the diagonals (can be more than 3).
 * Determines the size of the squares on an exponential scale.
 * The single biome to generate.
 * checkerboard: A biome generation in which biomes are square (or close to square) and repeat along the diagonals.
 * A list of biomes that repeat along the diagonals (can be more than 3).
 * Determines the size of the squares on an exponential scale.

When the generator ID type is minecraft:flat (used for Superflat world generation):
 * Generation settings used for the dimension.
 * (string): The ID of the generator (in this case, minecraft:flat).
 * Superflat settings.
 * Layer settings.
 * A superflat layer. This list is interpreted from top to bottom.
 * The number of blocks in the layer.
 * The block the layer is made of.
 * the single biome of the world
 * (optional): Whether or not to generate lakes. If set to true, then water and lava lakes generate often even in biomes where lakes don't normally generate. Lava lakes generate surrounded by different types of stone and ores from the overworld.
 * (optional): Whether or not to generate biome-specific decorations like trees, grass, flowers, cacti, etc.
 * Structure settings
 * Settings for how strongholds should be spawned. The stronghold values under the  tag appear to be placeholders so that every namespaced structure has a value; these values are the ones that actually control stronghold spawning.
 * Controls how far apart the strongholds are.
 * How many strongholds to generate.
 * List of structures to use in this dimension
 * The key for this field should be the namespaced ID of a structure, a list is available at . If structures are not listed, it does not generate.
 * (number): Average distance between two structure placement attempts of this type in chunks.
 * (number): Minimum distance between two structures of this type in chunks; must be less than.
 * (integer): A number that assists in randomization; see.
 * (integer): A number that assists in randomization; see.

When the generator ID type is minecraft:debug (used for Debug world generation):
 * Generation settings used for the dimension.
 * (string): The ID of the generator (in this case, minecraft:debug).

Dimension type
Dimension types are stored as JSON files within a data pack, at the path.

Syntax

 * The root