Minecraft:Dimension definition: Difference between revisions
More actions
imported>ProBot m Bot: Modifying de:Angepasste Dimensionen to de:Dimensionsdefinition |
Remove broken links to missing pages |
||
| 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 | [[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}} | {{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 {{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 == | ||
| Line 14: | Line 14: | ||
** {{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 | *** {{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: | ||
| Line 37: | Line 37: | ||
** {{Nbt|string}}{{Nbt|compound|settings}}: {{json ref|noise settings|inline=1}} — Settings for the noise generator. | ** {{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|compound|biome_source}}: Settings determining the biome layout. | ||
*** {{nbt|string|type}}: The [[#Biome sources|biome source]] type as a | *** {{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 52: | Line 52: | ||
=== 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: | ||
| Line 84: | Line 84: | ||
{{HistoryTable | {{HistoryTable | ||
|{{HistoryLine|java}} | |{{HistoryLine|java}} | ||
|{{HistoryLine||1.16|dev=Pre-release 1|Added dimensions to | |{{HistoryLine||1.16|dev=Pre-release 1|Added dimensions to data packs.}} | ||
|{{HistoryLine||1.16.2|dev=20w29a|The | |{{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>.}} | |{{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.}} | ||
|{{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 100: | ||
[[Category:Dimensions]] | [[Category:Dimensions]] | ||
de:Dimensionsdefinition | |||
fr:Définition de dimension | |||
ja:カスタムディメンション | |||
pt:Definição de dimensão | |||
zh:维度定义格式 | |||
Revision as of 15:48, 9 April 2026
|
For the {{{Description}}} of the same name, see [[{{{Destination}}}]]. |
minecraft:floating_islands noise settings.Template:Relevant tutorial 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 Template:Cmd.
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 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 resource location. One of
noise,flat, ordebug. - Additional fields of the generator, described below.
- Template:Nbt: The generator type as resource location. One of
- Template:Nbt: Template:Json ref. 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: 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 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 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
de:Dimensionsdefinition fr:Définition de dimension ja:カスタムディメンション pt:Definição de dimensão zh:维度定义格式