Minecraft:Dimension definition (Java Edition)

Redirect to:

• Minecraft:Dimension definition

File:Floating Islands custom dimension.png

A custom dimension using a custom type, a fixed Minecraft:plains biome, and the minecraft:floating_islands Minecraft:noise settings

Template:Relevant tutorial Dimensions are Minecraft:JSON files located in Minecraft:data packs. They define new dimensions for the game. New dimensions added can be accessed by using commands, like Template:Cmd.

Usage

Dimensions are stored as Minecraft:JSON files within a data pack, at the path data/<namespace>/dimension/<name>.json. Alternatively, a world preset can be used to define all dimensions in a world. Dimensions stored separately override the dimension set in the selected world preset. This allows datapacks to only override a single dimension while keeping the other dimensions untouched. However, the user-selected world preset then doesn't have an impact on the given dimension.

The dimension definitions for the three default dimensions are not present in the dimensions file in vanilla data pack, they are present in the world preset.

JSON format

When stored as separate dimensions, they follow the following syntax:

• Template:Nbt The root tag.
  • Template:Nbt: Template:Json ref. Can be preset overworld, the_nether, the_end, overworld_caves, or a custom dimension type
  • Template:Nbt: Generation settings used for that dimension.
    • Template:Nbt: The generator type as Minecraft:resource location. One of noise, flat, or debug.
    • Additional fields of the generator, described below.

Generator types

debug

The generator type used when selecting Minecraft:debug mode in the world creation menu. This generator has no additional fields.

flat

The generator type used for Minecraft:superflat worlds.

• Additional fields:
  • Template:Nbt: Superflat settings.
    • Template:Nbt inherit/flat generator settings

noise

The generator used in all the default Minecraft:dimensions.

• Additional fields:
  • Template:NbtTemplate:Nbt: Template:Json ref — Settings for the noise generator.
  • Template:Nbt: Settings determining the biome layout.
    • Template:Nbt: The biome source type as a Minecraft:resource location.
    • Additional fields of the biome source, described below.

Biome sources

checkerboard

The checkerboard biome source places biomes in a checkerboard pattern.

• Additional fields:
  • Template:NbtTemplate:Nbt: Template:Json ref/biome. The biomes to be selected. The n-th biome in the list is used for all cells where Template:Cd, where Template:Cd is the list size and Template:Cd and Template:Cd are the cell coordinates (chunk pos × 2^Template:Nbt).
  • Template:Nbt: Optional. Value between 0 and 62 that defaults to 2. Determines the size of the checkerboard grid. A scale of 0 means each cell of the grid is one Minecraft:chunk wide. Doubles each time the scale increases.

fixed

The fixed biome source, also called Minecraft:single biome, uses one specified biome everywhere.

• Additional fields:
  • Template:Nbt: Template:Json ref/biome — The single biome to use.

multi_noise

A biome source that depends on multiple parameters defined in the Minecraft:noise router. Each biome is defined within a 4×4×4 cube based on the noise values at its edges.

• Additional fields:
  • Template:Nbt: A reference to a parameter list. The default parameter lists are overworld and nether.
• Or:
  • Template:Nbt: List of biome parameters points. Needs at least one entry. Biomes can appear in more than one parameter point.Template:More info
    • Template:Nbt: A parameter point.
      • Template:Nbt: Template:Json ref/biome — The biome used at this parameter point.
      • Template:Nbt: The parameters of this entry
        • Template:Nbt inherit/parameter point

the_end

The biome source used for Minecraft:the End dimension. This biome source has no additional fields.

Biomes are calculated based on each Minecraft:chunk for the x and z axes, and every 4 blocks for the y-axis.

• If the distance from the chunk edges to the origin is 1024 or less, the end biome is assigned.
• Otherwise, the biome is determined based on the erosion value (defined in Minecraft:noise router) calculated at the center of the chunk and the y-coordinate.

Erosion (e)	Biome
N/A	Template:BiomeLink
e > Template:Frac	Template:BiomeLink
Template:Frac ≥ e ≥ −Template:Frac	Template:BiomeLink
−Template:Frac > e ≥ −Template:Frac	Template:BiomeLink
e < −Template:Frac	Template:BiomeLink

Multi noise parameter list

A multi-noise biome source parameter list is stored as Minecraft:JSON files within a data pack, at the path data/<namespace>/worldgen/multi_noise_biome_source_parameter_list/<name>.json. It is used to avoid changing world preset files when adding new biomes to experimental data packs.

The syntax is as follows:

• • Template:Nbt: A reference to a hardcoded parameter list preset. The available presets are overworld and nether.

External links

• Dimension Generator on misode.github.io