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)
Remove broken links to missing pages
SyncBot (talk | contribs)
Sync: updated from Minecraft
 
(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}}
{{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}}
[[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}}
{{relevant tutorial|Adding a new dimension}}
'''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 {{cmd|/execute in <dimension> run teleport <coordinates>}}.
'''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 ==
Line 14: Line 15:
** {{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
** {{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
** {{nbt|compound|generator}}: Generation settings used for that dimension.
** {{nbt|compound|generator}}: Generation settings used for that dimension.
*** {{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:
Line 37: Line 38:
** {{Nbt|string}}{{Nbt|compound|settings}}: {{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.
** {{nbt|compound|biome_source}}: Settings determining the biome layout.
** {{nbt|compound|biome_source}}: Settings determining the biome layout.
*** {{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 52: Line 53:


=== 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:
Line 84: Line 85:
{{HistoryTable
{{HistoryTable
|{{HistoryLine|java}}
|{{HistoryLine|java}}
|{{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.}}
|{{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.}}
|{{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>.}}
|{{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.}}
|{{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 100: Line 101:
[[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:维度定义格式