Minecraft:Configured feature: Difference between revisions

Latest revision as of 11:01, 23 July 2026

Template:Exclusive A configured feature is the configuration of a feature type. They can be used in Minecraft:placed features to define the Minecraft:features that are placed in a world.

Configured features are stored as JSON files within a Minecraft:data pack in the Template:Cd folder.

JSON format

Template:Nbt: Root object.
- Template:Nbt: The ID of feature type.
- Template:Nbt Template:Until: Configuration of this configured feature. The properties depend on the value of Template:Nbt, described below.

Feature types

Template:Cleanup A feature type determines how and what a configured feature should generate. They are hardcoded, thus new ones cannot be added through datapacks. Most feature types have configuration options that can be set using a configured feature. The following lists all feature types and their configuration options.

Configuration-less features

These features have files in the data/<namespace>/worldgen/configured_feature folder, but none of them have any configuration options in current versions.

Template:Collapse Template:Until Template:Collapse Template:Collapse Template:Collapse Template:Collapse Template:Until Template:Collapse Template:Until Template:Collapse Template:Until Template:Collapse Template:Collapse Template:Collapse Template:Collapse Template:Collapse Template:Until Template:Collapse Template:Until Template:Collapse Template:Collapse Template:Collapse Template:Collapse Template:Collapse Template:Until

History

Template:HistoryTable

Issues

Template:Issue list

External links

Configured feature Generator on misode.github.io

Navigation

Template:Navbox Java Edition technical

Minecraft:de:Merkmaldefinition Minecraft:fr:Élément du terrain configuré Minecraft:ja:生成物のカスタマイズ Minecraft:ko:설정된 지물 Minecraft:pt:Recurso configurado Minecraft:zh:已配置的地物

@@ Line 8: / Line 8: @@
 * {{nbt|compound}}: Root object.
 ** {{nbt|string|type}}: The ID of feature type.
-** {{nbt|compound|config}}: Configuration of this configured feature. The properties depend on the value of {{nbt|string|type}}, described below.
+** {{nbt|compound|config}}{{until|JE 26.3}}: Configuration of this configured feature. The properties depend on the value of {{nbt|string|type}}, described below.
 </div>
@@ Line 17: / Line 17: @@
 {{collapse|title={{EnvSprite|bamboo-(feature)|link=Bamboo (feature)|text='''bamboo'''}}|content={{#lst:Bamboo (feature)|config}}}}
 {{collapse|title={{EnvSprite|basalt-column|link=Basalt Columns|text='''basalt_columns'''}}|content={{#lst:Basalt columns|config}}}}
+{{collapse|title={{EnvSprite|forest-rock|link=Forest Rock|text='''block_blob'''}}|content={{#lst:Forest rock|config}}}}
 {{collapse|title={{BlockSprite|lit-cave-vines|link=Cave Vines (feature)|text='''block_column'''}}|content={{#lst:Cave Vines (feature)|config}}}}
 {{collapse|title={{EnvSprite|pile|link=Pile|text='''block_pile'''}}|content={{#lst:Pile|config}}}}
 {{collapse|title={{EnvSprite|delta|link=Delta|text='''delta_feature'''}}|content={{#lst:Delta|config}}}}
 {{collapse|title={{EnvSprite|disk|link=Disk|text='''disk'''}}|content={{#lst:Disk|config}}}}
-{{collapse|title={{BlockSprite|pointed-dripstone|link=Dripstone (feature)|text='''dripstone_cluster'''}}|content={{#lst:Dripstone (feature)|cluster config}}}}
 {{collapse|title={{EnvSprite|end-gateway|link=End Gateway|text='''end_gateway'''}}|content={{#lst:End gateway|config}}}}
 {{collapse|title={{EnvSprite|end-podium|link=End Podium|text='''end_podium'''}}|content={{#lst:End podium|config}}}}{{upcoming|JE 26.3}}
@@ Line 28: / Line 28: @@
 {{collapse|title={{EnvSprite|random-patch|link=Vegetation|text='''flower'''}}|content={{#lst:Vegetation|config}}}}
 {{collapse|title={{EnvSprite|fallen-oak|link=Fallen Tree|text='''fallen_tree'''}}|content={{#lst:Fallen tree|config}}}}
-{{collapse|title={{EnvSprite|forest-rock|link=Forest Rock|text='''forest_rock'''}}|content={{#lst:Forest rock|config}}}}
 {{collapse|title={{EnvSprite|fossil|link=Fossil|text='''fossil'''}}|content={{#lst:Fossil|config}}}}
 {{collapse|title={{EnvSprite|amethyst-geode|link=Amethyst Geode|text='''geode'''}}|content={{#lst:Amethyst geode|config}}}}
@@ Line 43: / Line 42: @@
 {{collapse|title={{EnvSprite|ore|link=Ore (feature)|text='''ore'''}}|content={{#lst:Ore (feature)|config}}}}
 {{collapse|title={{BlockSprite|air|link=Overlay|text='''overlay'''}}|content={{#lst:Overlay|config}}}}{{upcoming|JE 26.3}}
-{{collapse|title={{BlockSprite|pointed-dripstone|link=Dripstone (feature)|text='''pointed_dripstone'''}}|content={{#lst:Dripstone (feature)|pointed config}}}}
 {{collapse|title={{BlockSprite|air|link=projected Random Patchy Square|text='''projected_random_patchy_square'''}}|content={{#lst:Projected Random Patchy Square|config}}}}{{upcoming|JE 26.3}}
 {{collapse|title={{BlockSprite|air|link=Random boolean selector|text='''random_boolean_selector'''}}|content={{#lst:Random boolean selector|config}}}}
@@ Line 56: / Line 54: @@
 {{collapse|title={{BlockSprite|air|link=Simple block|text='''simple_block'''}}|content={{#lst:Simple block|config}}}}
 {{collapse|title={{BlockSprite|air|link=Simple random selector|text='''simple_random_selector'''}}|content={{#lst:Simple random selector|config}}}}
+{{collapse|title={{BlockSprite|pointed-dripstone|link=Dripstone (feature)|text='''speleothem'''}}|content={{#lst:Dripstone (feature)|pointed config}}}}
+{{collapse|title={{BlockSprite|pointed-dripstone|link=Dripstone (feature)|text='''speleothem_cluster'''}}|content={{#lst:Dripstone (feature)|cluster config}}}}
 {{collapse|title={{EnvSprite|ice-spike|link=Ice Spike|text='''spike'''}}|content={{#lst:Ice spike|config}}}}
 {{collapse|title={{EnvSprite|spring|link=Spring|text='''spring_feature'''}}|content={{#lst:Spring|config}}}}
@@ Line 90: / Line 90: @@
 |{{HistoryLine|java}}
 |{{HistoryLine||1.16.2|dev=20w28a|Added experimental support for configured features in data packs.}}
-|{{HistoryLine|||dev=20w29a|Renamed the <code>minecraft:decorated_flower</code> feature in <code>minecraft:no_bonemeal_flower</code>.}}
+|{{HistoryLine|||dev=20w29a|Renamed the {{cd|minecraft:decorated_flower}} feature in {{cd|minecraft:no_bonemeal_flower}}.}}
-|{{HistoryLine||1.17|dev=20w45a|Added <code>minecraft:geode</code> feature.}}
+|{{HistoryLine||1.17|dev=20w45a|Added {{cd|minecraft:geode}} feature.}}
-|{{HistoryLine|||dev=20w49a|Added <code>minecraft:dripstone_cluster</code>, <code>minecraft:large_dripstone</code>, and <code>minecraft:small_dripstone</code> features.}}
+|{{HistoryLine|||dev=20w49a|Added {{cd|minecraft:dripstone_cluster}}, {{cd|minecraft:large_dripstone}}, and {{cd|minecraft:small_dripstone}} features.}}
-|{{HistoryLine|||dev=21w03a|Added <code>minecraft:glow_lichen</code> feature type.}}
+|{{HistoryLine|||dev=21w03a|Added {{cd|minecraft:glow_lichen}} feature type.}}
-|{{HistoryLine||1.19|dev=22w11a|Added <code>block</code> field into <code>glow_lichen</code> (<code>multiface_growth</code>) feature config.
+|{{HistoryLine||1.19|dev=22w11a|Added {{cd|block}} field into {{cd|glow_lichen}} ({{cd|multiface_growth}}) feature config.|Added {{cd|minecraft:sculk_patch}} feature type.}}
-|Added <code>minecraft:sculk_patch</code> feature type.}}
 |{{HistoryLine|||dev=22w12a|Leaves are now waterloggable. And foliage placers now always waterlog the blocks when replacing water, if the foliage block has a waterlogged block state.}}
-|{{HistoryLine|||dev=22w13a|Added <code>extra_rare_growths</code> field into <code>sculk_patch</code> feature config.}}
+|{{HistoryLine|||dev=22w13a|Added {{cd|extra_rare_growths}} field into {{cd|sculk_patch}} feature config.}}
-|{{HistoryLine|||dev=22w14a|Renamed the <code>glow_lichen</code> feature type to <code>multiface_growth</code>.
+|{{HistoryLine|||dev=22w14a|Renamed the {{cd|glow_lichen}} feature type to {{cd|multiface_growth}}.
-|Added <code>surface_disk</code> feature type.
+|Added {{cd|surface_disk}} feature type.
-|Added <code>can_origin_replace</code> field into the <code>minecraft:disk</code> feature config. Must be a block ID or a block tag, or a list of block IDs. The feature origin must in these blocks to generate the feature.
+|Added {{cd|can_origin_replace}} field into the {{cd|minecraft:disk}} feature config. Must be a block ID or a block tag, or a list of block IDs. The feature origin must in these blocks to generate the feature.
-|Added <code>root_placer</code> field into the <code>minecraft:tree</code> feature config.
+|Added {{cd|root_placer}} field into the {{cd|minecraft:tree}} feature config.
-|Added <code>attached_to_leaves</code> decorator into the <code>minecraft:tree</code> feature config.
+|Added {{cd|attached_to_leaves}} decorator into the {{cd|minecraft:tree}} feature config.
-|Added <code>probability</code> field into the <code>leave_vine</code> decorator of the <code>minecraft:tree</code> feature config.
+|Added {{cd|probability}} field into the {{cd|leave_vine}} decorator of the {{cd|minecraft:tree}} feature config.
-|Added <code>upwards_branching_trunk_placer</code> trunk placer into the <code>minecraft:tree</code> feature config.}}
+|Added {{cd|upwards_branching_trunk_placer}} trunk placer into the {{cd|minecraft:tree}} feature config.}}
-|{{HistoryLine|||dev=22w15a|Merged the <code>surface_disk</code> and <code>ice_patch</code> feature types into the <code>disk</code> type.
+|{{HistoryLine|||dev=22w15a|Merged the {{cd|surface_disk}} and {{cd|ice_patch}} feature types into the {{cd|disk}} type.
-|Added <code>state_provider</code> and <code>targets</code> fields into the <code>minecraft:disk</code> feature config, replacing <code>state</code>, <code>targets</code> and <code>can_origin_replace</code> fields.
+|Added {{cd|state_provider}} and {{cd|targets}} fields into the {{cd|minecraft:disk}} feature config, replacing {{cd|state}}, {{cd|targets}} and {{cd|can_origin_replace}} fields.
-|Added <code>trunk_offset_y</code> and <code>above_root_placement</code> fields into the root placer in the <code>minecraft:tree</code> feature config.
+|Added {{cd|trunk_offset_y}} and {{cd|above_root_placement}} fields into the root placer in the {{cd|minecraft:tree}} feature config.
-|Removed the <code>y_offset</code> field of the <code>mangrove_root_placer</code> root placer in the <code>minecraft:tree</code> feature config. Moved all other additional fields of <code>mangrove_root_placer</code> into an object {{nbt|compound|mangrove_root_placement}}.}}
+|Removed the {{cd|y_offset}} field of the {{cd|mangrove_root_placer}} root placer in the {{cd|minecraft:tree}} feature config. Moved all other additional fields of {{cd|mangrove_root_placer}} into an object {{nbt|compound|mangrove_root_placement}}.}}
-|{{HistoryLine||1.19.4|dev=23w07a|Added <code>minecraft:cherry_foliage_placer</code> and <code>minecraft:cherry_trunk_placer</code> into the <code>minecraft:tree</code> feature config.}}
+|{{HistoryLine||1.19.4|dev=23w07a|Added {{cd|minecraft:cherry_foliage_placer}} and {{cd|minecraft:cherry_trunk_placer}} into the {{cd|minecraft:tree}} feature config.}}
-|{{HistoryLine||1.20|dev=23w17a|Added <code>replaceable_blocks</code> field into the <code>minecraft:huge_fungus</code> feature config.}}
+|{{HistoryLine||1.20|dev=23w17a|Added {{cd|replaceable_blocks}} field into the {{cd|minecraft:huge_fungus}} feature config.}}
-|{{HistoryLine||1.21.4|dev=24w44a|The <code>simple_block</code> feature type has a new optional field: <code>schedule_tick</code>.}}
+|{{HistoryLine||1.21.4|dev=24w44a|The {{cd|simple_block}} feature type has a new optional field: {{cd|schedule_tick}}.}}
-|{{HistoryLine||1.21.5|dev=25w09a|Added <code>attached_to_logs</code> field into the <code>minecraft:tree</code> feature config.}}
+|{{HistoryLine||1.21.5|dev=25w09a|Added {{cd|attached_to_logs}} field into the {{cd|minecraft:tree}} feature config.}}
-|{{HistoryLine||26.2|dev=snap1|{{cd|minecraft:geode}}: The fields {{cd|cannot_replace}} and {{cd|invalid_blocks}} in blocks section of feature configuration now also accept an ID and a list of IDs in addition to a tag.|{{cd|minecraft:root_system}}: The field {{cd|root_replaceable}} in the feature configuration now also accepts an ID or a list of IDs in addition to a tag.|{{cd|minecraft:vegetation_patch}}: The field {{cd|replaceable}} in the feature configuration now also accepts an ID and or a list of IDs in addition to a tag.|{{cd|minecraft:waterlogged_vegetation_patch}}: The field replaceable in the feature configuration now also accepts an ID and or a list of IDs in addition to a tag.}}
+|{{HistoryLine||26.1|dev=snap6|Renamed {{cd|forest_rock}} feature type to {{cd|block_blob}}.}}
+|{{HistoryLine||26.2|dev=snap1|{{cd|minecraft:geode}}: The fields {{cd|cannot_replace}} and {{cd|invalid_blocks}} in blocks section of feature configuration now also accept an ID and a list of IDs in addition to a tag.|{{cd|minecraft:root_system}}: The field {{cd|root_replaceable}} in the feature configuration now also accepts an ID or a list of IDs in addition to a tag.|{{cd|minecraft:vegetation_patch}}: The field {{cd|replaceable}} in the feature configuration now also accepts an ID and or a list of IDs in addition to a tag.|{{cd|minecraft:waterlogged_vegetation_patch}}: The field replaceable in the feature configuration now also accepts an ID and or a list of IDs in addition to a tag.|{{cd|pointed_dripstone}} has been renamed to {{cd|speleothem}}.|{{cd|dripstone_cluster}} has been renamed to {{cd|speleothem_cluster}}.|Added the {{cd|base_block}}, {{cd|pointed_block}}, and {{cd|replaceable_blocks}} fields to the renamed features, as well as the latter to {{cd|large_dripstone}}.|Additional speleothem fields have been renamed (e.g. {{cd|chance_of_taller_dripstone}} to {{cd|chance_of_taller_generation}}) to account for the name changes.}}
 |{{HistoryLine|||dev=snap5|{{cd|minecraft:multiface_growth}}: The field {{cd|block}} is now mandatory (defaulted to {{cd|minecraft:glow_lichen}}).}}
 |{{HistoryLine|||dev=snap6|Added the {{cd|minecraft:weighted_random_selector}} feature type.|{{cd|minecraft:large_dripstone}}: The maximum allowed value for {{cd|column_radius}} has been reduced from {{cd|19}} to {{cd|16}}.|{{cd|minecraft:root_system}}: Added {{cd|level_test_distance}} and {{cd|field max_level_deviation}} fields.}}
 |{{HistoryLine|upcoming java}}
 |{{HistoryLine||26.3|dev=snap1|The {{cd|worldgen/configured_feature}} registry has moved to {{cd|worldgen/feature}} and configuration is now done inline in the root object rather than separated into a config field.|Added {{cd|minecraft:end_podium}} feature type.|{{cd|minecraft:tree}} feature type: added {{cd|shelf_mushroom}} tree decorator type, added {{cd|poplar_foliage_placer}} foliage placer type, added {{cd|poplar_trunk_placer}} trunk placer type.}}
-|{{HistoryLine|||dev=snap2|Added {{cd|minecraft:overlay}} and {{cd|minecraft:projected_random_patchy_square}} feature types.}}
+|{{HistoryLine|||dev=snap2|Renamed the following feature types:
+* {{cd|basalt_columns}} to {{cd|stepped_column_cluster}}
+* {{cd|basalt_pillar}} to {{cd|single_block_pillar}}
+* {{cd|glowstone_blob}} to {{cd|random_neighbor_spread}}
+|Added {{cd|minecraft:overlay}} and {{cd|minecraft:projected_random_patchy_square}} feature types.}}
 |{{HistoryLine|||dev=snap3|Removed the following feature types:
 * {{cd|minecraft:coral_mushroom}}
@@ Line 124: / Line 128: @@
 * {{cd|minecraft:seagrass}}
 * {{cd|minecraft:sea_pickle}}
-}}
+|{{cd|minecraft:coral_claw}} and {{cd|minecraft:coral_tree}} feature types: Added the {{cd|feature}} field.}}
 |{{HistoryLine|||dev=snap4|Removed the following feature types:
 * {{cd|minecraft:nether_forest_vegetation}}
@@ Line 130: / Line 134: @@
 * {{cd|minecraft:weeping_vines}}
 }}
+|{{HistoryLine|||dev=snap5|{{cd|minecraft:sculk_patch}} feature type: Removed the {{cd|extra_rare_growths}} and {{cd|catalyst_chance}} fields.}}
 }}