{{about|data pack contents|the April Fools Easter egg dimensions|Java Edition 20w14∞|other uses|Dimension}}
{{relevant tutorial|Adding a new dimension}}
{{exclusive|java}}
{{relevant tutorial|Adding a new dimension}}
[[File:Floating Islands custom dimension.png|thumb|300px|A custom dimension using a [[dimension type|custom type]], a fixed [[plains]] biome, and the minecraft:floating_islands [[noise settings]].]] '''Dimensions''' are [[JSON]] files located in [[data pack]]s that define dimensions for the game. New dimensions added can be accessed by using commands, like {{cmd|/execute in run teleport }}. == Usage == Dimensions are stored as [[JSON]] files within a data pack, at the path data//dimension/.json. Alternatively, a [[Custom world preset]] can be used to customize 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. == JSON format ==
When stored as separate dimensions, they follow the following syntax: * {{nbt|compound}} The root tag. ** {{nbt|string|type}}: {{json ref|dimension type|Dimension type}}. Can be preset overworld, the_nether, the_end, overworld_caves, or a custom dimension type ** {{nbt|compound|generator}}: Generation settings used for that dimension. *** {{nbt|string|type}}: The [[#Generator types|generator]] type as [[resource location]]. One of noise, flat, or debug. *** Additional fields of the generator, described below.
== Generator types == === debug === The generator type used when selecting [[debug mode]] in the world creation menu. This generator has no additional fields. === flat === The generator type used for [[superflat]] worlds.
* Additional fields: ** {{Nbt|compound|settings}}: Superflat settings. *** {{nbt inherit/flat generator settings}}
=== noise === The generator used in all the default [[dimension]]s.
* Additional fields: ** {{Nbt|string}}{{Nbt|compound|settings}}: {{json ref|noise settings|custom noise settings|inline=1}} — Settings for the noise generator. ** {{nbt|compound|biome_source}}: Settings determining the biome layout. *** {{nbt|string|type}}: The [[#Biome sources|biome source]] type as a [[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: ** {{nbt|string}}{{nbt|list|biomes}}: {{json ref|biome|Custom biome|tag=1}} ** {{nbt|int|scale}}: 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 chunk wide. Doubles each time the scale increases.
=== fixed === The fixed biome source, also called [[single biome]], uses one specified biome everywhere.
* Additional fields: ** {{nbt|string|biome}}: {{json ref|biome|Custom biome}} — The single biome to use.
=== multi_noise ===
* Additional fields: ** {{nbt|string|preset}}: A reference to a [[#Multi noise parameter list|parameter list]]. The default parameter lists are overworld and nether. * Or: ** {{nbt|list|biomes}}: List of biome parameters points. Needs at least one entry. Biomes can appear in more than one parameter point. *** {{nbt|compound}}: A parameter point. **** {{nbt|string|biome}}: {{json ref|biome|Custom biome}} — The biome used at this parameter point. **** {{nbt|compound|parameters}}: Each parameter has values between -2 and 2. Examples: 0.2, [0.2, 0.4], {"min": 0.2, "max": 0.4} ***** {{nbt|float}}{{nbt|compound}}{{nbt|list|temperature}} ***** {{nbt|float}}{{nbt|compound}}{{nbt|list|humidity}} ***** {{nbt|float}}{{nbt|compound}}{{nbt|list|continentalness}} ***** {{nbt|float}}{{nbt|compound}}{{nbt|list|erosion}} ***** {{nbt|float}}{{nbt|compound}}{{nbt|list|weirdness}} ***** {{nbt|float}}{{nbt|compound}}{{nbt|list|depth}} ***** {{nbt|float|offset}}
=== the_end === The biome source used for [[the end]] dimension. This biome source has no additional fields. == Multi noise parameter list == A multi-noise biome source parameter list is stored as [[JSON]] files within a data pack, at the path data//worldgen/multi_noise_biome_source_parameter_list/.json. It is used to avoid changing world preset files when adding new biomes to experimental data packs. The syntax is as follows:
** {{nbt|string|preset}}: A reference to a hardcoded parameter list preset. The available presets are overworld and nether.
== History == {{HistoryTable |{{HistoryLine|java}} |{{HistoryLine||1.16|dev=Pre-release 1|Added dimensions to [[data pack]]s.}} |{{HistoryLine||1.16.2|dev=20w29a|The [[Custom noise settings|noise settings]] for custom dimensions can now also be stored in separate files.}} |{{HistoryLine|||dev=pre1|Custom dimensions now use the same folder pattern in data packs as other resources: namespace/<''type''>/resource.json.}} |{{HistoryLine||1.19|dev=22w11a|Removed the seed field in noise generator and the_end biome source, and the world seed is now always used for all dimensions. |[[Dimension type]]s can no longer be inlined in the dimension, they have to be a reference to a separate dimension_type file.}} |{{HistoryLine||1.19.4|dev=1.19.4-pre1|Added multi-noise biome source parameter list.}} }} == External links == * [https://misode.github.io/dimension/ Dimension Generator on misode.github.io] == Navigation == {{Navbox Java Edition technical|datapack}} [[Category:Dimensions]] [[de:Angepasste Dimensionen]] [[fr:Définition de dimension]] [[ja:カスタムディメンション]] [[pt:Definição de dimensão]] [[zh:维度数据格式]]