SyncBot: Sync: new page from Minecraft

2026-10-04T11:08:38Z

Sync: new page from Minecraft

New page

#Redirect [[Minecraft:Dimension definition]]
{{Wip}}
{{Exclusive|Bedrock}}
[[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}}
'''Dimensions''' are [[Minecraft:JSON]] files located in in [[Minecraft:behavior pack]]s. 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 ==
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 ==
<div class="treeview">
* {{nbt|compound}}: The root object.

** {{nbt|compound|minecraft:dimension}}: A dimension definition.
*** {{nbt|compound|description}}
**** {{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|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 -512 and 512.
**** {{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|int|min_y}}: The bottom y-value of the dimension. Must be a number between -512 and 512.
***** {{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: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.
</div>

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

== History ==
{{HistoryTable
|{{HistoryLine|Bedrock}}
|{{HistoryLine||?|The Overworld's build limit can now be modified through {{cd|minecraft:dimension}} entries in [[Minecraft:add-on]]s. Custom dimensions cannot be added through this method.}}
|{{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.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|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|||dev=Preview 26.60.28|Clouds can now be set between -512 and 512 instead of -64 and 320.}}
}}

== External links ==
* [https://misode.github.io/dimension/ Dimension Generator on misode.github.io]

== Navigation ==
{{No navbox}}

[[Category:Dimensions]]

[[Minecraft:de:Dimensionsdefinition]]
[[Minecraft:fr:Définition de dimension]]
[[Minecraft:ja:カスタムディメンション]]
[[Minecraft:pt:Definição de dimensão]]
[[Minecraft:zh:维度定义格式]]

Minecraft:Dimension definition (Bedrock Edition) - Revision history

SyncBot: Sync: new page from Minecraft