Dimension type

From Minecraft Wiki
Jump to navigation Jump to search
This feature is exclusive to Java Edition.
 

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

[edit | edit source]
  • [NBT Compound / JSON Object] The root object.
    • [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. If set to false, weather is additionally disabled.
    • [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. If set to true, there is no weather, the way respawn and mob spawning positions are calculated is changed, and maps record terrain within a 32 block radius around the player, instead of 64 – however, no data is actually recorded, and instead a pattern will be displayed.
    • [Boolean] has_ender_dragon_fight​[upcoming JE 26.1]: Whether this dimension can have an ender dragon fight. ​[more information needed]
    • [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.​[more information needed]
    • [Boolean] has_fixed_time: (optional, defaults to false) Whether this dimension has fixed time. ​[more information needed]
    • [Int] monster_spawn_block_light_limit: A single integer from 0 to 15. Block light level must be less than or equal to this value for monsters to spawn.
    • [Int][NBT Compound / JSON Object] monster_spawn_light_level: An integer or int provider from 0 to 15. Each time a monster spawn is attempted, a value is calculated using this int provider. The result of the following formula must be less than or equal to this value for monsters to spawn: max( skyLight - 10, blockLight ) during thunderstorms, and max( internalSkyLight, blockLight ) during other weather.
    • [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] 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] skybox: (optional, defaults to overworld) The skybox to use. Can be none overworld end.
    • [String] cardinal_light: (optional, defaults to default) Direction of cardinal light affecting blocks. Can be default nether
    • [NBT Compound / JSON Object] attributes: Map of environment attributes that apply when in this dimension.
    • [String] default_clock​[upcoming JE 26.1]: One world clock (an [String] ID) to use as the default for this dimension. This clock will be used as default for the /time command, and the minecraft:wake_up_from_sleep and minecraft:roll_village_siege time markers of this clock will be used. If not specified, the dimension doesn't have a default clock.
    • [String][NBT List / JSON Array] timelines: Any number of timeline(s) (an [String] ID, or a [String] tag with #, or an [NBT List / JSON Array] array containing [String] IDs) that are active in this dimension.

Defaults

[edit | edit source]

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] has_skylight True False True True
[Boolean] has_ceiling False True False True
[Boolean] has_ender_dragon_fight​[upcoming JE 26.1] False False True False
[Double] coordinate_scale 1.0 8.0 1.0 1.0
[Boolean] has_fixed_time False True True False
[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][NBT Compound / JSON Object] monster_spawn_light_level 0-7 7 15 0-7
[Int] monster_spawn_block_light_limit 0 15 0 0
[String] infiniburn #infiniburn_overworld #infiniburn_nether #infiniburn_end #infiniburn_overworld
[String] skybox overworld none end overworld
[String] cardinal_light default nether default default
[String] default_clock​[upcoming JE 26.1] overworld N/A the_end overworld

History

[edit | edit source]
Java Edition
1.16Pre-release 1Added dimension types to data packs.
1.16.2pre1Dimension types now use the same folder pattern in data packs as other resources: namespace/<type>/resource.json.
pre2Replaced the field [Boolean] shrunk with [Double] coordinate_scale.
1.1720w49aAdded [Int] min_y and [Int] height.
1.18.222w06ainfiniburn's defined tag must be preceded by a # symbol; this was previously optional.
1.1922w11aDimension types can no longer be inlined in the dimension, they have to be a reference to a separate dimension_type file.
pre1Added [Int] monster_spawn_block_light_limit and [Int][NBT Compound / JSON Object] monster_spawn_light_level to the dimension type.
1.21.625w15aAdded [Int] cloud_height to the dimension type; cloud presence is no longer controlled by [String] effects and their height is no longer a fixed value.
1.21.1125w42aAdded new attributes field for dimensions to specify Environment Attributes.
Many fields have been migrated to environment attributes:
  • [Boolean] ultrawarm -> minecraft:gameplay/water_evaporates, minecraft:gameplay/fast_lava, visual/default_dripstone_particle
  • [Boolean] bed_works -> minecraft:gameplay/bed_rule
  • [Boolean] respawn_anchor_works -> minecraft:gameplay/respawn_anchor_works
  • [Int] cloud_height -> minecraft:visual/cloud_height
  • [Boolean] piglin_safe -> minecraft:gameplay/piglins_zombify
  • [Boolean] has_raids -> minecraft:gameplay/can_start_raid
The [Boolean] natural field no longer controls whether Nether portals spawn piglin, which was migrated to the minecraft:gameplay/nether_portal_spawns_piglin environment attribute.
25w45aAdded a new optional [String][NBT List / JSON Array] timelines field.
The remaining functionality of [Boolean] natural field has been migrated to the minecraft:gameplay/eyeblossom_open and minecraft:gameplay/creaking_active environment attributes.
The [String] effects field has been removed and replaced with the following new fields: [String] skybox and [String] cardinal_light.
The [Int] fixed_time field has been replaced by [Boolean] has_fixed_time.
Upcoming Java Edition
26.1snap3Added [String] default_clock field
snap6Added [Boolean] has_ender_dragon_fight field
[edit | edit source]
[edit | edit source]
Java Edition technical
Data pack
Components
Tag
GameTest
World generation
Noise settings
Structures
Removed
Data packs
Tutorials
Content
World generation
Retrieved from "https://minecraft.wiki/w/Dimension_type?oldid=3457295"