View source for Minecraft:Custom

{{about|the custom world type between Java Editions 1.16 and 1.19.3|controlling world generation using data packs|Custom world generation|the world type before Java Edition 1.13|Old Customized|the Easter egg dimensions in Java Edition 20w14∞|Java Edition 20w14∞#World generation}}
{{outdated|edition=java|This feature has been removed in snapshot [[Minecraft:Java Edition 23w05a|23w05a]].{{more info|though removed in 23w05a, it does not work even in 1.18.x}}}}

'''Custom''' is a [[Minecraft:world type]] that allows users to change the generation of the [[Minecraft:Overworld]], [[Minecraft:Nether]], and [[Minecraft:End]] dimensions as well as the ability to create custom dimensions. It is edited using a [[Minecraft:JSON]] file that is imported on the world creation screen.

== Access ==
To customize a world by using a '''JSON file''', it needs to be imported before world creation: 

*in the world creation menu, go to "More World Options..." and select the "Import Settings" option. Then, select a world generation [[Minecraft:JSON]] file. A warning appears saying that custom worlds are experimental. Click "Yes" to continue. 
*then, in the world creation menu, the "World Type" button becomes gray and displays text: "'''World Type: Custom'''", so that the user is not able to change the world type anymore for the world being created. 

The only way to access added dimensions is through commands, such as {{cmd|execute in <''dimension name''> run tp @s ~ ~ ~}}, which teleports the player to the specified dimension (see {{slink||JSON format}}).

== JSON format ==
{{Expand section| explanations on each component of the JSON file. Useful sources: [https://gist.github.com/misode/b83bfe4964e6bf53b2dd31b22ee94157], [https://gist.github.com/RainWarrior/2c32848aad78910a3ca148b82c91f7c2]}}
Custom generation files take the following format:

<div class="treeview">
* {{nbt|compound}} The root tag.
** {{nbt|boolean|bonus_chest}}: Whether the world has a bonus chest or not (equivalent to the "Bonus chest" option).
** {{nbt|boolean|generate_features}}: Whether structures should be generated or not (equivalent to the "Generate structures" option).
** {{nbt|int|seed}}: The numerical seed of the world.
** {{Nbt|string|legacy_custom_options}}: The custom world preset that was used to generate the world when it was an [[Minecraft:old customized]] world. Exists only for old customized worlds.
** {{nbt|compound|dimensions}}: A list of the dimensions in this world where the key is the [[Minecraft:resource location]] of the dimension. 
*** {{nbt|compound}} A dimension. The dimensions {{code|minecraft:overworld}}, {{code|minecraft:the_nether}} and {{code|minecraft:the_end}} are required for a well functioning world. Any other resource location is allowed for custom dimensions.
**** {{nbt|compound|generator}}: Generation settings used for that dimension.
***** {{nbt|string|type}}: The ID of the generator. Can be {{code|minecraft:flat}} for a superflat dimension, {{code|minecraft:noise}} for noise generation, or {{code|minecraft:debug}} for a [[Minecraft:Debug mode|debug]] dimension.
***** ''Other compounds (see below)''
**** {{nbt|string}}{{nbt|compound|type}}: The resource location of a dimension type file in a data pack, or one of the four default dimension types ({{code|minecraft:overworld}}, {{code|minecraft:the_nether}}, {{code|minecraft:the_end}}, {{code|minecraft:overworld_caves}}).
</div>

=== Generator types ===
<div class="treeview">
** {{Nbt|string|type}}: The ID of the genarator. One of <code>noise</code>, <code>flat</code>, or <code>debug</code>.
**; If {{Nbt|string|type}} is {{code|minecraft:noise}}, additional fields are as follows<nowiki>:</nowiki>
** {{Nbt|string}}{{Nbt|compound|settings}}: {{json ref|noise settings|custom noise settings|inline=1}} &mdash; Settings for the noise generator.
** {{nbt|compound|biome_source}}: Settings dictating which biomes and biome shapes.
*** {{Nbt|string|type}}: The type of biome generation. One of <code>multi_noise</code>, <code>fixed</code>, <code>checkerboard</code>, or <code>the_end</code>.
***; If {{cd|type}} is '''multi_noise'''(3D biome generation used in the nether, and in the overworld in snapshot [[Minecraft:21w37a]] and after.) , additional fields are as follows<nowiki>:</nowiki>
*** {{Nbt|string}}{{Nbt|compound|preset}}: (mutually exclusive with {{Nbt|list|biomes}}) An ID or an object of a [[Minecraft:Custom dimension#Multi-noise biome source parameter list|multi-noise biome source parameter list]].
*** {{Nbt|list|biomes}}: (mutually exclusive with {{Nbt|string|preset}}) (Cannot be empty) A parameter list of biomes, including their IDs and target noise parameters.
**** {{Nbt|compound}}: A biome and its properties.
***** {{Nbt|string|biome}}: {{json ref|biome|custom biome}} &mdash; The biome to place at the given parameters. A single id may be repeated several times with different parameters.
***** {{Nbt|compound|parameters}}: Represent optimal intervals for where the biome should be placed. These values do not affect the generation of terrain within biomes, instead, they only affect where the game chooses to place biomes. Thinking of a six-dimensional space, in the space these intervals are defined for biomes. If the six parameters at a location based on the noise router in [[Minecraft:Custom_noise_settings|noise settings]] fall into an interval, the corresponding biome is generated here. If the six parameters at a location do not fall into a defined biome interval in this list, it uses the closest biome interval to the 6D parameter point, in order to form a transition between biomes. Parameter combinations should be unique in the biomes list.
****** {{Nbt|compound|temperature}}: Not to be confused with the temperature value listed on [[Minecraft:Biome]].
******* {{nbt|float|min}}: Value between -2.0 and 2.0 (both inclusive). The min value.
******* {{nbt|float|max}}: Value between -2.0 and 2.0 (both inclusive). The max value. Must be not less than <code>min</code>
****** {{Nbt|list|temperature}}: Shorthand of {{Nbt|compound|temperature}}.
******* {{nbt|float}}: Value between -2.0 and 2.0 (both inclusive). The min value.
******* {{nbt|float}}: Value between -2.0 and 2.0 (both inclusive). The max value. Must be not less than <code>min</code>
****** {{Nbt|float|temperature}}: Value between -2.0 and 2.0 (both inclusive). Shorthand of {{Nbt|list|temperature}} when the min equals to the max.
****** {{Nbt|compound}}{{Nbt|list}}{{Nbt|float|humidity}}: The format is the same as <code>temperature</code>.
****** {{Nbt|compound}}{{Nbt|list}}{{Nbt|float|continentalness}}: The format is the same as <code>temperature</code>.
****** {{Nbt|compound}}{{Nbt|list}}{{Nbt|float|erosion}}: The format is the same as <code>temperature</code>.
****** {{Nbt|compound}}{{Nbt|list}}{{Nbt|float|weirdness}}: The format is the same as <code>temperature</code>.
****** {{Nbt|compound}}{{Nbt|list}}{{Nbt|float|depth}}: The format is the same as <code>temperature</code>.
****** {{Nbt|float|offset}}: Value between 0.0 and 1.0 (both inclusive). Similar to the other parameters but is 0 everywhere. thus setting this parameter nearer to 0 leads to a greater edge over others, all else being equal.
***; If {{cd|type}} is '''the_end'''(Biome generation used in the end with biome {{Code|minecraft:the_end}} in the center and other end biomes around) , no additional field.
***; If {{cd|type}} is '''fixed'''(single biome) , additional fields are as follows<nowiki>:</nowiki>
*** {{Nbt|string|biome}}: The ID of the single biome to generate.<!--Setting to a object of biome crashes the game-->
***; If {{cd|type}} is '''checkerboard'''(A biome generation in which biomes are square (or close to square) and repeat along the diagonals) , additional fields are as follows<nowiki>:</nowiki>
*** {{Nbt|string}}{{nbt|list|biomes}}: {{json ref|biome|custom biome|tag=1}} Biomes that repeat along the diagonals. <!--Setting to a object of biome or a list of object may crash the game, see MC-263333-->
*** {{Nbt|int|scale}}: (optional, defaults to 2) Value between 0 and 62 (both inclusive). Determines the size of the squares on an exponential scale.
**; If {{Nbt|string|type}} is {{code|minecraft:debug}}(used for [[Minecraft:Debug world]] generation) , no additional fields.
**; If {{Nbt|string|type}} is {{code|minecraft:flat}}(used for [[Minecraft:Superflat]] world generation) , additional fields are as follows<nowiki>:</nowiki>
** {{Nbt|compound|settings}}: Superflat settings.
*** {{Nbt|list|layers}}: (Required, but can be empty) Layer settings. This list is interpreted from top to bottom, starting at world bottom.
**** {{Nbt|compound}}: A superflat layer.
***** {{Nbt|int|height}}: The height of this layer. Value between 0 and 4064 (both inclusive) .
***** {{Nbt|string|block}}: (optional, defaults to minecraft:air) The block ID.
*** {{Nbt|string|biome}}: (optional, defaults to plains) The ID of the single biome of the world.<!--Setting to a object of biome may crash the game-->
*** {{Nbt|boolean|lakes}}: (optional, defaults to false) Whether or not to generate lava lakes. If set to true, then lava lakes (lake_lava_underground and lake_lava_surface) generate often even in biomes where lakes don't normally generate.
*** {{Nbt|boolean|features}}: (optional, defaults to false) Whether or not to generate biome-specific placed features. Note that the placed features in the step UNDERGROUND_STRUCTURES and SURFACE_STRUCTURES never generates. If the biome is not minecraft:void, but {{Nbt|list|layers}} is empty or has only air, no placed feature generates. 
*** {{Nbt|string}}{{nbt|list|structure_overrides}}: (optional, defaults to all the structure sets) List of structure sets to use. Can be a ID of structure set or a structure set tag, or a list of structure set IDs.
[[Category:Java Edition]]
[[Category:Data packs]]


</div>

== Defaults ==

Moved to [[Minecraft:Custom world generation#Noise settings]]
=== Noise generator preset defaults ===
These are the settings used by the 6 presets available for the <code>minecraft:noise</code> generator.
{| class="wikitable collapsible collapsed"
|+
! colspan="3" |Property
!<code>minecraft:overworld</code>
!<code>minecraft:amplified</code>
!<code>minecraft:nether</code>
!<code>minecraft:caves</code>
!<code>minecraft:end</code>
!<code>minecraft:floating_islands</code>
|-
| colspan="3" |<code>bedrock_roof_position</code>
| colspan="2" | -10
| colspan="2" |0
| colspan="2" | -10
|-
| colspan="3" |<code>bedrock_floor_position</code>
| colspan="2" |0
| colspan="2" |0
| colspan="2" | -10
|-
| colspan="3" |<code>sea_level</code>
| colspan="2" |63
| colspan="2" |32
| colspan="2" |0
|-
| colspan="3" |<code>disable_mob_generation</code>
| colspan="2" |false
| colspan="2" |false
|true
|false
|-
| colspan="3" |<code>default_block</code>
| colspan="2" |<code>minecraft:stone</code>
|<code>minecraft:netherrack</code>
|<code>minecraft:stone</code>
|<code>minecraft:end_stone</code>
|<code>minecraft:stone</code>
|-
| colspan="3" |<code>default_fluid</code>
| colspan="2" |<code>minecraft:water</code>
|<code>minecraft:lava</code>
|<code>minecraft:water</code>
|<code>minecraft:air</code>
|<code>minecraft:water</code>
|-
| rowspan="4" |<code>structures</code>
| rowspan="3" |<code>stronghold</code>
|<code>distance</code>
| colspan="2" |32
| colspan="2" rowspan="3" |Tag not included
| colspan="2" rowspan="3" |Tag not included
|-
|<code>count</code>
| colspan="2" |1
|-
|<code>spread</code>
| colspan="2" |3
|-
| colspan="2" |<code>structures</code>
| colspan="6" |See below
|-
| rowspan="19" |<code>noise</code>
| rowspan="3" |<code>top_slide</code>
|<code>target</code>
| colspan="2" | -10
| colspan="2" |120
| colspan="2" | -3000
|-
|<code>size</code>
| colspan="2" |3
| colspan="2" |3
| colspan="2" |64
|-
|<code>offset</code>
| colspan="2" |0
| colspan="2" |0
| colspan="2" | -46
|-
| rowspan="3" |<code>bottom_slide</code>
|<code>target</code>
| colspan="2" | -30
| colspan="2" |320
| colspan="2" | -30
|-
|<code>size</code>
| colspan="2" |0
| colspan="2" |4
| colspan="2" |7
|-
|<code>offset</code>
| colspan="2" |0
| colspan="2" | -1
| colspan="2" |1
|-
| rowspan="4" |<code>sampling</code>
|<code>xz_scale</code>
| colspan="2" |0.9999999814507745
| colspan="2" |1
| colspan="2" |2
|-
|<code>xz_factor</code>
| colspan="2" |80
| colspan="2" |80
| colspan="2" |80
|-
|<code>y_scale</code>
| colspan="2" |0.9999999814507745
| colspan="2" |3
| colspan="2" |1
|-
|<code>y_factor</code>
| colspan="2" |160
| colspan="2" |60
| colspan="2" |160
|-
| colspan="2" |<code>size_vertical</code>
| colspan="2" |2
| colspan="2" |2
| colspan="2" |1
|-
| colspan="2" |<code>size_horizontal</code>
| colspan="2" |1
| colspan="2" |1
| colspan="2" |2
|-
| colspan="2" |<code>height</code>
| colspan="2" |256
| colspan="2" |128
| colspan="2" |128
|-
| colspan="2" |<code>density_factor</code>
| colspan="2" |1
| colspan="2" |0
| colspan="2" |0
|-
| colspan="2" |<code>density_offset</code>
| colspan="2" | -0.46875
| colspan="2" |0.019921875
| colspan="2" |0
|-
| colspan="2" |<code>random_density_offset</code>
| colspan="2" |true
| colspan="2" |false
| colspan="2" |false
|-
| colspan="2" |<code>simplex_surface_noise</code>
| colspan="2" |true
| colspan="2" |false
| colspan="2" |true
|-
| colspan="2" |<code>island_noise_override</code>
| colspan="2" |false
| colspan="2" |false
|true
|false
|-
| colspan="2" |<code>amplified</code>
|false
|true
| colspan="2" |false
| colspan="2" |false
|}

==== Structure defaults ====
These are the default values for all namespaced structures. Every preset uses the same values for all of these structures, with the exception of <code>minecraft:ruined_portal</code>.
{| class="wikitable collapsible collapsed"
|+
! colspan="2" |Structure
!Spacing
!Separation
!Salt
|-
| colspan="2" |<code>village</code>
|32
|8
|10387312
|-
| colspan="2" |<code>desert_pyramid</code>
|32
|8
|14357617
|-
| colspan="2" |<code>igloo</code>
|32
|8
|14357618
|-
| colspan="2" |<code>jungle_pyramid</code>
|32
|8
|14357619
|-
| colspan="2" |<code>swamp_hut</code>
|32
|8
|14357620
|-
| colspan="2" |<code>pillager_outpost</code>
|32
|8
|165745296
|-
| colspan="2" |<code>stronghold</code>*
|1
|0
|0
|-
| colspan="2" |<code>monument</code>
|32
|5
|10387313
|-
| colspan="2" |<code>endcity</code>
|20
|11
|10387313
|-
| colspan="2" |<code>mansion</code>
|80
|20
|10387319
|-
| colspan="2" |<code>buried_treasure</code>**
|1
|0
|0
|-
| colspan="2" |<code>mineshaft</code>**
|1
|0
|0
|-
| rowspan="2" |<code>ruined_portal</code>
|<code>nether</code> and <code>caves</code>
|25
|10
|34222645
|-
|All other presets
|40
|15
|34222645
|-
| colspan="2" |<code>shipwreck</code>
|24
|4
|165745295
|-
| colspan="2" |<code>ocean_ruin</code>
|20
|8
|14357621
|-
| colspan="2" |<code>bastion_remnant</code>
|27
|4
|30084232
|-
| colspan="2" |<code>fortress</code>
|27
|4
|30084232
|-
| colspan="2" |<code>nether_fossil</code>
|2
|1
|14357921
|}
''*Placeholder values, have no effect''

''**Salt values aren't used for theses structures; changing them produces no effect''

=== Biome parameter defaults ===
{{Update|Altitude was removed since and Continentalness, Erosion and Depth were added. Values might also not be up to date.|section=1}}
These are the default values used for each biome in the <code>multi_noise</code> <code>biome_source</code>. Interestingly, although only the values for nether biomes are accessible through a preset, several overworld biomes have default values as well.
{| class="wikitable collapsible collapsed"
|+
!Biome
!Temperature
!Humidity
!Altitude
!Weirdness
!Offset
|-
|<code>badlands</code>
| -0.25
| -0.5
|0.5
|0.2
|1
|-
|<code>badlands_plateau</code>
| -0.25
| -0.5
|0.65
|0.2
|1
|-
|<code>bamboo_jungle</code>
|0.5
|0.5
|0
|0.2
|1
|-
|<code>bamboo_jungle_hills</code>
|0.5
|0.5
|0.25
|0.2
|1
|-
|<code>basalt_deltas</code>
| -0.5
|0
|0
|0
|0.175
|-
|<code>beach</code>
|0
|0
| -0.1
|0
|0.9935
|-
|<code>birch_forest</code>
| -0.1
|0.2
|0
|0
|1
|-
|<code>birch_forest_hills</code>
| -0.1
|0.2
|0.25
|0
|1
|-
|<code>crimson_forest</code>
|0.4
|0
|0
|0
|0
|-
|<code>desert</code>
|0.5
| -0.5
|0
|0
|1
|-
|<code>jungle</code>
|0.5
|0.5
|0
|0
|1
|-
|<code>nether_wastes</code>
|0
|0
|0
|0
|0
|-
|<code>ocean</code>
|0
|0
| -0.5
|0
|1
|-
|<code>plains</code>
|0
|0
|0
|0
|1
|-
|<code>snowy_tundra</code>
| -0.5
| -0.5
|0
|0
|1
|-
|<code>soul_sand_valley</code>
|0
| -0.5
|0
|0
|0
|-
|<code>warm_ocean</code>
|0
|0
| -0.25
|0
|1
|-
|<code>warped_forest</code>
|0
|0.5
|0
|0
|0.375
|}

=== Dimension type defaults ===
{{/Default dimension types}}

== Examples ==
{{Expand section|more examples and the actual info for what the default generator uses. Check that the Expanded default settings listed below still works in 1.19.3.}}

=== Default settings ===
This one will change to 1.19.3-typed later.

The following is the settings for an exported default ''Minecraft'' world.
{{collapse|title=Collapsed JSON content|content=
<syntaxhighlight lang="json" style="display:table;">
{
  "bonus_chest": false,
  "dimensions": {
    "minecraft:overworld": {
      "type": "minecraft:overworld",
      "generator": {
        "biome_source": {
          "seed": 0,
          "large_biomes": false,
          "type": "minecraft:vanilla_layered"
        },
        "seed": 0,
        "settings": "minecraft:overworld",
        "type": "minecraft:noise"
      }
    },
    "minecraft:the_nether": {
      "type": "minecraft:the_nether",
      "generator": {
        "biome_source": {
          "seed": 0,
          "preset": "minecraft:nether",
          "type": "minecraft:multi_noise"
        },
        "seed": 0,
        "settings": "minecraft:nether",
        "type": "minecraft:noise"
      }
    },
    "minecraft:the_end": {
      "type": "minecraft:the_end",
      "generator": {
        "biome_source": {
          "seed": 0,
          "type": "minecraft:the_end"
        },
        "seed": 0,
        "settings": "minecraft:end",
        "type": "minecraft:noise"
      }
    }
  },
  "seed": 0,
  "generate_features": true
}
</syntaxhighlight>
}}

==== Expanded default settings ====
This file contains the same settings used to produce a default world, but with all of the presets expanded to their default values. Note that there is a bug that makes it impossible to create the [[Minecraft:ender dragon]] fight without using the dimension type preset <code>minecraft:the_end</code>, as the flag that creates the fight is hardcoded and not accessible through JSON. However, it is otherwise identical to the default world.{{collapse|title=Collapsed JSON content|content=
<syntaxhighlight lang="json" style="display:table;">
{
  "bonus_chest": false,
  "dimensions": {
    "minecraft:overworld": {
      "type": {
		"logical_height": 256,
		"infiniburn": "minecraft:infiniburn_overworld",
		"effects": "minecraft:overworld",
		"ambient_light": 0.0,
		"respawn_anchor_works": false,
		"has_raids": true,
		"min_y": 0,
		"height": 256,
		"natural": true,
		"coordinate_scale": 1.0,
		"piglin_safe": false,
		"bed_works": true,
		"has_skylight": true,
		"has_ceiling": false,
		"ultrawarm": false
      },
      "generator": {
        "biome_source": {
          "seed": 0,
          "large_biomes": false,
          "type": "minecraft:vanilla_layered"
        },
        "seed": 0,
        "settings": {
		  "noise_caves_enabled": false,
		  "deepslate_enabled": false,
		  "ore_veins_enabled": false,
		  "noodle_caves_enabled": false,
		  "min_surface_level": 0,
		  "disable_mob_generation": false,
		  "aquifers_enabled": false,
		  "default_fluid": {
			"Properties": {
			  "level": "0"
			},
			"Name": "minecraft:water"
		  },
		  "bedrock_roof_position": -2147483648,
		  "bedrock_floor_position": 0,
		  "sea_level": 63,
		  "structures": {
			"stronghold": {
			  "distance": 32,
			  "spread": 3,
			  "count": 128
			},
			"structures": {
			  "minecraft:pillager_outpost": {
				"spacing": 32,
				"separation": 8,
				"salt": 165745296
			  },
			  "minecraft:village": {
				"spacing": 32,
				"separation": 8,
				"salt": 10387312
			  },
			  "minecraft:fortress": {
				"spacing": 27,
				"separation": 4,
				"salt": 30084232
			  },
			  "minecraft:desert_pyramid": {
				"spacing": 32,
				"separation": 8,
				"salt": 14357617
			  },
			  "minecraft:bastion_remnant": {
				"spacing": 27,
				"separation": 4,
				"salt": 30084232
			  },
			  "minecraft:stronghold": {
				"spacing": 1,
				"separation": 0,
				"salt": 0
			  },
			  "minecraft:monument": {
				"spacing": 32,
				"separation": 5,
				"salt": 10387313
			  },
			  "minecraft:swamp_hut": {
				"spacing": 32,
				"separation": 8,
				"salt": 14357620
			  },
			  "minecraft:endcity": {
				"spacing": 20,
				"separation": 11,
				"salt": 10387313
			  },
			  "minecraft:mineshaft": {
				"spacing": 1,
				"separation": 0,
				"salt": 0
			  },
			  "minecraft:igloo": {
				"spacing": 32,
				"separation": 8,
				"salt": 14357618
			  },
			  "minecraft:mansion": {
				"spacing": 80,
				"separation": 20,
				"salt": 10387319
			  },
			  "minecraft:buried_treasure": {
				"spacing": 1,
				"separation": 0,
				"salt": 0
			  },
			  "minecraft:ocean_ruin": {
				"spacing": 20,
				"separation": 8,
				"salt": 14357621
			  },
			  "minecraft:jungle_pyramid": {
				"spacing": 32,
				"separation": 8,
				"salt": 14357619
			  },
			  "minecraft:ruined_portal": {
				"spacing": 40,
				"separation": 15,
				"salt": 34222645
			  },
			  "minecraft:shipwreck": {
				"spacing": 24,
				"separation": 4,
				"salt": 165745295
			  },
			  "minecraft:nether_fossil": {
				"spacing": 2,
				"separation": 1,
				"salt": 14357921
			  }
			}
		  },
		  "noise": {
			"simplex_surface_noise": true,
			"random_density_offset": true,
			"size_vertical": 2,
			"density_factor": 1.0,
			"density_offset": -0.46875,
			"top_slide": {
			  "target": -10,
			  "size": 3,
			  "offset": 0
			},
			"bottom_slide": {
			  "target": 15,
			  "size": 3,
			  "offset": 0
			},
			"size_horizontal": 1,
			"min_y": 0,
			"height": 256,
			"sampling": {
			  "xz_scale": 0.9999999814507745,
			  "y_scale": 0.9999999814507745,
			  "xz_factor": 80.0,
			  "y_factor": 160.0
			}
		  },
		  "default_block": {
			"Name": "minecraft:stone"
		  }
		},
        "type": "minecraft:noise"
      }
    },
    "minecraft:the_nether": {
      "type": {
		"logical_height": 128,
		"infiniburn": "minecraft:infiniburn_nether",
		"effects": "minecraft:the_nether",
		"ambient_light": 0.1,
		"respawn_anchor_works": true,
		"has_raids": false,
		"min_y": 0,
		"height": 256,
		"natural": false,
		"coordinate_scale": 8.0,
		"piglin_safe": true,
		"bed_works": false,
		"fixed_time": 18000,
		"has_skylight": false,
		"has_ceiling": true,
		"ultrawarm": true
	  },
	  "generator": {
		"biome_source": {
		  "humidity_noise": {
			"firstOctave": -7,
			"amplitudes": [
			  1.0,
			  1.0
			]
		  },
		  "altitude_noise": {
			"firstOctave": -7,
			"amplitudes": [
			  1.0,
			  1.0
			]
		  },
		  "weirdness_noise": {
			"firstOctave": -7,
			"amplitudes": [
			  1.0,
			  1.0
			]
		  },
		  "seed": 0,
		  "biomes": [
			{
			  "parameters": {
				"altitude": 0.0,
				"weirdness": 0.0,
				"offset": 0.0,
				"temperature": 0.0,
				"humidity": 0.0
			  },
			  "biome": "minecraft:nether_wastes"
			},
			{
			  "parameters": {
				"altitude": 0.0,
				"weirdness": 0.0,
				"offset": 0.0,
				"temperature": 0.0,
				"humidity": -0.5
			  },
			  "biome": "minecraft:soul_sand_valley"
			},
			{
			  "parameters": {
				"altitude": 0.0,
				"weirdness": 0.0,
				"offset": 0.0,
				"temperature": 0.4,
				"humidity": 0.0
			  },
			  "biome": "minecraft:crimson_forest"
			},
			{
			  "parameters": {
				"altitude": 0.0,
				"weirdness": 0.0,
				"offset": 0.375,
				"temperature": 0.0,
				"humidity": 0.5
			  },
			  "biome": "minecraft:warped_forest"
			},
			{
			  "parameters": {
				"altitude": 0.0,
				"weirdness": 0.0,
				"offset": 0.175,
				"temperature": -0.5,
				"humidity": 0.0
			  },
			  "biome": "minecraft:basalt_deltas"
			}
		  ],
		  "temperature_noise": {
			"firstOctave": -7,
			"amplitudes": [
			  1.0,
			  1.0
			]
		  },
		  "type": "minecraft:multi_noise"
		},
        "seed": 0,
        "settings": {
		  "noise_caves_enabled": false,
		  "deepslate_enabled": false,
		  "ore_veins_enabled": false,
		  "noodle_caves_enabled": false,
		  "min_surface_level": 0,
		  "disable_mob_generation": false,
		  "aquifers_enabled": false,
		  "bedrock_roof_position": 0,
		  "bedrock_floor_position": 0,
		  "sea_level": 32,
		  "structures": {
			"structures": {
			  "minecraft:pillager_outpost": {
				"spacing": 32,
				"separation": 8,
				"salt": 165745296
			  },
			  "minecraft:village": {
				"spacing": 32,
				"separation": 8,
				"salt": 10387312
			  },
			  "minecraft:fortress": {
				"spacing": 27,
				"separation": 4,
				"salt": 30084232
			  },
			  "minecraft:desert_pyramid": {
				"spacing": 32,
				"separation": 8,
				"salt": 14357617
			  },
			  "minecraft:bastion_remnant": {
				"spacing": 27,
				"separation": 4,
				"salt": 30084232
			  },
			  "minecraft:stronghold": {
				"spacing": 1,
				"separation": 0,
				"salt": 0
			  },
			  "minecraft:monument": {
				"spacing": 32,
				"separation": 5,
				"salt": 10387313
			  },
			  "minecraft:swamp_hut": {
				"spacing": 32,
				"separation": 8,
				"salt": 14357620
			  },
			  "minecraft:endcity": {
				"spacing": 20,
				"separation": 11,
				"salt": 10387313
			  },
			  "minecraft:mineshaft": {
				"spacing": 1,
				"separation": 0,
				"salt": 0
			  },
			  "minecraft:igloo": {
				"spacing": 32,
				"separation": 8,
				"salt": 14357618
			  },
			  "minecraft:mansion": {
				"spacing": 80,
				"separation": 20,
				"salt": 10387319
			  },
			  "minecraft:buried_treasure": {
				"spacing": 1,
				"separation": 0,
				"salt": 0
			  },
			  "minecraft:ocean_ruin": {
				"spacing": 20,
				"separation": 8,
				"salt": 14357621
			  },
			  "minecraft:jungle_pyramid": {
				"spacing": 32,
				"separation": 8,
				"salt": 14357619
			  },
			  "minecraft:ruined_portal": {
				"spacing": 25,
				"separation": 10,
				"salt": 34222645
			  },
			  "minecraft:shipwreck": {
				"spacing": 24,
				"separation": 4,
				"salt": 165745295
			  },
			  "minecraft:nether_fossil": {
				"spacing": 2,
				"separation": 1,
				"salt": 14357921
			  }
			}
		  },
		  "noise": {
			"density_factor": 0.0,
			"density_offset": 0.019921875,
			"simplex_surface_noise": false,
			"bottom_slide": {
			  "target": 320,
			  "size": 4,
			  "offset": -1
			},
			"size_horizontal": 1,
			"size_vertical": 2,
			"height": 128,
			"sampling": {
			  "xz_scale": 1.0,
			  "y_scale": 3.0,
			  "xz_factor": 80.0,
			  "y_factor": 60.0
			},
			"top_slide": {
			  "target": 120,
			  "size": 3,
			  "offset": 0
			}
		  },
		  "default_block": {
			"Name": "minecraft:netherrack"
		  },
		  "default_fluid": {
			"Properties": {
			  "level": "0"
			},
			"Name": "minecraft:lava"
		  }
		},
        "type": "minecraft:noise"
      }
    },
    "minecraft:the_end": {
	  "type": {
		"logical_height": 256,
		"infiniburn": "minecraft:infiniburn_end",
		"effects": "minecraft:the_end",
		"ambient_light": 0.0,
		"respawn_anchor_works": false,
		"has_raids": true,
		"min_y": 0,
		"height": 256,
		"natural": false,
		"coordinate_scale": 1.0,
		"piglin_safe": false,
		"bed_works": false,
		"fixed_time": 6000,
		"has_skylight": false,
		"has_ceiling": false,
		"ultrawarm": false
	  },
      "generator": {
        "biome_source": {
          "seed": 0,
          "type": "minecraft:the_end"
        },
        "seed": 0,
        "settings": {
		  "noise_caves_enabled": false,
		  "deepslate_enabled": false,
		  "ore_veins_enabled": false,
		  "noodle_caves_enabled": false,
		  "min_surface_level": 0,
		  "disable_mob_generation": true,
		  "aquifers_enabled": false,
		  "bedrock_roof_position": -2147483648,
		  "bedrock_floor_position": -2147483648,
		  "sea_level": 0,
		  "structures": {
			"structures": {
			  "minecraft:pillager_outpost": {
				"spacing": 32,
				"separation": 8,
				"salt": 165745296
			  },
			  "minecraft:village": {
				"spacing": 32,
				"separation": 8,
				"salt": 10387312
			  },
			  "minecraft:fortress": {
				"spacing": 27,
				"separation": 4,
				"salt": 30084232
			  },
			  "minecraft:desert_pyramid": {
				"spacing": 32,
				"separation": 8,
				"salt": 14357617
			  },
			  "minecraft:bastion_remnant": {
				"spacing": 27,
				"separation": 4,
				"salt": 30084232
			  },
			  "minecraft:stronghold": {
				"spacing": 1,
				"separation": 0,
				"salt": 0
			  },
			  "minecraft:monument": {
				"spacing": 32,
				"separation": 5,
				"salt": 10387313
			  },
			  "minecraft:swamp_hut": {
				"spacing": 32,
				"separation": 8,
				"salt": 14357620
			  },
			  "minecraft:endcity": {
				"spacing": 20,
				"separation": 11,
				"salt": 10387313
			  },
			  "minecraft:mineshaft": {
				"spacing": 1,
				"separation": 0,
				"salt": 0
			  },
			  "minecraft:igloo": {
				"spacing": 32,
				"separation": 8,
				"salt": 14357618
			  },
			  "minecraft:mansion": {
				"spacing": 80,
				"separation": 20,
				"salt": 10387319
			  },
			  "minecraft:buried_treasure": {
				"spacing": 1,
				"separation": 0,
				"salt": 0
			  },
			  "minecraft:ocean_ruin": {
				"spacing": 20,
				"separation": 8,
				"salt": 14357621
			  },
			  "minecraft:jungle_pyramid": {
				"spacing": 32,
				"separation": 8,
				"salt": 14357619
			  },
			  "minecraft:ruined_portal": {
				"spacing": 40,
				"separation": 15,
				"salt": 34222645
			  },
			  "minecraft:shipwreck": {
				"spacing": 24,
				"separation": 4,
				"salt": 165745295
			  },
			  "minecraft:nether_fossil": {
				"spacing": 2,
				"separation": 1,
				"salt": 14357921
			  }
			}
		  },
		  "noise": {
			"island_noise_override": true,
			"density_factor": 0.0,
			"density_offset": 0.0,
			"simplex_surface_noise": true,
			"bottom_slide": {
			  "target": -30,
			  "size": 7,
			  "offset": 1
			},
			"size_horizontal": 2,
			"size_vertical": 1,
			"height": 128,
			"sampling": {
			  "xz_scale": 2.0,
			  "y_scale": 1.0,
			  "xz_factor": 80.0,
			  "y_factor": 160.0
			},
			"top_slide": {
			  "target": -3000,
			  "size": 64,
			  "offset": -46
			}
		  },
		  "default_block": {
			"Name": "minecraft:end_stone"
		  },
		  "default_fluid": {
			"Name": "minecraft:air"
		  }
		},
        "type": "minecraft:noise"
      }
    }
  },
  "seed": 0,
  "generate_features": true
}
</syntaxhighlight>
}}

=== Custom superflat dimension ===
[[File:Custom superflat dimension.png|thumb|An overview of a world made with the adjacent settings.]]
This dimension is a [[Minecraft:Superflat]] world with a layer of grass on four layers of coarse dirt on top of five layers of basalt. The entire world is full of village houses as {{cd|spacing}} is set to 3 (default: 32) and {{cd|separation}} is set to 1 (default: 8). The world starts by default at time 1000.
{{collapse|title=Collapsed {{cd|dimension}} object data|content=
<syntaxhighlight lang="json" style="display:table;">
{
  "generator": {
    "settings": {
      "structures": {
        "structures": {
          "minecraft:village": {
            "spacing": 3,
            "separation": 1,
            "salt": 10387312
          }
        }
      },
      "layers": [
        {
          "height": 5,
          "block": "minecraft:basalt"
        },
        {
          "height": 4,
          "block": "minecraft:coarse_dirt"
        },
        {
          "height": 1,
          "block": "minecraft:grass_block"
        }
      ],
      "biome": "minecraft:plains"
    },
    "type": "minecraft:flat"
  },
  "type": {
    "ultrawarm": false,
    "natural": true,
	"coordinate_scale": 1.0,
    "ambient_light": 0.5,
    "fixed_time": 1000,
    "has_skylight": true,
    "has_ceiling": false
  }
}
</syntaxhighlight>
}}
<!--

=== Example file: [https://gist.github.com/RainWarrior/2c32848aad78910a3ca148b82c91f7c2 Example settings] ===

=== A debug world ===
All 3 dimensions use the "debug" generator type.<syntaxhighlight lang="json">
{
    
}
</syntaxhighlight>

=== A superflat world ===
The Nether and End are superflats as well.<syntaxhighlight lang="json">
{
    
}
</syntaxhighlight>

=== A world where the nether and the overworld are swapped ===
<br />

=== A world with a custom dimension ===
<br />-->

== History ==

{{HistoryTable
|{{HistoryLine|java}}
|{{HistoryLine||May 15, 2018|link=none|The return of customized worlds was mentioned.<ref>"Customized worlds will be returning. I can't speak for the extra options you mentioned though." – u/AlmightyZing<br>{{reddit|8jlzw4/minecraft_snapshot_18w20a|name=snapshot_18w20a|dz0rdqd|But after 1.13|_Grum|May 15, 2018}}</ref><ref>"Would you really not consider holding off 1.13 until customised worlds are finished? Seems pretty crazy to set a precedent for the chance of losing features for several updates.<br>We came so close to having access to customising structures in world gen this update too, a shame that hasn't made the cut" – u/DaUltraMarine<br>{{reddit|snapshot_18w20a|dz0ukhq|No, they will come back but completely different from before.|_Grum|May 15, 2018}}</ref><ref>"No customization until after 1.13, or the other things?" – u/Kobbett<br>{{reddit|snapshot_18w20a|dz19qpg|No more screens with 50 vague sliders indeed.|_Grum|May 15, 2018}}</ref>}}
|{{HistoryLine||1.16|dev=20w21a|Added custom worlds.
|Custom worlds are JSON-driven.
|Custom dimensions can be added and vanilla dimensions can be modified.
|There is currently no in-game menu to modify worlds; custom worlds can be generated only by importing a JSON file.}}
|{{HistoryLine|||dev=pre1|The "temparature" [[Minecraft:biome]] parameter is now spelled "temperature".
|Dimensions and dimension settings can be created through data packs.}}
|{{HistoryLine||1.16.2|dev=20w28a|Experimental custom biome support is now included in custom worlds.}} 
|{{HistoryLine||1.17|dev=20w49a|Max build heights and bedrock ceiling heights are now customizable over 256 blocks via custom json files.}}
|{{HistoryLine|||dev=21w05a|Minimum and maximum y values changed from -2047 and 2047 to -2032 and 2032.}}
|{{HistoryLine||1.19.4|dev=23w05a|Removed the "Import Settings" and "Export Settings" buttons in the "Edit World" screen, making it impossible to access custom worlds through JSON files.}}
}}

== Issues ==
{{issue list}}

== Gallery ==
=== Screenshots ===
<gallery>
Extremelly high floating islands generated with amplified settings and max custom world height.png|Natural [[Minecraft:snow]] generating as high as Y=801 in an [[Minecraft:amplified]] custom world with increased maximum '''height'''.
Lowest bedrock generation in an extreme Custom world.png|[[Minecraft:Bedrock]] floor generating as low as Y=−2048 in a world with decreased '''min_y'''.
Lowest possible block in a Custom world.png|Lowest placeable temporary block in a custom world, at which point the game is unplayable.
</gallery>

== External links ==
* [https://gist.github.com/RainWarrior/2c32848aad78910a3ca148b82c91f7c2 Example settings]
* [https://gist.github.com/misode/b83bfe4964e6bf53b2dd31b22ee94157 Detailed guide of the generator settings]
*[https://misode.github.io/worldgen/ JSON generator website]

== See also ==
* [[Minecraft:Custom dimension]]
* [[Minecraft:Custom world generation]]

== References ==
{{reflist}}

== Navigation ==
{{Navbox environment}}

[[Category:World types]]

[[Minecraft:de:Angepasst]]
[[Minecraft:fr:Personnalisé]]
[[Minecraft:ja:カスタマイズ]]
[[Minecraft:pl:Dostosowany]]
[[Minecraft:pt:Personalizado]]
[[Minecraft:ru:Пользовательский]]
[[Minecraft:zh:自定义]]