115 lines
10 KiB
Text
115 lines
10 KiB
Text
{{exclusive|java}}
|
|
A '''configured feature''' is the configuration of a feature type. They can be used in '''[[placed feature]]s''' to define the [[feature]]s that are placed in a world.
|
|
|
|
Configured features are stored as JSON files within a [[data pack]] in the {{cd|data/<namespace>/worldgen/configured_feature}} folder.
|
|
|
|
== JSON format ==
|
|
<div class="treeview">
|
|
* {{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.
|
|
</div>
|
|
|
|
== Feature types ==
|
|
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 configuation options.
|
|
|
|
{{Data transclude|env|Bamboo (feature)/Config|title=bamboo|link=Bamboo (feature)|sprite=block|icon=bamboo}}
|
|
{{Data transclude|env|Basalt columns/Config|title=basalt_columns|link=Basalt columns}}
|
|
{{Data transclude|env|Basalt pillar/Config|title=basalt_pillar|link=Basalt pillar}}
|
|
{{Data transclude|env|Cave Vines (feature)/Config|title=block_column|link=Cave Vines (feature)|sprite=block|icon=lit-cave-vines}}
|
|
{{Data transclude|env|Pile/Config|title=block_pile|link=Pile}}
|
|
{{Data transclude|env|Blue Ice (feature)/Config|title=blue_ice|link=Blue Ice (feature)|sprite=block|icon=blue-ice}}
|
|
{{Data transclude|env|Bonus Chest/Config|title=bonus_chest|link=Bonus Chest}}
|
|
{{Data transclude|env|Chorus plant/Config|title=chorus_plant|link=Chorus plant}}
|
|
{{Data transclude|env|Coral reef/Config|title=coral_claw|link=Coral reef}}
|
|
{{Data transclude|env|Coral reef/Config|title=coral_mushroom|link=Coral reef}}
|
|
{{Data transclude|env|Coral reef/Config|title=coral_tree|link=Coral reef}}
|
|
{{Data transclude|env|Delta/Config|title=delta_feature|link=Delta}}
|
|
{{Data transclude|env|Desert well/Config|title=desert_well|link=Desert Well}}
|
|
{{Data transclude|env|Disk/Config|title=disk|link=Disk}}
|
|
{{Data transclude|env|Dripstone Cluster/Config|title=dripstone_cluster|link=Dripstone (feature)|sprite=block|icon=pointed-dripstone}}
|
|
{{Data transclude|env|End gateway/Config|title=end_gateway|link=End gateway}}
|
|
{{Data transclude|env|Small island/Config|title=end_island|link=Small island}}
|
|
{{Data transclude|env|End platform/Config|title=end_platform|link=End platform|icon=obsidian-platform}}
|
|
{{Data transclude|env|End spike/Config|title=end_spike|link=End spike}}
|
|
{{Data transclude|env|Fill layer/Config|title=fill_layer|link=Fill layer|sprite=block|icon=air}}
|
|
{{Data transclude|env|Random patch/Config|title=flower|link=Vegetation}}
|
|
{{Data transclude|env|Forest rock/Config|title=forest_rock|link=Forest rock}}
|
|
{{Data transclude|env|Fossil/Config|title=fossil|link=Fossil}}
|
|
{{Data transclude|env|Freeze top layer/Config|title=freeze_top_layer|link=Freeze top layer}}
|
|
{{Data transclude|env|Amethyst geode/Config|title=geode|link=Amethyst geode}}
|
|
{{Data transclude|env|Glowstone blob/Config|title=glowstone_blob|link=Glowstone blob}}
|
|
{{Data transclude|env|Huge mushroom/Config|title=huge_brown_mushroom|link=Huge mushroom}}
|
|
{{Data transclude|env|Huge fungus/Config|title=huge_fungus|link=Huge fungus}}
|
|
{{Data transclude|env|Huge mushroom/Config|title=huge_red_mushroom|link=Huge mushroom}}
|
|
{{Data transclude|env|Iceberg (feature)/Config|title=iceberg|link=Iceberg (feature)|icon=iceberg}}
|
|
{{Data transclude|env|Ice spike/Config|title=ice_spike|link=Ice spike}}
|
|
{{Data transclude|env|Kelp (feature)/Config|title=kelp|link=Kelp (feature)|sprite=block|icon=kelp-plant}}
|
|
{{Data transclude|env|Lava lake/Config|title=lake|link=Lava lake}}
|
|
{{Data transclude|env|Large dripstone/Config|title=large_dripstone|link=Dripstone (feature)|icon=large-dripstone}}
|
|
{{Data transclude|env|Monster room/Config|title=monster_room|link=Monster Room}}
|
|
{{Data transclude|env|Multiface growth/Config|title=multiface_growth|link=Sculk Vein (feature)|sprite=block|icon=sculk-vein}}
|
|
{{Data transclude|env|Nether forest vegetation/Config|title=nether_forest_vegetation|link=Nether forest vegetation|sprite=block|icon=all-nether-roots}}
|
|
{{Data transclude|env|Blob/Config|title=netherrack_replace_blobs|link=Blob}}
|
|
{{Data transclude|env|Random patch/Config|title=no_bonemeal_flower|link=Vegetation}}
|
|
{{Data transclude|env|No op/Config|title=no_op|sprite=block|icon=air}}
|
|
{{Data transclude|env|Ore (feature)/Config|title=ore|link=Ore (feature)|icon=ore}}
|
|
{{Data transclude|env|Pointed dripstone/Config|title=pointed_dripstone|link=Dripstone (feature)|sprite=block|icon=pointed-dripstone}}
|
|
{{Data transclude|env|Random boolean selector/Config|title=random_boolean_selector|link=Random boolean selector|sprite=block|icon=air}}
|
|
{{Data transclude|env|Random selector/Config|title=random_selector|link=Random selector|sprite=block|icon=air}}
|
|
{{Data transclude|env|Random patch/Config|title=random_patch|link=Vegetation}}
|
|
{{Data transclude|env|Replace single block/Config|title=replace_single_block|link=Replace single block|sprite=block|icon=air}}
|
|
{{Data transclude|env|Root system/Config|title=root_system|link=Root system|sprite=block|icon=rooted-dirt}}
|
|
{{Data transclude|env|Ore (feature)/Config|title=scattered_ore|link=Ore (feature)|icon=ore}}
|
|
{{Data transclude|env|Sculk patch/Config|title=sculk_patch|link=Sculk patch|sprite=block|icon=sculk-vein}}
|
|
{{Data transclude|env|Seagrass (feature)/Config|title=seagrass|link=Seagrass (feature)|sprite=block|icon=seagrass}}
|
|
{{Data transclude|env|Sea Pickle (feature)/Config|title=sea_pickle|link=Sea Pickle (feature)|sprite=block|icon=sea-pickle}}
|
|
{{Data transclude|env|Simple block/Config|title=simple_block|link=Simple block|sprite=block|icon=air}}
|
|
{{Data transclude|env|Simple random selector/Config|title=simple_random_selector|link=Simple random selector|sprite=block|icon=air}}
|
|
{{Data transclude|env|Spring/Config|title=spring_feature|link=Spring}}
|
|
{{Data transclude|env|Tree/Config|title=tree|link=Tree}}
|
|
{{Data transclude|env|Twisting Vines (feature)/Config|title=twisting_vines|link=Twisting Vines (feature)|sprite=block|icon=twisting-vines-plant}}
|
|
{{Data transclude|env|Underwater magma/Config|title=underwater_magma|link=Underwater magma|sprite=block|icon=magma-block}}
|
|
{{Data transclude|env|Vegetation patch/Config|title=vegetation_patch|link=Vegetation patch|sprite=block|icon=moss-block}}
|
|
{{Data transclude|env|Vines (feature)/Config|title=vines|link=Vines (feature)|sprite=block|icon=vines}}
|
|
{{Data transclude|env|Void start platform/Config|title=void_start_platform|link=Void start platform}}
|
|
{{Data transclude|env|Vegetation patch/Config|title=waterlogged_vegetation_patch|link=Vegetation patch|sprite=block|icon=moss-block}}
|
|
{{Data transclude|env|Weeping Vines (feature)/Config|title=weeping_vines|link=Weeping Vines (feature)|sprite=block|icon=weeping-vines-plant}}
|
|
|
|
== History ==
|
|
{{HistoryTable
|
|
|{{HistoryLine|java}}
|
|
|{{HistoryLine||1.16.2|dev=20w28a|Added experimental support for configured features in data packs.}}
|
|
|{{HistoryLine||1.16.2|dev=20w29a|Renamed the <code>minecraft:decorated_flower</code> feature in <code>minecraft:no_bonemeal_flower</code>.}}
|
|
|{{HistoryLine||1.17|dev=20w45a|Added <code>minecraft:geode</code> feature.}}
|
|
|{{HistoryLine||1.17|dev=20w49a|Added <code>minecraft:dripstone_cluster</code>, <code>minecraft:large_dripstone</code>, and <code>minecraft:small_dripstone</code> features.}}
|
|
|{{HistoryLine||1.17|dev=21w03a|Added <code>minecraft:glow_lichen</code> feature type.}}
|
|
|{{HistoryLine||1.19|dev=22w11a|Added <code>block</code> field into <code>glow_lichen</code> (<code>multiface_growth</code>) feature config.
|
|
|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=22w14a|Renamed the <code>glow_lichen</code> feature type to <code>multiface_growth</code>.
|
|
|Added <code>surface_disk</code> 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 <code>root_placer</code> field into the <code>minecraft:tree</code> feature config.
|
|
|Added <code>attached_to_leaves</code> decorator into the <code>minecraft:tree</code> feature config.
|
|
|Added <code>probability</code> field into the <code>leave_vine</code> decorator of the <code>minecraft:tree</code> feature config.
|
|
|Added <code>upwards_branching_trunk_placer</code> trunk placer into the <code>minecraft:tree</code> feature config.}}
|
|
|{{HistoryLine|||dev=22w15a|Merged the <code>surface_disk</code> and <code>ice_patch</code> feature types into the <code>disk</code> 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 <code>trunk_offset_y</code> and <code>above_root_placement</code> fields into the root placer in the <code>minecraft:tree</code> 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}}.}}
|
|
|{{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.20|dev=23w17a|Added <code>replaceable_blocks</code> field into the <code>minecraft:huge_fungus</code> feature config.}}
|
|
|{{HistoryLine||1.21.4|dev=24w44a|The <code>simple_block</code> feature type has a new optional field: <code>schedule_tick</code>.}}
|
|
}}
|
|
|
|
== External links ==
|
|
* [https://misode.github.io/worldgen/feature/ Configured feature Generator on misode.github.io]
|
|
|
|
== Navigation ==
|
|
{{Navbox Java Edition technical|datapack}}
|
|
|
|
[[fr:Élément du terrain configuré]]
|
|
[[ja:生成物のカスタマイズ]]
|
|
[[zh:地物数据格式]]
|