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
SyncBot (talk | contribs)
Fix template calls: add MC/ prefix
SyncBot (talk | contribs)
Sync: updated from Minecraft
 
Line 1: Line 1:
{{about|data pack contents|other uses|Dimension}}
{{about|data pack contents|other uses|Dimension}}
{{MC/Exclusive|java}}
{{exclusive|java}}
[[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.]]
{{update|1=dimension format changes in 26.3}}
{{MC/Relevant tutorial|Adding a new 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]].]]
'''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>}}.
{{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>}}.


== 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 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.


== 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:
* {{MC/Nbt|compound}} The root tag.
* {{nbt|compound}} The root tag.
** {{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|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|compound|generator}}: Generation settings used for that dimension.
** {{nbt|compound|generator}}: Generation settings used for that dimension.
*** {{MC/Nbt|string|type}}: The [[#Generator types|generator]] type as 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>
</div>
Line 21: Line 22:


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


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


Line 61: Line 62:
<div class="treeview">
<div class="treeview">
* Additional fields:
* Additional fields:
** {{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>.
** {{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:
** {{MC/Nbt|list|biomes}}: List of biome parameters points. Needs at least one entry. Biomes can appear in more than one parameter point.
** {{nbt|list|biomes}}: List of biome parameters points. Needs at least one entry. Biomes can appear in more than one parameter point.
*** {{MC/Nbt|compound}}: A parameter point.
*** {{nbt|compound}}: A parameter point.
**** {{MC/Nbt|string|biome}}: {{MC/Json ref/biome}} &mdash; The biome used at this parameter point.
**** {{nbt|string|biome}}: {{json ref/biome}} &mdash; The biome used at this parameter point.
**** {{MC/Nbt|compound|parameters}}: The parameters of this entry
**** {{nbt|compound|parameters}}: The parameters of this entry
***** {{MC/Nbt inherit/parameter point}}
***** {{Nbt inherit/parameter point}}
</div>
</div>


Line 78: Line 79:
The syntax is as follows:
The syntax is as follows:
<div class="treeview">
<div class="treeview">
** {{MC/Nbt|string|preset}}: A reference to a hardcoded parameter list preset. The available presets are <code>overworld</code> and <code>nether</code>.
** {{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
|{{MC/HistoryLine|java}}
|{{HistoryLine|java}}
|{{MC/HistoryLine||1.16|dev=Pre-release 1|Added dimensions to data packs.}}
|{{HistoryLine||1.16|dev=Pre-release 1|Added dimensions to [[Minecraft:data pack]]s.}}
|{{MC/HistoryLine||1.16.2|dev=20w29a|The noise settings for custom dimensions can now also be stored in separate files.}}
|{{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|||dev=pre1|Custom dimensions now use the same folder pattern in data packs as other resources: <samp>namespace/<''type''>/resource.json</samp>.}}
|{{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||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.
|Dimension types 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.}}
|{{MC/HistoryLine||1.19.4|dev=1.19.4-pre1|Added multi-noise biome source parameter list.}}
|{{HistoryLine||1.19.4|dev=1.19.4-pre1|Added multi-noise biome source parameter list.}}
}}
}}


Line 96: Line 97:


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


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


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

Latest revision as of 12:23, 21 July 2026

Template:Exclusive Template:Update

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

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

Usage

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

JSON format

When stored as separate dimensions, they follow the following syntax:

Generator types

debug

The generator type used when selecting Minecraft:debug mode in the world creation menu. This generator has no additional fields.

flat

The generator type used for Minecraft: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 Minecraft: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: A reference to a hardcoded parameter list preset. The available presets are overworld and nether.

History

Template:HistoryTable

External links

Navigation

Template:Navbox Java Edition technical

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