Datapack Codex

Configured surface builder

Minecraft Wiki article. Categories: Removed_features, Java_Edition, Testing_needed, Articles_with_empty_sections, Data_packs

📌 Mirrored from Minecraft Wiki

This article is reproduced from Configured surface builder on the Minecraft Wiki. Mirrored from revision 3259622. It is licensed CC BY-NC-SA 3.0 by the Minecraft Wiki contributors — not under the Codex’s CC BY-SA 4.0, and it may not be used commercially. Edits belong upstream, not here.

On this page
BlockSprite rose.png: Sprite image for rose in Minecraft
This page describes content that has been removed from Minecraft.
 
This feature was present in earlier versions of Minecraft, but has since been removed.
This feature is exclusive to Java Edition.
 

Surface builders control how the surface of the terrain is shaped and what blocks it is generated with. Configured surface builders are stored as JSON files within a data pack in the path data/<namespace>/worldgen/configured_surface_builder. They are used in world generation.

JSON format

[NBT Compound / JSON Object] The root tag

    • [String] type:[needs testing] The type of surface builder to use, must be one of "default", "mountain", "shattered_savanna", "gravelly_mountain", "giant_tree_taiga", "swamp", "badlands", "wooded_badlands", "eroded_badlands", "frozen_ocean", "nether", "nether_forest", "soul_sand_valley", "basalt_deltas", or "nope". These choices change the generation of patterns of surface materials, and in the case of "frozen_ocean" and "eroded_badlands", add generated icebergs and buttes, respectively. For example, the mixed patterns of stone in mountains and the terracotta of mesas are coded for through these options.
    • [NBT Compound / JSON Object] config: Configuration for the surface builder.
      • [NBT Compound / JSON Object] top_material:[needs testing] The block to use for the topmost layer of the terrain.
        • [String] Name: The namespaced id of the block to use.
        • [NBT Compound / JSON Object] Properties: Block states
          • [String] state: A block state key and its value.
      • [NBT Compound / JSON Object] under_material:[needs testing] The block to use directly under the topmost layer of the terrain.
        • [String] Name: The namespaced id of the block to use.
        • [NBT Compound / JSON Object] Properties: Block states
          • [String] state: A block state key and its value.
      • [NBT Compound / JSON Object] underwater_material:[needs testing] The block to use under bodies of water.
        • [String] Name: The namespaced id of the block to use.
        • [NBT Compound / JSON Object] Properties: Block states
          • [String] state: A block state key and its value.

History

This section of the article is empty.
 
You can help by expanding it.

Sources