Minecraft:Dimension definition: Difference between revisions
More actions
imported>ProBot m Bot: Modifying de:Angepasste Dimensionen to de:Dimensionsdefinition |
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}} | ||
{{ | {{MC/Exclusive|java}} | ||
[[File:Floating Islands custom dimension.png|thumb|300px|A custom dimension using a [[dimension type|custom type]], a fixed | [[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.]] | ||
{{ | {{MC/Relevant tutorial|Adding a new dimension}} | ||
'''Dimensions''' are [[Minecraft:JSON]] files located in | '''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 | 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: | ||
* {{ | * {{MC/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 | ||
** {{ | ** {{MC/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>. | ||
*** 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 | 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 | 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. | ||
*** {{ | *** {{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}}: {{ | ** {{MC/Nbt|string}}{{MC/Nbt|compound|settings}}: {{MC/Json ref|noise settings|inline=1}} — Settings for the noise generator. | ||
** {{ | ** {{MC/Nbt|compound|biome_source}}: Settings determining the biome layout. | ||
*** {{ | *** {{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: | ||
** {{ | ** {{MC/Nbt|string}}{{MC/Nbt|list|biomes}}: {{MC/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. | ||
</div> | </div> | ||
=== fixed === | === fixed === | ||
The fixed biome source, also called | The fixed biome source, also called 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}} — The single biome to use. | ||
</div> | </div> | ||
| Line 61: | Line 61: | ||
<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>. | ||
* 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. | ||
*** {{ | *** {{MC/Nbt|compound}}: A parameter point. | ||
**** {{ | **** {{MC/Nbt|string|biome}}: {{MC/Json ref/biome}} — The biome used at this parameter point. | ||
**** {{ | **** {{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"> | ||
** {{ | ** {{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 | |{{MC/HistoryLine||1.16|dev=Pre-release 1|Added dimensions to data packs.}} | ||
|{{HistoryLine||1.16.2|dev=20w29a|The | |{{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. | ||
| | |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]] | ||
de:Dimensionsdefinition | |||
fr:Définition de dimension | |||
ja:カスタムディメンション | |||
pt:Definição de dimensão | |||
zh:维度定义格式 | |||
Latest revision as of 20:20, 9 April 2026
|
For the {{{Description}}} of the same name, see [[{{{Destination}}}]]. |
Script error: No such module "Exclusive".
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
- REDIRECT Template:Command
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:
- Template:Nbt/sprite The root tag.
- Template:Nbt/sprite type: One dimension type (an Template:Nbt ID). Can be preset
overworld,the_nether,the_end,overworld_caves, or a custom dimension type - Template:Nbt/sprite generator: Generation settings used for that dimension.
- Template:Nbt/sprite type: The generator type as resource location. One of
noise,flat, ordebug. - Additional fields of the generator, described below.
- Template:Nbt/sprite type: The generator type as resource location. One of
- Template:Nbt/sprite type: One dimension type (an Template:Nbt ID). Can be preset
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.
- Additional fields:
- Template:Nbt/sprite settings: Superflat settings.
noise
The generator used in all the default Minecraft:dimensions.
- Additional fields:
- Template:Nbt/spriteTemplate:Nbt/sprite settings: One noise settings (an Template:Nbt ID, or a new Template:Nbt noise settings definition) — Settings for the noise generator.
- Template:Nbt/sprite biome_source: Settings determining the biome layout.
- Template:Nbt/sprite type: The biome source type as a 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:Nbt/spriteTemplate:Nbt/sprite biomes: Template:Json ref
- Template:Nbt/sprite 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.
fixed
The fixed biome source, also called single biome, uses one specified biome everywhere.
- Additional fields:
- Template:Nbt/sprite biome: Template:Json ref — The single biome to use.
multi_noise
- Additional fields:
- Template:Nbt/sprite preset: A reference to a parameter list. The default parameter lists are
overworldandnether.
- Template:Nbt/sprite preset: A reference to a parameter list. The default parameter lists are
- Or:
- Template:Nbt/sprite biomes: List of biome parameters points. Needs at least one entry. Biomes can appear in more than one parameter point.
- Template:Nbt/sprite: A parameter point.
- Template:Nbt/sprite biome: Template:Json ref — The biome used at this parameter point.
- Template:Nbt/sprite parameters: The parameters of this entry
- Template:Nbt/sprite: A parameter point.
- Template:Nbt/sprite biomes: 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/sprite preset: A reference to a hardcoded parameter list preset. The available presets are
overworldandnether.
- Template:Nbt/sprite preset: A reference to a hardcoded parameter list preset. The available presets are
History
External links
de:Dimensionsdefinition fr:Définition de dimension ja:カスタムディメンション pt:Definição de dimensão zh:维度定义格式