Minecraft:Configured feature: Difference between revisions

Revision as of 11:15, 16 September 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 Template:Until / 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:Until 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 2: / Line 2: @@
 A '''configured feature''' is the configuration of a feature type. They can be used in '''[[Minecraft:placed feature]]s''' to define the [[Minecraft:feature]]s that are placed in a world.
-Configured features are stored as JSON files within a [[Minecraft:data pack]] in the {{cd|data/<namespace>/worldgen/configured_feature}}{{until|JE 26.3}} / {{cd|data/<namespace>/worldgen/feature}}{{upcoming|JE 26.3}} folder.
+Configured features are stored as JSON files within a [[Minecraft:data pack]] in the {{cd|data/<namespace>/worldgen/configured_feature}}{{until|JE 26.3}} / {{cd|data/<namespace>/worldgen/feature}} folder.
 == JSON format ==
@@ Line 23: / Line 23: @@
 {{collapse|title={{EnvSprite|disk|link=Disk|text='''disk'''}}|content={{#lst:Disk|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}}
+{{collapse|title={{EnvSprite|end-podium|link=End Podium|text='''end_podium'''}}|content={{#lst:End podium|config}}}}
 {{collapse|title={{EnvSprite|end-spike|link=End Spike|text='''end_spike'''}}|content={{#lst:End spike|config}}}}
 {{collapse|title={{BlockSprite|air|link=Fill layer|text='''fill_layer'''}}|content={{#lst:Fill layer|config}}}}
@@ Line 39: / Line 39: @@
 {{collapse|title={{EnvSprite|blob|link=Blob|text='''netherrack_replace_blobs'''}}|content={{#lst:Blob|config}}}}
 {{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|air|link=Overlay|text='''overlay'''}}|content={{#lst:Overlay|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=projected Random Patchy Square|text='''projected_random_patchy_square'''}}|content={{#lst:Projected Random Patchy Square|config}}}}
 {{collapse|title={{BlockSprite|air|link=Random boolean selector|text='''random_boolean_selector'''}}|content={{#lst:Random boolean selector|config}}}}
 {{collapse|title={{BlockSprite|air|link=Random selector|text='''random_selector'''}}|content={{#lst:Random selector|config}}}}
@@ Line 109: / Line 109: @@
 |{{HistoryLine||26.1|dev=snap6|Renamed {{cd|forest_rock}} feature type to {{cd|block_blob}}.}}
 |{{HistoryLine||26.1|Removed {{cd|random_patch}}, {{cd|flower}}, and {{cd|flower_no_bonemeal}} feature types. Instead, patches can be expressed as a sequence of {{cd|count}} and {{cd|random_offset}} placement modifiers.}}
-|{{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.|Added {{cd|minecraft:sequence}} feature type.|Added {{cd|minecraft:template}} feature type.}}|{{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|Renamed the following feature types:
+|{{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.|Added {{cd|minecraft:sequence}} feature type.|Added {{cd|minecraft:template}} feature type.}}|{{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||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|Renamed the following feature types:
 * {{cd|basalt_columns}} to {{cd|stepped_column_cluster}}
 * {{cd|basalt_pillar}} to {{cd|single_block_pillar}}