Minecraft:Dimension definition: Difference between revisions
More actions
Fix template calls: add MC/ prefix |
Sync: updated from Minecraft |
||
| Line 1: | Line 1: | ||
{{about|data pack contents|other uses|Dimension}} | {{about|data pack contents|other uses|Dimension}} | ||
{{ | {{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]].]] | ||
'''Dimensions''' are [[Minecraft:JSON]] files located in data | {{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: | ||
* {{ | * {{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 | ||
** {{ | ** {{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>. | ||
*** 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: | ||
** {{ | ** {{Nbt|compound|settings}}: Superflat settings. | ||
*** {{ | *** {{nbt inherit/flat generator settings}} | ||
</div> | </div> | ||
| Line 35: | Line 36: | ||
<div class="treeview"> | <div class="treeview"> | ||
* Additional fields: | * Additional fields: | ||
** {{ | ** {{Nbt|string}}{{Nbt|compound|settings}}: {{json ref|noise settings|inline=1}} — Settings for the noise generator. | ||
** {{ | ** {{nbt|compound|biome_source}}: Settings determining the biome layout. | ||
*** {{ | *** {{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: | ||
** {{ | ** {{nbt|string}}{{nbt|list|biomes}}: {{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. | ||
</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: | ||
** {{ | ** {{nbt|string|biome}}: {{json ref/biome}} — The single biome to use. | ||
</div> | </div> | ||
| Line 61: | Line 62: | ||
<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>. | ||
* Or: | * Or: | ||
** {{ | ** {{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. | ||
**** {{ | **** {{nbt|string|biome}}: {{json ref/biome}} — The biome used at this parameter point. | ||
**** {{ | **** {{nbt|compound|parameters}}: The parameters of this entry | ||
***** {{ | ***** {{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"> | ||
** {{ | ** {{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}} | ||
|{{ | |{{HistoryLine||1.16|dev=Pre-release 1|Added dimensions to [[Minecraft:data pack]]s.}} | ||
|{{ | |{{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||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 | |[[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.}} | ||
}} | }} | ||
| Line 96: | Line 97: | ||
== Navigation == | == Navigation == | ||
{{ | {{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
|
For the {{{Description}}} of the same name, see [[{{{Destination}}}]]. |
Template:Exclusive Template:Update
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:
- Template:Nbt The root tag.
- Template:Nbt: Template:Json ref. Can be preset
overworld,the_nether,the_end,overworld_caves, or a custom dimension type - Template:Nbt: Generation settings used for that dimension.
- Template:Nbt: The generator type as Minecraft:resource location. One of
noise,flat, ordebug. - Additional fields of the generator, described below.
- Template:Nbt: The generator type as Minecraft:resource location. One of
- Template:Nbt: Template:Json ref. Can be preset
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.
- Additional fields:
- Template:Nbt: Superflat settings.
noise
The generator used in all the default Minecraft:dimensions.
- Additional fields:
- Template:NbtTemplate:Nbt: Template:Json ref — Settings for the noise generator.
- Template:Nbt: Settings determining the biome layout.
- Template:Nbt: The biome source type as a Minecraft:resource location.
- Additional fields of the biome source, described below.
Biome sources
checkerboard
The checkerboard biome source places biomes in a checkerboard pattern.
- Additional fields:
- Template:NbtTemplate:Nbt: Template:Json ref/biome
- Template:Nbt: 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.
fixed
The fixed biome source, also called Minecraft:single biome, uses one specified biome everywhere.
- Additional fields:
- Template:Nbt: Template:Json ref/biome — The single biome to use.
multi_noise
- Additional fields:
- Template:Nbt: A reference to a parameter list. The default parameter lists are
overworldandnether.
- Template:Nbt: A reference to a parameter list. The default parameter lists are
- Or:
- Template:Nbt: List of biome parameters points. Needs at least one entry. Biomes can appear in more than one parameter point.
- Template:Nbt: A parameter point.
- Template:Nbt: Template:Json ref/biome — The biome used at this parameter point.
- Template:Nbt: The parameters of this entry
- Template:Nbt: A parameter point.
- Template:Nbt: List of biome parameters points. Needs at least one entry. Biomes can appear in more than one parameter point.
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
overworldandnether.
- Template:Nbt: A reference to a hardcoded parameter list preset. The available presets are
History
External links
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:维度定义格式