Dimension types are technical JSON files within a data pack, in the folder data/<namespace>/dimension_type. They define properties of a dimension such as world height build limits, the ambient light, and more.
JSON format
- [NBT Compound / JSON Object] The root object.
- [Boolean] ultrawarm: Whether the dimensions behaves like the nether (water evaporates and sponges dry) or not. Also lets stalactites drip lava and causes lava to spread faster and thinner.
- [Boolean] natural: When false, compasses spin randomly, and using a bed to set the respawn point or sleep, is disabled. When true, nether portals can spawn zombified piglins, and creaking hearts can spawn creakings.
- [Double] coordinate_scale: The multiplier applied to coordinates when leaving the dimension. Value between 0.00001 and 30000000.0 (both inclusive)。
- [Boolean] has_skylight: Whether the dimension has skylight or not.
- [Boolean] has_ceiling: Whether the dimension has a bedrock ceiling. Note that this is only a logical ceiling. It is unrelated with whether the dimension really has a block ceiling.
- [Float] ambient_light: How much light the dimension has. When set to 0, it completely follows the light level; when set to 1, there is no ambient lighting.
- [Long] fixed_time: (optional) If this is set to an int, the time of the day is the specified value. To ensure a normal time cycle, leave the attribute undefined (i.e, do not include it).
- [Int][NBT Compound / JSON Object] monster_spawn_light_level: Value between 0 and 15 (both inclusive). Maximum light required when the monster spawns. The formula of this light is:
max( skyLight - 10, blockLight ) during thunderstorms, and max( internalSkyLight, blockLight ) during other weather.
- [Int] monster_spawn_block_light_limit: Value between 0 and 15 (both inclusive). Maximum block light required when the monster spawns.
- [Boolean] piglin_safe: When false, Piglins and hoglins shake and transform to zombified entities.
- [Boolean] bed_works: When false, the bed blows up when trying to sleep.
- [Boolean] respawn_anchor_works: When false, the respawn anchor blows up when trying to set spawn point.
- [Boolean] has_raids: Whether players with the Bad Omen effect can cause a raid.
- [Int] logical_height: The maximum height to which chorus fruits and nether portals can bring players within this dimension. This excludes portals that were already built above the limit as they still connect normally. Cannot be greater than [Int] height.
- [Int] cloud_height:Optional value between -2032 and 2031. If set, determines the lower edge of the clouds. If unset, clouds are disabled in the dimension.
- [Int] min_y: The minimum height in which blocks can exist within this dimension. Must be between -2032 and 2031 and be a multiple of 16 (effectively making 2016 the maximum).
- [Int] height: The total height in which blocks can exist within this dimension. Must be between 16 and 4064 and be a multiple of 16. The maximum building height = min_y + height - 1, which cannot be greater than 2031.
- [String] infiniburn: A block tag with
#. Fires on these blocks burns infinitely.
- [String] effects: (optional, defaults to
minecraft:overworld) Can be "minecraft:overworld", "minecraft:the_nether" and "minecraft:the_end". Determines the dimension effect used for this dimension. Setting to overworld makes the dimension have sun, stars, moon, and increased fog during rain. Setting to the nether makes the dimension have thick fog blocking that sight, similar to the nether. Setting to the end makes the dimension have dark spotted sky similar to the end, ignoring the sky and fog color.
Defaults
These are the settings used by the 3 dimensions present in Vanilla and the additional Overworld Caves settings provided by Minecraft.
| Property
|
Overworld
|
The Nether
|
The End
|
Overworld Caves
|
| [Boolean] ultrawarm
|
False
|
True
|
False
|
False
|
| [Boolean] natural
|
True
|
False
|
False
|
True
|
| [Boolean] piglin_safe
|
False
|
True
|
False
|
False
|
| [Boolean] respawn_anchor_works
|
False
|
True
|
False
|
False
|
| [Boolean] bed_works
|
True
|
False
|
False
|
True
|
| [Boolean] has_raids
|
True
|
False
|
True
|
True
|
| [Boolean] has_skylight
|
True
|
False
|
False
|
True
|
| [Boolean] has_ceiling
|
False
|
True
|
False
|
True
|
| [Double] coordinate_scale
|
1.0
|
8.0
|
1.0
|
1.0
|
| [Long] fixed_time
|
Undefined
|
18000
|
6000
|
Undefined
|
| [Float] ambient_light
|
0.0
|
0.1
|
0.0
|
0.0
|
| [Int] min_y
|
-64
|
0
|
0
|
-64
|
| [Int] height
|
384
|
256
|
256
|
384
|
| [Int] logical_height
|
384
|
128
|
256
|
384
|
| [Int] cloud_height
|
192
|
Undefined
|
Undefined
|
192
|
| [Int][NBT Compound / JSON Object] monster_spawn_light_level
|
0-7
|
7
|
0-7
|
0-7
|
| [Int] monster_spawn_block_light_limit
|
0
|
15
|
0
|
0
|
| [String] infiniburn
|
#infiniburn_overworld
|
#infiniburn_nether
|
#infiniburn_end
|
#infiniburn_overworld
|
| [String] effects
|
overworld
|
the_nether
|
the_end
|
overworld
|
History
| Java Edition |
|---|
| 1.16 | Pre-release 1 | Added dimension types to data packs. |
|---|
| 1.16.2 | pre1 | Dimension types now use the same folder pattern in data packs as other resources: namespace/<type>/resource.json. |
|---|
| pre2 | Replaced the field [Boolean] shrunk with [Float] coordinate_scale. |
|---|
| 1.17 | 20w49a | Added [Int] min_y and [Int] height. |
|---|
| 1.18.2 | 22w06a | infiniburn's defined tag must be preceded by a # symbol; this was previously optional. |
|---|
| 1.19 | 22w11a | Dimension types can no longer be inlined in the dimension, they have to be a reference to a separate dimension_type file. |
|---|
| pre1 | Added [Int] monster_spawn_block_light_limit and [Int][NBT Compound / JSON Object] monster_spawn_light_level to the dimension type. |
|---|
| 1.21.6 | 25w15a | Added [Int] cloud_height to the dimension type, replacing clouds from being controlled by [String] effects. |
|---|
External links
Navigation
