Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Minecraft:Dimension definition: Difference between revisions

From SAS Gaming Wiki
imported>ProBot
 
SyncBot (talk | contribs)
Fix template calls: add MC/ prefix
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
{{about|data pack contents|other uses|Dimension}}
{{about|data pack contents|other uses|Dimension}}
{{exclusive|java}}
{{MC/Exclusive|java}}
[[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 plains biome, and the <code>minecraft:floating_islands</code> noise settings.]]
{{relevant tutorial|Adding a new dimension}}
{{MC/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 data packs that define dimensions for the game. New dimensions added can be accessed by using commands, like {{MC/Cmd|/execute in <dimension> run teleport <coordinates>}}.


== Usage ==
== Usage ==
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 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 ==
== JSON format ==
<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:
* {{nbt|compound}} The root tag.
* {{MC/Nbt|compound}} The root tag.
** {{nbt|string|type}}: {{json ref|dimension type}}. Can be preset <code>overworld</code>, <code>the_nether</code>, <code>the_end</code>, <code>overworld_caves</code>, or a custom dimension type
** {{MC/Nbt|string|type}}: {{MC/Json ref|dimension type}}. Can be preset <code>overworld</code>, <code>the_nether</code>, <code>the_end</code>, <code>overworld_caves</code>, or a custom dimension type
** {{nbt|compound|generator}}: Generation settings used for that dimension.
** {{MC/Nbt|compound|generator}}: Generation settings used for that dimension.
*** {{nbt|string|type}}: The [[#Generator types|generator]] type as [[Minecraft:resource location]]. One of <code>noise</code>, <code>flat</code>, or <code>debug</code>.
*** {{MC/Nbt|string|type}}: The [[#Generator types|generator]] type as 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>
</div>
Line 21: Line 21:


=== debug ===
=== debug ===
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 debug mode in the world creation menu. This generator has no additional fields.


=== flat ===
=== flat ===
The generator type used for [[Minecraft:superflat]] worlds.
The generator type used for superflat worlds.
<div class="treeview">
<div class="treeview">
* Additional fields:
* Additional fields:
** {{Nbt|compound|settings}}: Superflat settings.
** {{MC/Nbt|compound|settings}}: Superflat settings.
*** {{nbt inherit/flat generator settings}}
*** {{MC/Nbt inherit/flat generator settings}}
</div>
</div>


Line 35: Line 35:
<div class="treeview">
<div class="treeview">
* Additional fields:
* Additional fields:
** {{Nbt|string}}{{Nbt|compound|settings}}: {{json ref|noise settings|inline=1}} &mdash; Settings for the noise generator.
** {{MC/Nbt|string}}{{MC/Nbt|compound|settings}}: {{MC/Json ref|noise settings|inline=1}} &mdash; Settings for the noise generator.
** {{nbt|compound|biome_source}}: Settings determining the biome layout.
** {{MC/Nbt|compound|biome_source}}: Settings determining the biome layout.
*** {{nbt|string|type}}: The [[#Biome sources|biome source]] type as a [[Minecraft:resource location]].
*** {{MC/Nbt|string|type}}: The [[#Biome sources|biome source]] type as a resource location.
*** Additional fields of the biome source, described below.
*** Additional fields of the biome source, described below.
</div>
</div>
Line 47: Line 47:
<div class="treeview">
<div class="treeview">
* Additional fields:
* Additional fields:
** {{nbt|string}}{{nbt|list|biomes}}: {{json ref/biome|tag=1}}
** {{MC/Nbt|string}}{{MC/Nbt|list|biomes}}: {{MC/Json ref/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.
** {{MC/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.
</div>
</div>


=== fixed ===
=== fixed ===
The fixed biome source, also called [[Minecraft:single biome]], uses one specified biome everywhere.
The fixed biome source, also called single biome, uses one specified biome everywhere.
<div class="treeview">
<div class="treeview">
* Additional fields:
* Additional fields:
** {{nbt|string|biome}}: {{json ref/biome}} &mdash; The single biome to use.
** {{MC/Nbt|string|biome}}: {{MC/Json ref/biome}} &mdash; The single biome to use.
</div>
</div>


Line 61: Line 61:
<div class="treeview">
<div class="treeview">
* Additional fields:
* Additional fields:
** {{nbt|string|preset}}: A reference to a [[#Multi noise parameter list|parameter list]]. The default parameter lists are <code>overworld</code> and <code>nether</code>.
** {{MC/Nbt|string|preset}}: A reference to a [[#Multi noise parameter list|parameter list]]. The default parameter lists are <code>overworld</code> and <code>nether</code>.
* Or:
* Or:
** {{nbt|list|biomes}}: List of biome parameters points. Needs at least one entry. Biomes can appear in more than one parameter point.
** {{MC/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.
*** {{MC/Nbt|compound}}: A parameter point.
**** {{nbt|string|biome}}: {{json ref/biome}} &mdash; The biome used at this parameter point.
**** {{MC/Nbt|string|biome}}: {{MC/Json ref/biome}} &mdash; The biome used at this parameter point.
**** {{nbt|compound|parameters}}: The parameters of this entry
**** {{MC/Nbt|compound|parameters}}: The parameters of this entry
***** {{Nbt inherit/parameter point}}
***** {{MC/Nbt inherit/parameter point}}
</div>
</div>


Line 78: Line 78:
The syntax is as follows:
The syntax is as follows:
<div class="treeview">
<div class="treeview">
** {{nbt|string|preset}}: A reference to a hardcoded parameter list preset. The available presets are <code>overworld</code> and <code>nether</code>.
** {{MC/Nbt|string|preset}}: A reference to a hardcoded parameter list preset. The available presets are <code>overworld</code> and <code>nether</code>.
</div>
</div>


== History ==
== History ==
{{HistoryTable
{{HistoryTable
|{{HistoryLine|java}}
|{{MC/HistoryLine|java}}
|{{HistoryLine||1.16|dev=Pre-release 1|Added dimensions to [[Minecraft:data pack]]s.}}
|{{MC/HistoryLine||1.16|dev=Pre-release 1|Added dimensions to data packs.}}
|{{HistoryLine||1.16.2|dev=20w29a|The [[Minecraft:Custom noise settings|noise settings]] for custom dimensions can now also be stored in separate files.}}
|{{MC/HistoryLine||1.16.2|dev=20w29a|The 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: <samp>namespace/<''type''>/resource.json</samp>.}}
|{{MC/HistoryLine|||dev=pre1|Custom dimensions now use the same folder pattern in data packs as other resources: <samp>namespace/<''type''>/resource.json</samp>.}}
|{{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.
|{{MC/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.}}
|Dimension types 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.}}
|{{MC/HistoryLine||1.19.4|dev=1.19.4-pre1|Added multi-noise biome source parameter list.}}
}}
}}


Line 96: Line 96:


== Navigation ==
== Navigation ==
{{Navbox Java Edition technical|datapack}}
{{MC/Navbox Java Edition technical|datapack}}


[[Category:Dimensions]]
[[Category:Dimensions]]


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

Latest revision as of 20:20, 9 April 2026

Script error: No such module "Exclusive".

File:Floating Islands custom dimension.png
A custom dimension using a custom type, a fixed plains biome, and the minecraft:floating_islands noise settings.

Template:Pointer box Dimensions are Minecraft:JSON files located in data packs that define dimensions for the game. New dimensions added can be accessed by using commands, like

  1. REDIRECT Template:Command

Template:Redr.

Usage

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

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.

noise

The generator used in all the default Minecraft:dimensions.

Biome sources

checkerboard

The checkerboard biome source places biomes in a checkerboard pattern.

fixed

The fixed biome source, also called single biome, uses one specified biome everywhere.

multi_noise

the_end

The biome source used for Minecraft:the End dimension. This biome source has no additional fields.

Multi noise parameter list

A multi-noise biome source parameter list is stored as Minecraft:JSON files within a data pack, at the path data/<namespace>/worldgen/multi_noise_biome_source_parameter_list/<name>.json. It is used to avoid changing world preset files when adding new biomes to experimental data packs.

The syntax is as follows:

    • Template:Nbt/sprite preset: A reference to a hardcoded parameter list preset. The available presets are overworld and nether.

History

Template:HistoryTable

External links

Navigation

Concepts
General format
World
Legacy
Level format
Legacy
.minecraft
Tools
Sound
Commands

All commands

Launching
Legacy
Protocol
Server
Protocols
Legacy
Components
Tag
GameTest
World generation
Noise settings
Structures
Removed
Data packs
Tutorials
Content
World generation

Template:Article other

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