Minecraft:Dimension definition - Revision history

SyncBot: Sync: updated from Minecraft

2026-10-18T11:10:43Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:10, 18 October 2026
Line 3:		Line 3:

	[[File:Floating Islands custom dimension.png\|thumb\|300px\|A custom dimension using a [[dimension type\|custom type]], a fixed [[Minecraft:plains]] biome, and the <code>minecraft:floating_islands</code> [[Minecraft:noise settings]]]]		[[File:Floating Islands custom dimension.png\|thumb\|300px\|A custom dimension using a [[dimension type\|custom type]], a fixed [[Minecraft:plains]] biome, and the <code>minecraft:floating_islands</code> [[Minecraft:noise settings]]]]
	{{relevant tutorial\|Adding a new dimension}}		{{relevant tutorial\|Adding a new dimension}}'''Dimensions''' are [[Minecraft:JSON]] files located in [[Minecraft:data pack]]s {{in\|java}} and in [[Minecraft:behavior pack]]s {{in\|bedrock}}. They define new dimensions for the game. New dimensions added can be accessed by using commands, like {{cmd\|/execute in <dimension> run teleport <coordinates>}}.
	'''Dimensions''' are [[Minecraft:JSON]] files located in [[Minecraft:data pack]]s {{in\|java}} and in [[Minecraft:behavior pack]]s {{in\|bedrock}}. They define new dimensions for the game. New dimensions added can be accessed by using commands, like {{cmd\|/execute in <dimension> run teleport <coordinates>}}.

	== Usage ==		== Usage ==

SyncBot: Sync: updated from Minecraft

2026-10-04T11:08:36Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:08, 4 October 2026
Line 1:		Line 1:
	{{about\|data pack and behavior pack contents\|other uses\|Dimension}}		{{about\|data pack and behavior pack contents\|other uses\|Dimension}}
			{{Split\|Dimension definition (Java Edition)\| Dimension definition (Bedrock Edition)\|reason=There are few similarities between the versions.}}

	[[File:Floating Islands custom dimension.png\|thumb\|300px\|A custom dimension using a [[dimension type\|custom type]], a fixed [[Minecraft:plains]] biome, and the <code>minecraft:floating_islands</code> [[Minecraft:noise settings]]]]		[[File:Floating Islands custom dimension.png\|thumb\|300px\|A custom dimension using a [[dimension type\|custom type]], a fixed [[Minecraft:plains]] biome, and the <code>minecraft:floating_islands</code> [[Minecraft:noise settings]]]]
	{{relevant tutorial\|Adding a new dimension}}		{{relevant tutorial\|Adding a new dimension}}

SyncBot: Sync: updated from Minecraft

2026-09-24T11:09:21Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:09, 24 September 2026
Line 40:		Line 40:
	**** {{nbt\|string\|identifier}}: A [[Minecraft:namespaced identifier]] for the dimension. If this matches the identifier of a dimension registered by script, this definition will take priority.		**** {{nbt\|string\|identifier}}: A [[Minecraft:namespaced identifier]] for the dimension. If this matches the identifier of a dimension registered by script, this definition will take priority.
	*** {{nbt\|compound\|components}}: Components that define the properties of the dimension.		*** {{nbt\|compound\|components}}: Components that define the properties of the dimension.
	**** {{nbt\|compound\|minecraft:clouds}}: Defines if and where [[Minecraft:cloud]]s will be in the dimension. Omitting this component will result in the dimension not having clouds.		**** {{nbt\|compound\|minecraft:clouds}}:{{upcoming\|26.60}} Defines if and where [[Minecraft:cloud]]s will be in the dimension. Omitting this component will result in the dimension not having clouds.
	***** {{nbt\|int\|height}}: Determines the height at which clouds will appear in the dimension. Must be a number between -64 and ~~320~~.		***** {{nbt\|int\|height}}: Determines the height at which clouds will appear in the dimension. Must be a number between -512 and 512.
	**** {{nbt\|compound\|minecraft:default_biome}}: Defines the default biome used in the dimension.		**** {{nbt\|compound\|minecraft:default_biome}}: Defines the default biome used in the dimension.
	***** {{nbt\|string\|biome}}: The identifier of the biome to make default.		***** {{nbt\|string\|biome}}: The identifier of the biome to make default.
Line 172:		Line 172:
	\|{{HistoryLine\|upcoming Bedrock}}		\|{{HistoryLine\|upcoming Bedrock}}
	\|{{HistoryLine\|\|26.60\|dev=Preview 26.60.21\|Added the {{cd\|minecraft:clouds}} component, letting custom dimensions configure the height at which clouds render. No component means clouds do not render.}}		\|{{HistoryLine\|\|26.60\|dev=Preview 26.60.21\|Added the {{cd\|minecraft:clouds}} component, letting custom dimensions configure the height at which clouds render. No component means clouds do not render.}}
			\|{{HistoryLine\|\|\|dev=Preview 26.60.28\|Clouds can now be set between -512 and 512 instead of -64 and 320.}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-09-19T11:12:30Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:12, 19 September 2026
Line 1:		Line 1:
	{{about\|data pack and behavior pack contents\|other uses\|Dimension}}		{{about\|data pack and behavior pack contents\|other uses\|Dimension}}
	[[File:Floating Islands custom dimension.png\|thumb\|300px\|A custom dimension using a [[dimension type\|custom type]], a fixed [[Minecraft:plains]] biome, and the <code>minecraft:floating_islands</code> [[Minecraft:noise settings]].]]		[[File:Floating Islands custom dimension.png\|thumb\|300px\|A custom dimension using a [[dimension type\|custom type]], a fixed [[Minecraft:plains]] biome, and the <code>minecraft:floating_islands</code> [[Minecraft:noise settings]]]]
	{{relevant tutorial\|Adding a new dimension}}		{{relevant tutorial\|Adding a new dimension}}
	'''Dimensions''' are [[Minecraft:JSON]] files located in [[Minecraft:data pack]]s {{in\|java}} and in [[Minecraft:behavior pack]]s {{in\|bedrock}}. They define new dimensions for the game. New dimensions added can be accessed by using commands, like {{cmd\|/execute in <dimension> run teleport <coordinates>}}.		'''Dimensions''' are [[Minecraft:JSON]] files located in [[Minecraft:data pack]]s {{in\|java}} and in [[Minecraft:behavior pack]]s {{in\|bedrock}}. They define new dimensions for the game. New dimensions added can be accessed by using commands, like {{cmd\|/execute in <dimension> run teleport <coordinates>}}.
Line 8:		Line 8:
	=== ''Java Edition'' ===		=== ''Java Edition'' ===

	Dimensions are stored as [[Minecraft:JSON]] files within a data pack, at the path <code>data/<namespace>/dimension/<name>.json</code>. Alternatively, a [[Minecraft:~~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.		Dimensions are stored as [[Minecraft:JSON]] files within a data pack, at the path <code>data/<namespace>/dimension/<name>.json</code>. Alternatively, a [[Minecraft:World preset definition\|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.

	=== ''Bedrock Edition'' ===		=== ''Bedrock Edition'' ===
Line 157:		Line 159:
	\|[[Minecraft:Dimension type]]s can no longer be inlined in the dimension, they have to be a reference to a separate dimension_type file.}}		\|[[Minecraft: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=pre1\|Added multi-noise biome source parameter list.}}		\|{{HistoryLine\|\|1.19.4\|dev=pre1\|Added multi-noise biome source parameter list.}}
			\|{{HistoryLine\|\|?\|The Overworld's original fractal based biome source can no longer be picked.}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-09-18T11:14:35Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:14, 18 September 2026
Line 38:		Line 38:
	**** {{nbt\|string\|identifier}}: A [[Minecraft:namespaced identifier]] for the dimension. If this matches the identifier of a dimension registered by script, this definition will take priority.		**** {{nbt\|string\|identifier}}: A [[Minecraft:namespaced identifier]] for the dimension. If this matches the identifier of a dimension registered by script, this definition will take priority.
	*** {{nbt\|compound\|components}}: Components that define the properties of the dimension.		*** {{nbt\|compound\|components}}: Components that define the properties of the dimension.
			**** {{nbt\|compound\|minecraft:clouds}}: Defines if and where [[Minecraft:cloud]]s will be in the dimension. Omitting this component will result in the dimension not having clouds.
			***** {{nbt\|int\|height}}: Determines the height at which clouds will appear in the dimension. Must be a number between -64 and 320.
	**** {{nbt\|compound\|minecraft:default_biome}}: Defines the default biome used in the dimension.		**** {{nbt\|compound\|minecraft:default_biome}}: Defines the default biome used in the dimension.
	***** {{nbt\|string\|biome}}: The identifier of the biome to make default.		***** {{nbt\|string\|biome}}: The identifier of the biome to make default.
Line 45:		Line 47:
	**** {{nbt\|compound\|minecraft:generation}}: ''Required.'' Defines how the dimension generates.		**** {{nbt\|compound\|minecraft:generation}}: ''Required.'' Defines how the dimension generates.
	***** {{nbt\|string\|generator_type}}: The generator type to use for this dimension. Currently only {{cd\|void}} is supported.		***** {{nbt\|string\|generator_type}}: The generator type to use for this dimension. Currently only {{cd\|void}} is supported.
	**** {{nbt\|compound\|minecraft:clouds}}: Defines determines if there will be [[Minecraft:clouds]] in the dimension.
	***** {{nbt\|string\|height}}: Determines the height at which the cloud will be in the dimension, it is not possible to set heights higher than the overworld height.
	</div>		</div>

SyncBot: Sync: updated from Minecraft

2026-09-16T11:17:57Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:17, 16 September 2026
Line 156:		Line 156:
	\|{{HistoryLine\|\|1.19\|dev=22w11a\|Removed the <code>seed</code> field in <code>noise</code> generator and <code>the_end</code> biome source, and the world seed is now always used for all dimensions.		\|{{HistoryLine\|\|1.19\|dev=22w11a\|Removed the <code>seed</code> field in <code>noise</code> generator and <code>the_end</code> biome source, and the world seed is now always used for all dimensions.
	\|[[Minecraft:Dimension type]]s can no longer be inlined in the dimension, they have to be a reference to a separate dimension_type file.}}		\|[[Minecraft: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.}}		\|{{HistoryLine\|\|1.19.4\|dev=pre1\|Added multi-noise biome source parameter list.}}
	}}		}}

Line 165:		Line 165:
	\|{{HistoryLine\|\|26.20\|dev=Preview 26.20.26\|exp=Beta APIs\|Custom dimensions can now be created through a new scripting registry.}}		\|{{HistoryLine\|\|26.20\|dev=Preview 26.20.26\|exp=Beta APIs\|Custom dimensions can now be created through a new scripting registry.}}
	\|{{HistoryLine\|\|26.30\|dev=Preview 26.30.29\|Custom dimensions through scripting have moved to stable.}}		\|{{HistoryLine\|\|26.30\|dev=Preview 26.30.29\|Custom dimensions through scripting have moved to stable.}}
	~~\|{{HistoryLine\|upcoming Bedrock}}~~
	\|{{HistoryLine\|\|26.50\|dev=Preview 26.50.25\|Custom dimensions can now be modified through {{cd\|minecraft:dimension}}, however vanilla dimensions can no longer be modified.\|Added the {{cd\|minecraft:default_biome}} component to custom dimension JSON, allowing creators to configure the biome a custom dimension generates with, custom dimension heights can now be defined via JSON, with a limit of 384.}}		\|{{HistoryLine\|\|26.50\|dev=Preview 26.50.25\|Custom dimensions can now be modified through {{cd\|minecraft:dimension}}, however vanilla dimensions can no longer be modified.\|Added the {{cd\|minecraft:default_biome}} component to custom dimension JSON, allowing creators to configure the biome a custom dimension generates with, custom dimension heights can now be defined via JSON, with a limit of 384.}}
	\|{{HistoryLine\|\|\|dev=Preview 26.50.26\|Custom dimension heights defined in a dimension JSON file can once again span the full -512 to 512 block range instead of being capped to the default Overworld heights of -64 to 320.}}		\|{{HistoryLine\|\|\|dev=Preview 26.50.26\|Custom dimension heights defined in a dimension JSON file can once again span the full -512 to 512 block range instead of being capped to the default Overworld heights of -64 to 320.}}
			\|{{HistoryLine\|upcoming Bedrock}}
	\|{{HistoryLine\|\|26.60\|dev=Preview 26.60.21\|Added the {{cd\|minecraft:clouds}} component, letting custom dimensions configure the height at which clouds render. No component means clouds do not render.}}		\|{{HistoryLine\|\|26.60\|dev=Preview 26.60.21\|Added the {{cd\|minecraft:clouds}} component, letting custom dimensions configure the height at which clouds render. No component means clouds do not render.}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-09-15T11:07:24Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:07, 15 September 2026
Line 45:		Line 45:
	**** {{nbt\|compound\|minecraft:generation}}: ''Required.'' Defines how the dimension generates.		**** {{nbt\|compound\|minecraft:generation}}: ''Required.'' Defines how the dimension generates.
	***** {{nbt\|string\|generator_type}}: The generator type to use for this dimension. Currently only {{cd\|void}} is supported.		***** {{nbt\|string\|generator_type}}: The generator type to use for this dimension. Currently only {{cd\|void}} is supported.
			**** {{nbt\|compound\|minecraft:clouds}}: Defines determines if there will be [[Minecraft:clouds]] in the dimension.
			***** {{nbt\|string\|height}}: Determines the height at which the cloud will be in the dimension, it is not possible to set heights higher than the overworld height.
	</div>		</div>

Line 166:		Line 168:
	\|{{HistoryLine\|\|26.50\|dev=Preview 26.50.25\|Custom dimensions can now be modified through {{cd\|minecraft:dimension}}, however vanilla dimensions can no longer be modified.\|Added the {{cd\|minecraft:default_biome}} component to custom dimension JSON, allowing creators to configure the biome a custom dimension generates with, custom dimension heights can now be defined via JSON, with a limit of 384.}}		\|{{HistoryLine\|\|26.50\|dev=Preview 26.50.25\|Custom dimensions can now be modified through {{cd\|minecraft:dimension}}, however vanilla dimensions can no longer be modified.\|Added the {{cd\|minecraft:default_biome}} component to custom dimension JSON, allowing creators to configure the biome a custom dimension generates with, custom dimension heights can now be defined via JSON, with a limit of 384.}}
	\|{{HistoryLine\|\|\|dev=Preview 26.50.26\|Custom dimension heights defined in a dimension JSON file can once again span the full -512 to 512 block range instead of being capped to the default Overworld heights of -64 to 320.}}		\|{{HistoryLine\|\|\|dev=Preview 26.50.26\|Custom dimension heights defined in a dimension JSON file can once again span the full -512 to 512 block range instead of being capped to the default Overworld heights of -64 to 320.}}
			\|{{HistoryLine\|\|26.60\|dev=Preview 26.60.21\|Added the {{cd\|minecraft:clouds}} component, letting custom dimensions configure the height at which clouds render. No component means clouds do not render.}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-09-04T11:04:40Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:04, 4 September 2026
Line 121:		Line 121:
	\|-		\|-
	\| N/A		\| N/A
	\| {{BiomeLink\|The End}}		\| {{BiomeLink\|The End\|link=The End (biome)}}
	\|-		\|-
	\| e > {{frac\|1\|4}}		\| e > {{frac\|1\|4}}

SyncBot: Sync: updated from Minecraft

2026-08-25T11:15:22Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:15, 25 August 2026
Line 1:		Line 1:
	{{about\|data pack contents\|other uses\|Dimension}}		{{about\|data pack and behavior pack contents\|other uses\|Dimension}}
	~~{{Update\|Dimensions in Bedrock can now be configured via JSON; this page needs to contain it as well.~~}}
	[[File:Floating Islands custom dimension.png\|thumb\|300px\|A custom dimension using a [[dimension type\|custom type]], a fixed [[Minecraft:plains]] biome, and the <code>minecraft:floating_islands</code> [[Minecraft:noise settings]].]]		[[File:Floating Islands custom dimension.png\|thumb\|300px\|A custom dimension using a [[dimension type\|custom type]], a fixed [[Minecraft:plains]] biome, and the <code>minecraft:floating_islands</code> [[Minecraft:noise settings]].]]
	{{relevant tutorial\|Adding a new dimension}}		{{relevant tutorial\|Adding a new dimension}}
Line 14:		Line 13:

	Dimensions are stored as [[Minecraft:JSON]] files within a behavior pack, at the path <code><root BP>/dimension/<name>.json</code>.		Dimensions are stored as [[Minecraft:JSON]] files within a behavior pack, at the path <code><root BP>/dimension/<name>.json</code>.

			Dimensions can also be created by [[Minecraft:Script API\|scripts]] using the {{Cd\|StartupEvent.dimensionRegistry.registerCustomDimension(''<identifier>'')}} method, although this is not required. If the same dimension is created using both methods, it will be overridden by the behavior pack JSON definition, and a content warning will be logged.

	== JSON format ==		== JSON format ==
Line 31:		Line 32:

	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound}} The root ~~tag~~.		* {{nbt\|compound}}: The root object.
	** {{nbt\|string\|format_version}}: The format version of the file, requires <code>"1.26.50"</code> for all current features.		<!--** {{nbt\|string\|format_version}}: The format version of the file, requires <code>"1.26.50"</code> for all current features.-->
	** {{nbt\|compound\|minecraft:dimension}}: ~~The biome~~ definition.		** {{nbt\|compound\|minecraft:dimension}}: A dimension definition.
	*** {{nbt\|compound\|description}}		*** {{nbt\|compound\|description}}
	**** {{nbt\|string\|identifier}}: A [[Minecraft:namespaced identifier]] for the dimension.		**** {{nbt\|string\|identifier}}: A [[Minecraft:namespaced identifier]] for the dimension. If this matches the identifier of a dimension registered by script, this definition will take priority.
	*** {{nbt\|compound\|components}}: Components used ~~to define~~ the dimension~~'s generation~~.		*** {{nbt\|compound\|components}}: Components that define the properties of the dimension.
			**** {{nbt\|compound\|minecraft:default_biome}}: Defines the default biome used in the dimension.
			***** {{nbt\|string\|biome}}: The identifier of the biome to make default.
	**** {{nbt\|compound\|minecraft:dimension_height}}: Defines the height range of the dimension.		**** {{nbt\|compound\|minecraft:dimension_height}}: Defines the height range of the dimension.
	***** {{nbt\|~~float~~\|min_y}}: The y ~~level that is the bottom~~ of the dimension. ~~This must~~ be a ~~multiple of 16~~.		***** {{nbt\|int\|min_y}}: The bottom y-value of the dimension. Must be a number between -512 and 512.
	***** {{nbt\|~~float~~\|height_range}}: The height of the dimension ~~in blocks~~. ~~This is added on top of {{cd\|min_y}}~~. ~~Can~~ be a ~~max~~ of ~~1024~~.		***** {{nbt\|int\|height_range}}: The height range (distance between the bottom and top of the dimension). Must be a number between 16 and 1024. Must be a multiple of 16. The sum of {{cd\|min_y}} and this value must not be greater than 512.
	**** {{nbt\|compound\|minecraft:default_biome}}: Defines the default biome of ~~the dimension.~~		**** {{nbt\|compound\|minecraft:generation}}: ''Required.'' Defines how the dimension generates.
	~~*****~~ {{~~nbt~~\|~~string\|biome~~}}~~: A biome identifier~~.		***** {{nbt\|string\|generator_type}}: The generator type to use for this dimension. Currently only {{cd\|void}} is supported.
	**** {{nbt\|compound\|minecraft:generation}}: Defines ~~the generation of~~ the dimension.
	***** {{nbt\|string\|generator_type}}: A generator type. ~~Can~~ only be {{cd\|void}}.
	</div>		</div>

SyncBot: Sync: updated from Minecraft

2026-08-22T11:04:18Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:04, 22 August 2026
Line 3:		Line 3:
	[[File:Floating Islands custom dimension.png\|thumb\|300px\|A custom dimension using a [[dimension type\|custom type]], a fixed [[Minecraft:plains]] biome, and the <code>minecraft:floating_islands</code> [[Minecraft:noise settings]].]]		[[File:Floating Islands custom dimension.png\|thumb\|300px\|A custom dimension using a [[dimension type\|custom type]], a fixed [[Minecraft:plains]] biome, and the <code>minecraft:floating_islands</code> [[Minecraft:noise settings]].]]
	{{relevant tutorial\|Adding a new dimension}}		{{relevant tutorial\|Adding a new dimension}}
	'''Dimensions''' are [[Minecraft:JSON]] files located in [[Minecraft:data pack]]s ~~that~~ define dimensions for the game. New dimensions added can be accessed by using commands, like {{cmd\|/execute in <dimension> run teleport <coordinates>}}.		'''Dimensions''' are [[Minecraft:JSON]] files located in [[Minecraft:data pack]]s {{in\|java}} and in [[Minecraft:behavior pack]]s {{in\|bedrock}}. They define new dimensions for the game. New dimensions added can be accessed by using commands, like {{cmd\|/execute in <dimension> run teleport <coordinates>}}.

	== Usage ==		== Usage ==

			=== ''Java Edition'' ===

	Dimensions are stored as [[Minecraft:JSON]] files within a data pack, at the path <code>data/<namespace>/dimension/<name>.json</code>. Alternatively, a [[Minecraft: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.		Dimensions are stored as [[Minecraft:JSON]] files within a data pack, at the path <code>data/<namespace>/dimension/<name>.json</code>. Alternatively, a [[Minecraft: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.

			=== ''Bedrock Edition'' ===

			Dimensions are stored as [[Minecraft:JSON]] files within a behavior pack, at the path <code><root BP>/dimension/<name>.json</code>.

	== JSON format ==		== JSON format ==

			=== ''Java Edition'' ===

	<div class="treeview">		<div class="treeview">
	When stored as separate dimensions, they follow the following syntax:		When stored as separate dimensions, they follow the following syntax:
Line 16:		Line 26:
	*** {{nbt\|string\|type}}: The [[#Generator types\|generator]] type as [[Minecraft:resource location]]. One of <code>noise</code>, <code>flat</code>, or <code>debug</code>.		*** {{nbt\|string\|type}}: The [[#Generator types\|generator]] type as [[Minecraft:resource location]]. One of <code>noise</code>, <code>flat</code>, or <code>debug</code>.
	*** Additional fields of the generator, described below.		*** Additional fields of the generator, described below.
			</div>

			=== ''Bedrock Edition'' ===

			<div class="treeview">
			* {{nbt\|compound}} The root tag.
			** {{nbt\|string\|format_version}}: The format version of the file, requires <code>"1.26.50"</code> for all current features.
			** {{nbt\|compound\|minecraft:dimension}}: The biome definition.
			*** {{nbt\|compound\|description}}
			**** {{nbt\|string\|identifier}}: A [[Minecraft:namespaced identifier]] for the dimension.
			*** {{nbt\|compound\|components}}: Components used to define the dimension's generation.
			**** {{nbt\|compound\|minecraft:dimension_height}}: Defines the height range of the dimension.
			***** {{nbt\|float\|min_y}}: The y level that is the bottom of the dimension. This must be a multiple of 16.
			***** {{nbt\|float\|height_range}}: The height of the dimension in blocks. This is added on top of {{cd\|min_y}}. Can be a max of 1024.
			**** {{nbt\|compound\|minecraft:default_biome}}: Defines the default biome of the dimension.
			***** {{nbt\|string\|biome}}: A biome identifier.
			**** {{nbt\|compound\|minecraft:generation}}: Defines the generation of the dimension.
			***** {{nbt\|string\|generator_type}}: A generator type. Can only be {{cd\|void}}.
	</div>		</div>

	== Generator types ==		== Generator types ==

			=== void ===
			{{exclusive\|bedrock\|section=1}}
			Has no terrain generation. This generator has no additional fields.

	=== debug ===		=== debug ===
			{{exclusive\|java\|section=1}}
	The generator type used when selecting [[Minecraft:debug mode]] in the world creation menu. This generator has no additional fields.		The generator type used when selecting [[Minecraft:debug mode]] in the world creation menu. This generator has no additional fields.

	=== flat ===		=== flat ===
			{{exclusive\|java\|section=1}}
	The generator type used for [[Minecraft:superflat]] worlds.		The generator type used for [[Minecraft:superflat]] worlds.
	<div class="treeview">		<div class="treeview">
Line 32:		Line 66:

	=== noise ===		=== noise ===
			{{exclusive\|java\|section=1}}
	The generator used in all the default [[Minecraft:dimension]]s.		The generator used in all the default [[Minecraft:dimension]]s.
	<div class="treeview">		<div class="treeview">
Line 42:		Line 77:

	== Biome sources ==		== Biome sources ==
			{{exclusive\|java\|section=1}}

	=== checkerboard ===		=== checkerboard ===
Line 100:		Line 136:

	== Multi noise parameter list ==		== Multi noise parameter list ==
			{{exclusive\|java\|section=1}}
	A multi-noise biome source parameter list is stored as [[Minecraft:JSON]] files within a data pack, at the path <code>data/<namespace>/worldgen/multi_noise_biome_source_parameter_list/<name>.json</code>. It is used to avoid changing world preset files when adding new biomes to experimental data packs.		A multi-noise biome source parameter list is stored as [[Minecraft:JSON]] files within a data pack, at the path <code>data/<namespace>/worldgen/multi_noise_biome_source_parameter_list/<name>.json</code>. It is used to avoid changing world preset files when adding new biomes to experimental data packs.

← Older revision		Revision as of 11:08, 4 October 2026
Line 1:		Line 1:
	{{about\|data pack and behavior pack contents\|other uses\|Dimension}}		{{about\|data pack and behavior pack contents\|other uses\|Dimension}}
			{{Split\|Dimension definition (Java Edition)\| Dimension definition (Bedrock Edition)\|reason=There are few similarities between the versions.}}

	[[File:Floating Islands custom dimension.png\|thumb\|300px\|A custom dimension using a [[dimension type\|custom type]], a fixed [[Minecraft:plains]] biome, and the <code>minecraft:floating_islands</code> [[Minecraft:noise settings]]]]		[[File:Floating Islands custom dimension.png\|thumb\|300px\|A custom dimension using a [[dimension type\|custom type]], a fixed [[Minecraft:plains]] biome, and the <code>minecraft:floating_islands</code> [[Minecraft:noise settings]]]]
	{{relevant tutorial\|Adding a new dimension}}		{{relevant tutorial\|Adding a new dimension}}

← Older revision		Revision as of 11:09, 24 September 2026
Line 40:		Line 40:
	**** {{nbt\|string\|identifier}}: A [[Minecraft:namespaced identifier]] for the dimension. If this matches the identifier of a dimension registered by script, this definition will take priority.		**** {{nbt\|string\|identifier}}: A [[Minecraft:namespaced identifier]] for the dimension. If this matches the identifier of a dimension registered by script, this definition will take priority.
	*** {{nbt\|compound\|components}}: Components that define the properties of the dimension.		*** {{nbt\|compound\|components}}: Components that define the properties of the dimension.
	**** {{nbt\|compound\|minecraft:clouds}}: Defines if and where [[Minecraft:cloud]]s will be in the dimension. Omitting this component will result in the dimension not having clouds.		**** {{nbt\|compound\|minecraft:clouds}}:{{upcoming\|26.60}} Defines if and where [[Minecraft:cloud]]s will be in the dimension. Omitting this component will result in the dimension not having clouds.
	***** {{nbt\|int\|height}}: Determines the height at which clouds will appear in the dimension. Must be a number between -64 and ~~320~~.		***** {{nbt\|int\|height}}: Determines the height at which clouds will appear in the dimension. Must be a number between -512 and 512.
	**** {{nbt\|compound\|minecraft:default_biome}}: Defines the default biome used in the dimension.		**** {{nbt\|compound\|minecraft:default_biome}}: Defines the default biome used in the dimension.
	***** {{nbt\|string\|biome}}: The identifier of the biome to make default.		***** {{nbt\|string\|biome}}: The identifier of the biome to make default.
Line 172:		Line 172:
	\|{{HistoryLine\|upcoming Bedrock}}		\|{{HistoryLine\|upcoming Bedrock}}
	\|{{HistoryLine\|\|26.60\|dev=Preview 26.60.21\|Added the {{cd\|minecraft:clouds}} component, letting custom dimensions configure the height at which clouds render. No component means clouds do not render.}}		\|{{HistoryLine\|\|26.60\|dev=Preview 26.60.21\|Added the {{cd\|minecraft:clouds}} component, letting custom dimensions configure the height at which clouds render. No component means clouds do not render.}}
			\|{{HistoryLine\|\|\|dev=Preview 26.60.28\|Clouds can now be set between -512 and 512 instead of -64 and 320.}}
	}}		}}

← Older revision		Revision as of 11:14, 18 September 2026
Line 38:		Line 38:
	**** {{nbt\|string\|identifier}}: A [[Minecraft:namespaced identifier]] for the dimension. If this matches the identifier of a dimension registered by script, this definition will take priority.		**** {{nbt\|string\|identifier}}: A [[Minecraft:namespaced identifier]] for the dimension. If this matches the identifier of a dimension registered by script, this definition will take priority.
	*** {{nbt\|compound\|components}}: Components that define the properties of the dimension.		*** {{nbt\|compound\|components}}: Components that define the properties of the dimension.
			**** {{nbt\|compound\|minecraft:clouds}}: Defines if and where [[Minecraft:cloud]]s will be in the dimension. Omitting this component will result in the dimension not having clouds.
			***** {{nbt\|int\|height}}: Determines the height at which clouds will appear in the dimension. Must be a number between -64 and 320.
	**** {{nbt\|compound\|minecraft:default_biome}}: Defines the default biome used in the dimension.		**** {{nbt\|compound\|minecraft:default_biome}}: Defines the default biome used in the dimension.
	***** {{nbt\|string\|biome}}: The identifier of the biome to make default.		***** {{nbt\|string\|biome}}: The identifier of the biome to make default.
Line 45:		Line 47:
	**** {{nbt\|compound\|minecraft:generation}}: ''Required.'' Defines how the dimension generates.		**** {{nbt\|compound\|minecraft:generation}}: ''Required.'' Defines how the dimension generates.
	***** {{nbt\|string\|generator_type}}: The generator type to use for this dimension. Currently only {{cd\|void}} is supported.		***** {{nbt\|string\|generator_type}}: The generator type to use for this dimension. Currently only {{cd\|void}} is supported.
	**** {{nbt\|compound\|minecraft:clouds}}: Defines determines if there will be [[Minecraft:clouds]] in the dimension.
	***** {{nbt\|string\|height}}: Determines the height at which the cloud will be in the dimension, it is not possible to set heights higher than the overworld height.
	</div>		</div>

← Older revision		Revision as of 11:17, 16 September 2026
Line 156:		Line 156:
	\|{{HistoryLine\|\|1.19\|dev=22w11a\|Removed the <code>seed</code> field in <code>noise</code> generator and <code>the_end</code> biome source, and the world seed is now always used for all dimensions.		\|{{HistoryLine\|\|1.19\|dev=22w11a\|Removed the <code>seed</code> field in <code>noise</code> generator and <code>the_end</code> biome source, and the world seed is now always used for all dimensions.
	\|[[Minecraft:Dimension type]]s can no longer be inlined in the dimension, they have to be a reference to a separate dimension_type file.}}		\|[[Minecraft: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.}}		\|{{HistoryLine\|\|1.19.4\|dev=pre1\|Added multi-noise biome source parameter list.}}
	}}		}}

Line 165:		Line 165:
	\|{{HistoryLine\|\|26.20\|dev=Preview 26.20.26\|exp=Beta APIs\|Custom dimensions can now be created through a new scripting registry.}}		\|{{HistoryLine\|\|26.20\|dev=Preview 26.20.26\|exp=Beta APIs\|Custom dimensions can now be created through a new scripting registry.}}
	\|{{HistoryLine\|\|26.30\|dev=Preview 26.30.29\|Custom dimensions through scripting have moved to stable.}}		\|{{HistoryLine\|\|26.30\|dev=Preview 26.30.29\|Custom dimensions through scripting have moved to stable.}}
	~~\|{{HistoryLine\|upcoming Bedrock}}~~
	\|{{HistoryLine\|\|26.50\|dev=Preview 26.50.25\|Custom dimensions can now be modified through {{cd\|minecraft:dimension}}, however vanilla dimensions can no longer be modified.\|Added the {{cd\|minecraft:default_biome}} component to custom dimension JSON, allowing creators to configure the biome a custom dimension generates with, custom dimension heights can now be defined via JSON, with a limit of 384.}}		\|{{HistoryLine\|\|26.50\|dev=Preview 26.50.25\|Custom dimensions can now be modified through {{cd\|minecraft:dimension}}, however vanilla dimensions can no longer be modified.\|Added the {{cd\|minecraft:default_biome}} component to custom dimension JSON, allowing creators to configure the biome a custom dimension generates with, custom dimension heights can now be defined via JSON, with a limit of 384.}}
	\|{{HistoryLine\|\|\|dev=Preview 26.50.26\|Custom dimension heights defined in a dimension JSON file can once again span the full -512 to 512 block range instead of being capped to the default Overworld heights of -64 to 320.}}		\|{{HistoryLine\|\|\|dev=Preview 26.50.26\|Custom dimension heights defined in a dimension JSON file can once again span the full -512 to 512 block range instead of being capped to the default Overworld heights of -64 to 320.}}
			\|{{HistoryLine\|upcoming Bedrock}}
	\|{{HistoryLine\|\|26.60\|dev=Preview 26.60.21\|Added the {{cd\|minecraft:clouds}} component, letting custom dimensions configure the height at which clouds render. No component means clouds do not render.}}		\|{{HistoryLine\|\|26.60\|dev=Preview 26.60.21\|Added the {{cd\|minecraft:clouds}} component, letting custom dimensions configure the height at which clouds render. No component means clouds do not render.}}
	}}		}}

← Older revision		Revision as of 11:07, 15 September 2026
Line 45:		Line 45:
	**** {{nbt\|compound\|minecraft:generation}}: ''Required.'' Defines how the dimension generates.		**** {{nbt\|compound\|minecraft:generation}}: ''Required.'' Defines how the dimension generates.
	***** {{nbt\|string\|generator_type}}: The generator type to use for this dimension. Currently only {{cd\|void}} is supported.		***** {{nbt\|string\|generator_type}}: The generator type to use for this dimension. Currently only {{cd\|void}} is supported.
			**** {{nbt\|compound\|minecraft:clouds}}: Defines determines if there will be [[Minecraft:clouds]] in the dimension.
			***** {{nbt\|string\|height}}: Determines the height at which the cloud will be in the dimension, it is not possible to set heights higher than the overworld height.
	</div>		</div>

Line 166:		Line 168:
	\|{{HistoryLine\|\|26.50\|dev=Preview 26.50.25\|Custom dimensions can now be modified through {{cd\|minecraft:dimension}}, however vanilla dimensions can no longer be modified.\|Added the {{cd\|minecraft:default_biome}} component to custom dimension JSON, allowing creators to configure the biome a custom dimension generates with, custom dimension heights can now be defined via JSON, with a limit of 384.}}		\|{{HistoryLine\|\|26.50\|dev=Preview 26.50.25\|Custom dimensions can now be modified through {{cd\|minecraft:dimension}}, however vanilla dimensions can no longer be modified.\|Added the {{cd\|minecraft:default_biome}} component to custom dimension JSON, allowing creators to configure the biome a custom dimension generates with, custom dimension heights can now be defined via JSON, with a limit of 384.}}
	\|{{HistoryLine\|\|\|dev=Preview 26.50.26\|Custom dimension heights defined in a dimension JSON file can once again span the full -512 to 512 block range instead of being capped to the default Overworld heights of -64 to 320.}}		\|{{HistoryLine\|\|\|dev=Preview 26.50.26\|Custom dimension heights defined in a dimension JSON file can once again span the full -512 to 512 block range instead of being capped to the default Overworld heights of -64 to 320.}}
			\|{{HistoryLine\|\|26.60\|dev=Preview 26.60.21\|Added the {{cd\|minecraft:clouds}} component, letting custom dimensions configure the height at which clouds render. No component means clouds do not render.}}
	}}		}}