Configured feature
This feature is exclusive to Java Edition.
A configured feature is the configuration of a feature type. They can be used in placed features to define the features that are placed in a world.
Configured features are stored as JSON files within a data pack in the data/<namespace>/worldgen/configured_feature folder.
JSON format
- [NBT Compound / JSON Object]: Root object.
- [String] type: The ID of feature type.
- [NBT Compound / JSON Object] config: Configuration of this configured feature. The properties depend on the value of [String] type, described below.
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 configuration options.
- [NBT Compound / JSON Object] config
- [Float] probability The probability for a podzol disk to generate below the bamboo. The disk has a radius of 1 to 4 blocks. Value between 0.0 and 1.0 (inclusive).
- [NBT Compound / JSON Object] config
- [Int][NBT Compound / JSON Object] reach The max radius of a column in this column cluster. Value between 0 and 3 (inclusive).
- Int provider see Template:Nbt inherit/int_provider/template
- [Int][NBT Compound / JSON Object] height The max height is
height + 1. Value between 1 and 10 (inclusive).- Int provider see Template:Nbt inherit/int_provider/template
- [Int][NBT Compound / JSON Object] reach The max radius of a column in this column cluster. Value between 0 and 3 (inclusive).
- [NBT Compound / JSON Object] config
- [String] direction The direction of the column. One of
up,down,north,east,south, orwest. - [NBT Compound / JSON Object] allowed_placement A block predicate that must be passed for each position of the column.
- [String] type: The type of the block predicate. See Block predicate § Types for options.
- additional fields depending on [String] type. See Block predicate § Types.
- [Boolean] prioritize_tip Determines where to cut off blocks when space is restricted. If
true, starts removing layers from the start of the column. - [NBT List / JSON Array] layers (Required, but can be empty) The layers of this column.
- [NBT Compound / JSON Object] A layer.
- [Int][NBT Compound / JSON Object] height Specifying the height of the layer. Must be a non-negative int.
- Int provider see Template:Nbt inherit/int_provider/template
- [NBT Compound / JSON Object] provider The block to use for this layer.
- Block state provider see Template:Nbt inherit/block state provider/template
- [Int][NBT Compound / JSON Object] height Specifying the height of the layer. Must be a non-negative int.
- [NBT Compound / JSON Object] A layer.
- [String] direction The direction of the column. One of
- [NBT Compound / JSON Object] config
- [NBT Compound / JSON Object] state_provider The block to use.
- Block state provider see Template:Nbt inherit/block state provider/template
- [NBT Compound / JSON Object] state_provider The block to use.
[NBT Compound / JSON Object] config
- [NBT Compound / JSON Object] contents The block to use on the inside of the delta.
- Block state see Template:Nbt inherit/block state/template
- [NBT Compound / JSON Object] rim The block to use for the rim of the delta.
- Block state see Template:Nbt inherit/block state/template
- [Int][NBT Compound / JSON Object] size The size of the inside of the delta. Value between 0 and 16 (inclusive).
- Int provider see Template:Nbt inherit/int_provider/template
- [Int][NBT Compound / JSON Object] rim_size The size of the rim of the delta. Value between 0 and 16 (inclusive).
- Int provider see Template:Nbt inherit/int_provider/template
- [NBT Compound / JSON Object] contents The block to use on the inside of the delta.
The only rule for which blocks the delta feature can replace (via the 'contents' or 'rim' block state) is that the target block must have one air block above it and no horizontally-adjacent air blocks. One consequence of this is that delta features cannot generate underwater, but can generate on the water's surface if the feature placement is on the same y-level.
Delta features are always generated last regardless of the order specified by their biome's generation step. In effect, this means that delta blocks can be overridden by features such as tall grass, often resulting in a splotchy appearance.
- [NBT Compound / JSON Object] config
- [NBT Compound / JSON Object] state_provider The block to use.
- [NBT Compound / JSON Object] fallback The block to use when all the rules' predicates are not passed.
- Block state provider see Template:Nbt inherit/block state provider/template
- [NBT List / JSON Array] rules (Required, but can be empty) Rules of the block to use.
- [NBT Compound / JSON Object] One rule.
- [NBT Compound / JSON Object] if_true The block predicate of this rule.
- [String] type: The type of the block predicate. See Block predicate § Types for options.
- additional fields depending on [String] type. See Block predicate § Types.
- [NBT Compound / JSON Object] then The block to use when the predicate is passed.
- Block state provider see Template:Nbt inherit/block state provider/template
- [NBT Compound / JSON Object] if_true The block predicate of this rule.
- [NBT Compound / JSON Object] One rule.
- [NBT Compound / JSON Object] fallback The block to use when all the rules' predicates are not passed.
- [Int][NBT Compound / JSON Object] radius The radius of this disk. Value between 0 and 8 (inclusive).
- Int provider see Template:Nbt inherit/int_provider/template
- [Int] half_height Half of the height of this disk. Value between 0 and 4 (inclusive).
- [NBT Compound / JSON Object] target A block predicate that must be passed to generate this feature.
- [String] type: The type of the block predicate. See Block predicate § Types for options.
- additional fields depending on [String] type. See Block predicate § Types.
- [NBT Compound / JSON Object] state_provider The block to use.
- [NBT Compound / JSON Object] config
- [Int] floor_to_ceiling_search_range For how many blocks the feature searches for the floor or ceiling. Value between 1 and 512 (inclusive).
- [Int][NBT Compound / JSON Object] height The height of the cluster. Value between 1 and 128 (inclusive).
- Int provider see Template:Nbt inherit/int_provider/template
- [Int][NBT Compound / JSON Object] radius The radius of the cluster. Value between 1 and 128 (inclusive).
- Int provider see Template:Nbt inherit/int_provider/template
- [Int] max_stalagmite_stalactite_height_diff The maximum height difference between stalagmites and stalactites. Value between 0 and 64 (inclusive).
- [Int] height_deviation The height deviation. Value between 1 and 64 (inclusive).
- [Int][NBT Compound / JSON Object] dripstone_block_layer_thickness The dripstone block layer's thickness. Value between 0 and 128 (inclusive).
- Int provider see Template:Nbt inherit/int_provider/template
- [Float][NBT Compound / JSON Object] density Value between 0.0 and 2.0 (inclusive).
- Float provider see Template:Nbt inherit/float_provider/template
- [Float][NBT Compound / JSON Object] wetness Value between 0.0 and 2.0 (inclusive).
- Float provider see Template:Nbt inherit/float_provider/template
- [Float] chance_of_dripstone_column_at_max_distance_from_center Value between 0.0 and 1.0 (inclusive).
- [Int] max_distance_from_edge_affecting_chance_of_dripstone_column Value between 1 and 64 (inclusive).
- [Int] max_distance_from_center_affecting_height_bias Value between 1 and 64 (inclusive).
- [NBT Compound / JSON Object] config
- [Boolean] exact: Whether the gateway should teleport entities to the exact exit position.
- [NBT List / JSON Array] exit: (optional) The block position where the gateway should exit.
- [Int] X coordinate.
- [Int] Y coordinate.
- [Int] Z coordinate.
- [NBT Compound / JSON Object] config
- [Boolean] crystal_invulnerable (optional, defaults to false) Whether the end crystals on it are invulnerable.
- [NBT List / JSON Array] crystal_beam_target (optional) Block position of the beam target.
- [Int] The X coordinate.
- [Int] The Y coordinate.
- [Int] The Z coordinate.
- [NBT List / JSON Array] spikes (Required, but can be empty. If empty, uses the default random spikes) Configurations of each spike.
- [NBT Compound / JSON Object] A spike.
- [Int] centerX (optional, defaults to 0) The X coordinate.
- [Int] centerZ (optional, defaults to 0) The Z coordinate.
- [Int] radius (optional, defaults to 0) The radius of the spike.
- [Int] height (optional, defaults to 0) The height of the spike.
- [Boolean] guarded (optional, defaults to false) Whether to generate an iron bar cage around the crystal.
- [NBT Compound / JSON Object] A spike.
- [NBT Compound / JSON Object] config
- [NBT Compound / JSON Object] state The block to fill with.
- Block state see Template:Nbt inherit/block state/template
- [Int] height The layer to fill, starting at the bottom of the world. Value between 0 and 4064 (inclusive).
- [NBT Compound / JSON Object] state The block to fill with.
- [NBT Compound / JSON Object] config
- [Int] tries: (optional, defaults to 128) The number of attempts to generate. Must be a positive integer.
- [Int] xz_spread: (optional, defaults to 7) The horizontal spread range. Must be a non-negative integer.
- [Int] y_spread: (optional, defaults to 3) The vertical spread range. Must be a non-negative integer.
- [String][NBT Compound / JSON Object] feature: One placed feature (an [String] ID, or a new [NBT Compound / JSON Object] placed feature definition) — The placed feature that this patch generates.
- [NBT Compound / JSON Object] config
- [NBT Compound / JSON Object] trunk_provider The block to use for the trunk.
- Block state provider see Template:Nbt inherit/block state provider/template
- [Int][NBT Compound / JSON Object] log_length The length of the fallen log. Value between 0 and 16 (inclusive).
- Int provider see Template:Nbt inherit/int_provider/template
- [NBT List / JSON Array] log_decorators (Required, but can be empty) Decorations to add to fallen log of the tree
- [NBT Compound / JSON Object] A decorator, see Tree definition § Decorator
- [NBT List / JSON Array] stump_decorators (Required, but can be empty) Decorations to add to the stump.
- [NBT Compound / JSON Object] A decorator, see Tree definition § Decorator
- [NBT Compound / JSON Object] trunk_provider The block to use for the trunk.
- [NBT Compound / JSON Object] config
- [NBT Compound / JSON Object] state The blockstate to use.
- Block state see Template:Nbt inherit/block state/template
- [NBT Compound / JSON Object] state The blockstate to use.
- [NBT Compound / JSON Object] config
- [NBT List / JSON Array] fossil_structures: (Cannot be empty) A list of fossil structure templates to choose from.
- [String]: One structure template (an [String] ID)
- [NBT List / JSON Array] overlay_structures: (Cannot be empty) A list of overlay structure templates to choose from. Has to have the same length as [NBT List / JSON Array] fossil_structures.
- [String]: One structure template (an [String] ID)
- [String][NBT List / JSON Array][NBT Compound / JSON Object] fossil_processors: One processor list (an [String] ID, or a new [NBT List / JSON Array][NBT Compound / JSON Object] processor list definition) — The processor for fossil structure templates.
- [String][NBT List / JSON Array][NBT Compound / JSON Object] overlay_processors: One processor list (an [String] ID, or a new [NBT List / JSON Array][NBT Compound / JSON Object] processor list definition) — The processor for overlay structure templates.
- [Int] max_empty_corners_allowed: Integer between 0 and 7 — How many corners of the structure are allowed to be empty for it to generate. Prevents structures floating in the air.
- [NBT List / JSON Array] fossil_structures: (Cannot be empty) A list of fossil structure templates to choose from.
- The placement of 'fossil' structures is hardcoded to be roughly 5 to 30 blocks below the surface, and cannot be precisely specified.
- [NBT Compound / JSON Object] config
- [NBT Compound / JSON Object] blocks The blocks used for the geode.
- [NBT Compound / JSON Object] filling_provider The blockstate provider used for the 'filling' layer. This is air in vanilla geodes.
- Block state provider see Template:Nbt inherit/block state provider/template
- [NBT Compound / JSON Object] inner_layer_provider The blockstate provider used for the inner layer. This is an 'amethyst block' in vanilla geodes.
- Block state provider see Template:Nbt inherit/block state provider/template
- [NBT Compound / JSON Object] alternate_inner_layer_provider The blockstate provider used for the inner layer 'alternate' block. This is a 'budding amethyst' block in vanilla geodes
- Block state provider see Template:Nbt inherit/block state provider/template
- [NBT Compound / JSON Object] middle_layer_provider The blockstate provider used for the middle layer. This is calcite in vanilla geodes.
- Block state provider see Template:Nbt inherit/block state provider/template
- [NBT Compound / JSON Object] outer_layer_provider The blockstate provider used for the outer layer. This is smooth basalt in vanilla geodes
- Block state provider see Template:Nbt inherit/block state provider/template
- [NBT List / JSON Array] inner_placements (At least one blockstate entry required) The blockstates placed within the geode, adjacent to the 'alternate_inner_layer_provider' block(s) by default. In vanilla geodes there are 4 entries, for 'small_amethyst_bud', 'medium_amethyst_bud', 'large_amethyst_bud' and 'amethyst_cluster'.
- [NBT Compound / JSON Object] A block state.
- Block state see Template:Nbt inherit/block state/template
- [NBT Compound / JSON Object] A block state.
- [String] cannot_replace A block tag listing which blocks not to replace. The tag used by vanilla geodes is
#minecraft:features_cannot_replace. - [String] invalid_blocks A block tag listing invalid blocks. Due to MC-264886, any value is treated as
#minecraft:geode_invalid_blocks. Additionally, air is an invalid block.
- [NBT Compound / JSON Object] filling_provider The blockstate provider used for the 'filling' layer. This is air in vanilla geodes.
- [NBT Compound / JSON Object] layers The thickness of each layer. Unknown units, seems to be non-linear. Larger values generate larger geodes. Values smaller than precisely 0.01 seem to be broken, resulting in much larger geodes than expected.
- [Double] filling (optional, defaults to 1.7) Value between 0.01 and 50 (inclusive).
- [Double] inner_layer (optional, defaults to 2.2) Value between 0.01 and 50 (inclusive).
- [Double] middle_layer (optional, defaults to 3.2) Value between 0.01 and 50 (inclusive).
- [Double] outer_layer (optional, defaults to 4.2) Value between 0.01 and 50 (inclusive).
- [NBT Compound / JSON Object] crack The configuration of the crack on the geode.
- [Double] generate_crack_chance (optional, defaults to 1.0) The probability for generating crack. Value between 0.0 and 1.0 (inclusive).
- [Double] base_crack_size (optional, defaults to 2) Value between 0.0 and 5.0 (inclusive).
- [Int] crack_point_offset (optional, defaults to 2) Value between 0 and 10 (inclusive).
- [Double] noise_multiplier (optional, defaults to 0.05) Value between 0.0 and 1.0 (inclusive).
- [Double] use_potential_placements_chance (optional, defaults to 0.35) The probability for placing the inner placement on a block of inner layer. Value between 0 and 1 (inclusive).
- [Double] use_alternate_layer0_chance (optional, defaults to 0.0) The chance for a given 'inner_layer_provider' block to be replaced with an 'alternate_inner_layer_provider' block. Value between 0 and 1 (inclusive).
- [Boolean] placements_require_layer0_alternate (optional, defaults to true) Whether the 'inner_placements' block(s) can only be placed on an 'alternate_inner_layer_provider' block.
- [Int][NBT Compound / JSON Object] outer_wall_distance (optional, defaults to a uniform int between 4 and 5) The offset on each coordinate of the center from the feature start. Value between 1 and 20 (inclusive).
- Int provider see Template:Nbt inherit/int_provider/template
- [Int][NBT Compound / JSON Object] distribution_points (optional, defaults to a uniform int between 3 and 4) Value between 1 and 20 (inclusive).
- Int provider see Template:Nbt inherit/int_provider/template
- [Int] invalid_blocks_threshold Check
distribution_pointstimes near the center of the geode, and if the number of invalid blocks found exceeds this number, the feature will not be generated. - [Int][NBT Compound / JSON Object] point_offset (optional, defaults to a uniform int between 1 and 2) Value between 1 and 10.
- Int provider see Template:Nbt inherit/int_provider/template
- [Int] min_gen_offset (optional, defaults to -16) The minimum Chebyshev distance between the block and the center.
- [Int] max_gen_offset (optional, defaults to 16) The maximum Chebyshev distance between the block and the center.
- [NBT Compound / JSON Object] blocks The blocks used for the geode.
Unlike ore features, geode features are always centered on their bottom northwest corner. For this reason, any placement predicates should be offset by the geode's average radius in order to perform checks on the proper location.
The 'min_gen_offset' and 'max_gen_offset' values determines the geode's cutoff size. Values greater than the default of ±16 slightly increase the effective cutoff size for very large geodes, though the size is ultimately limited to within the adjacent chunks.
- [NBT Compound / JSON Object] config
- [NBT Compound / JSON Object] cap_provider The block to use for the cap.
- Block state provider see Template:Nbt inherit/block state provider/template
- [NBT Compound / JSON Object] stem_provider The block to use for the stem.
- Block state provider see Template:Nbt inherit/block state provider/template
- [Int] foliage_radius (optional，defaults to 2) The size of the cap.
- [NBT Compound / JSON Object] cap_provider The block to use for the cap.
- [NBT Compound / JSON Object] config
- [NBT Compound / JSON Object] hat_state The block to use for the hat.
- Block state see Template:Nbt inherit/block state/template
- [NBT Compound / JSON Object] decor_state The block to use as decoration.
- Block state see Template:Nbt inherit/block state/template
- [NBT Compound / JSON Object] stem_state The block to use for the stem.
- Block state see Template:Nbt inherit/block state/template
- [NBT Compound / JSON Object] valid_base_block The block to place this feature on.
- Block state see Template:Nbt inherit/block state/template
- [Boolean] planted (optional, defaults to false) Whether this huge fungus is planted. If false, it can't exceed the world ceiling, can replace blocks whose material is
plant, and doesn't drop items when replaced by other blocks. - [NBT Compound / JSON Object] replaceable_blocks A block predicate. The predicate must pass for a block to be replaced by this feature.
- [String] type: The type of the block predicate. See Block predicate § Types for options.
- additional fields depending on [String] type. See Block predicate § Types.
- [NBT Compound / JSON Object] hat_state The block to use for the hat.
- [NBT Compound / JSON Object] config
- [NBT Compound / JSON Object] cap_provider The block to use for the cap.
- Block state provider see Template:Nbt inherit/block state provider/template
- [NBT Compound / JSON Object] stem_provider The block to use for the stem.
- Block state provider see Template:Nbt inherit/block state provider/template
- [Int] foliage_radius (optional，defaults to 2) The size of the cap.
- [NBT Compound / JSON Object] cap_provider The block to use for the cap.
- [NBT Compound / JSON Object] config
- [NBT Compound / JSON Object] state The block to use.
- Block state see Template:Nbt inherit/block state/template
- [NBT Compound / JSON Object] state The block to use.
- [NBT Compound / JSON Object] config
- [NBT Compound / JSON Object] fluid The block to use for the fluid of the lake.
- Block state provider see Template:Nbt inherit/block state provider/template
- [NBT Compound / JSON Object] barrier The block to use for the barrier of the lake. If 'air' is specified, the barrier remains unchanged instead of overwriting any existing blocks.
- Block state provider see Template:Nbt inherit/block state provider/template
- [NBT Compound / JSON Object] fluid The block to use for the fluid of the lake.
Note that lake features are generated on their northwest corner, with the actual center of the lake being offset from the placement position by +8 blocks on both the X and Z axes. It's recommended to counteract this by applying an xz_spread offset of -8 blocks to placed lake features before performing any additional checks such as block predicate filters.
Lake features require a sufficient amount of solid blocks in order to generate, including (but not limited to) a solid base at least 3 blocks thick (starting from one block below the placement position). The fluid level of generated lake features is always one block below the placement position.
Noise-type blockstate providers apply a single blockstate for the entire lake based on its placement position rather than the position of the lake's individual constituent blocks.
Lake features exhibit a bug in which the freeze top layer feature type is only applied to portions of the lake that are within the chunk from which the lake feature originates. In effect, this means that usually only the north-west corner of water lakes are iced over in snowy biomes. This bug (among others) is most likely why water lakes were deprecated following the worldgen changes in the caves & cliffs update.
- [NBT Compound / JSON Object] config
- [Int] floor_to_ceiling_search_range (optional, defaults to 30) The search range from start point to cave floor or ceiling (rather than from floor to ceiling). Value between 1 and 512 (inclusive).
- [Int][NBT Compound / JSON Object] column_radius Used to provide a min and max value for radius. Note that this int provider doesn't provide a single int, but provides the min and max value of the specified distribution. Value between 1 and 60 (inclusive). See the graph for details.
- Int provider see Template:Nbt inherit/int_provider/template
- [Float][NBT Compound / JSON Object] height_scale Higher value leads to higher height. Value between 0.0 and 20.0 (inclusive).
- Float provider see Template:Nbt inherit/float_provider/template
- [Float] max_column_radius_to_cave_height_ratio The ratio of the max radius to the height of the cave. Value between 0.0 and 1.0 (inclusive).
- [Float][NBT Compound / JSON Object] stalactite_bluntness Truncate the tip of stalactite. Higher value leads to lower height. Value between 0.1 and 10.0 (inclusive).
- Float provider see Template:Nbt inherit/float_provider/template
- [Float][NBT Compound / JSON Object] stalagmite_bluntness Truncate the tip of stalagmite. Higher value leads to lower height. Value between 0.1 and 10.0 (inclusive).
- Float provider see Template:Nbt inherit/float_provider/template
- [Float][NBT Compound / JSON Object] wind_speed Larger value results in larger inclination. Value between 0.0 and 2.0 (inclusive).
- Float provider see Template:Nbt inherit/float_provider/template
- [Int] min_radius_for_wind The min column radius to used for the wind. Value between 0 and 100.
- [Float] min_bluntness_for_wind The min value of the bluntnesses to used for the wind. Value between 0.0 and 5.0 (inclusive).
- [NBT Compound / JSON Object] config
- [String] block (optional, defaults to
glow_lichen) The block to place, currently must beglow_lichenorsculk_vein. - [Int] search_range (optional, defaults to 10) Value between 1 and 64 (inclusive).
- [Float] chance_of_spreading (optional, defaults to 0.5) Value between 0.0 and 1.0 (inclusive).
- [Boolean] can_place_on_floor (optional, defaults to false).
- [Boolean] can_place_on_ceiling (optional, defaults to false).
- [Boolean] can_place_on_wall (optional, defaults to false).
- [String][NBT List / JSON Array] can_be_placed_on Can be a block ID or a block tag, or a list of block IDs.
- [String] block (optional, defaults to
- [NBT Compound / JSON Object] config
- [NBT Compound / JSON Object] state_provider The block to use.
- Block state provider see Template:Nbt inherit/block state provider/template
- [Int] spread_width The horizonal distance to spread to. The max width is
spread_width * 2 -1. Must be a positive integer. - [Int] spread_height The vertical distance to spread. The max height is
spread_height * 2 -1. Must be a positive integer.
- [NBT Compound / JSON Object] state_provider The block to use.
- [NBT Compound / JSON Object] config
- [NBT Compound / JSON Object] state The block to use.
- Block state see Template:Nbt inherit/block state/template
- [NBT Compound / JSON Object] target The block to replace.
- Block state see Template:Nbt inherit/block state/template
- [Int][NBT Compound / JSON Object] radius Value between 0 and 12 (inclusive).
- Int provider see Template:Nbt inherit/int_provider/template
- [NBT Compound / JSON Object] state The block to use.
- [NBT Compound / JSON Object] config
- [Int] tries: (optional, defaults to 128) The number of attempts to generate. Must be a positive integer.
- [Int] xz_spread: (optional, defaults to 7) The horizontal spread range. Must be a non-negative integer.
- [Int] y_spread: (optional, defaults to 3) The vertical spread range. Must be a non-negative integer.
- [String][NBT Compound / JSON Object] feature: One placed feature (an [String] ID, or a new [NBT Compound / JSON Object] placed feature definition) — The placed feature that this patch generates.
- [NBT Compound / JSON Object] config
- [Int] size Value between 0 and 64 (inclusive). Determines the size of the ore vein. Further details on the relationship between 'size' and the actual number of blocks comprising the ore vein is available here.
- [Float] discard_chance_on_air_exposure Value between 0 and 1 (inclusive). The chance for the entire ore vein to be discarded if any constituent block is adjacent to an air block. Other non-solid blocks such as water do not count.
- [NBT List / JSON Array] targets (required, but can be empty) A list of targets.
- [NBT Compound / JSON Object] A target.
- [NBT Compound / JSON Object] target A rule test to check the block to replace.
- [NBT Compound / JSON Object] state The block to use.
- Block state see Template:Nbt inherit/block state/template
- [NBT Compound / JSON Object] A target.
Note that ore features (if allowed to generate in air) will not generate without a solid block nearby to act as the starting point. The ore feature does not necessarily have to intersect with this point, but the required distance does seem to scale with the ore size.
- [NBT Compound / JSON Object] config
- [Float] chance_of_taller_dripstone (optional, defaults to 0.2) Value between 0.0 and 1.0 (inclusive). Probability for double-block dripstone.
- [Float] chance_of_directional_spread (optional, defaults to 0.7) Value between 0.0 and 1.0 (inclusive). Probability that the dripstone spreads in a horizontal direction.
- [Float] chance_of_spread_radius2 (optional, defaults to 0.5) Value between 0.0 and 1.0 (inclusive). Probability of horizontal spread by two blocks.
- [Float] chance_of_spread_radius3 (optional, defaults to 0.5) Value between 0.0 and 1.0 (inclusive). After the spread by two blocks, probability of spreading the third block.
- [NBT Compound / JSON Object] config
- [String][NBT Compound / JSON Object] feature_false: One placed feature (an [String] ID, or a new [NBT Compound / JSON Object] placed feature definition)
- [String][NBT Compound / JSON Object] feature_true: One placed feature (an [String] ID, or a new [NBT Compound / JSON Object] placed feature definition)
- [NBT Compound / JSON Object] config
- [String][NBT Compound / JSON Object] default: One placed feature (an [String] ID, or a new [NBT Compound / JSON Object] placed feature definition) — Used if none of the below features are chosen.
- [NBT List / JSON Array] features: (Required, but can be empty) A list of placed features from which to randomly choose.
- [NBT Compound / JSON Object]: A feature and its corresponding chance.
- [String][NBT Compound / JSON Object] feature: One placed feature (an [String] ID, or a new [NBT Compound / JSON Object] placed feature definition)
- [Float] chance: The chance of this feature being chosen. Value between 0.0 and 1.0 (inclusive).
- [NBT Compound / JSON Object]: A feature and its corresponding chance.
The defined features can either reference a placed feature directly, or can reference a configured feature by nesting another "feature" node within. For more information, see this page on the two allowed types of feature definitions.
- [NBT Compound / JSON Object] config
- [Int] tries: (optional, defaults to 128) The number of attempts to generate. Must be a positive integer.
- [Int] xz_spread: (optional, defaults to 7) The horizontal spread range. Must be a non-negative integer.
- [Int] y_spread: (optional, defaults to 3) The vertical spread range. Must be a non-negative integer.
- [String][NBT Compound / JSON Object] feature: One placed feature (an [String] ID, or a new [NBT Compound / JSON Object] placed feature definition) — The placed feature that this patch generates.
- [NBT Compound / JSON Object] config
- [NBT List / JSON Array] targets (Required, but can be empty) A list of targets.
- [NBT Compound / JSON Object] A target.
- [NBT Compound / JSON Object] target A rule test to check the block to replace.
- [NBT Compound / JSON Object] state The block to use.
- Block state see Template:Nbt inherit/block state/template
- [NBT Compound / JSON Object] A target.
- [NBT List / JSON Array] targets (Required, but can be empty) A list of targets.
- [NBT Compound / JSON Object] config
- [Int] required_vertical_space_for_tree Value between 1 and 64 (inclusive).
- [Int] root_radius Value between 1 and 64 (inclusive).
- [Int] root_placement_attempts Value between 1 and 256 (inclusive).
- [Int] root_column_max_height Value between 1 and 4096 (inclusive).
- [Int] hanging_root_radius Value between 1 and 64 (inclusive).
- [Int] hanging_roots_vertical_span Value between 0 and 16 (inclusive).
- [Int] hanging_root_placement_attempts Value between 1 and 256 (inclusive).
- [Int] allowed_vertical_water_for_tree Value between 1 and 64 (inclusive).
- [String] root_replaceable A block tag with
#specifying which blocks can be replaced by the root column. - [NBT Compound / JSON Object] root_state_provider The block to use for the root column.
- Block state provider see Template:Nbt inherit/block state provider/template
- [NBT Compound / JSON Object] hanging_root_state_provider The block to use hanging below the root column.
- Block state provider see Template:Nbt inherit/block state provider/template
- [NBT Compound / JSON Object] allowed_tree_position The block predicate used to check if the tree position is valid.
- [String] type: The type of the block predicate. See Block predicate § Types for options.
- additional fields depending on [String] type. See Block predicate § Types.
- [String][NBT Compound / JSON Object] feature The placed feature to place on top of the root system. Can be an ID of a placed feature, or a placed feature object.
- [NBT Compound / JSON Object] config
- [Int] size Value between 0 and 64 (inclusive). Determines the size of the ore vein. Further details on the relationship between 'size' and the actual number of blocks comprising the ore vein is available here.
- [Float] discard_chance_on_air_exposure Value between 0 and 1 (inclusive). The chance for the entire ore vein to be discarded if any constituent block is adjacent to an air block. Other non-solid blocks such as water do not count.
- [NBT List / JSON Array] targets (required, but can be empty) A list of targets.
- [NBT Compound / JSON Object] A target.
- [NBT Compound / JSON Object] target A rule test to check the block to replace.
- [NBT Compound / JSON Object] state The block to use.
- Block state see Template:Nbt inherit/block state/template
- [NBT Compound / JSON Object] A target.
Note that ore features (if allowed to generate in air) will not generate without a solid block nearby to act as the starting point. The ore feature does not necessarily have to intersect with this point, but the required distance does seem to scale with the ore size.
[NBT Compound / JSON Object] config
- [Int] charge_count The number of charges. Value between 1 and 32 (inclusive).
- [Int] amount_per_charge The initial value of each charge. Value between 1 and 500 (inclusive).
- [Int] spread_attempts The number of attempts to spread. Value between 1 and 64 (inclusive).
- [Int] growth_rounds The number of times to generate. Value between 0 and 8 (inclusive).
- [Int] spread_rounds The number of times to spread. Value between 0 and 8 (inclusive).
- [Int][NBT Compound / JSON Object] extra_rare_growths The number of extra shriekers generated.
- Int provider see Template:Nbt inherit/int_provider/template
- [Float] catalyst_chance The probability of generating a catalyst. Value between 0.0 and 1.0 (inclusive).
[NBT Compound / JSON Object] config
- [Float] probability Value between 0.0 and 1.0 (inclusive). Probability of using tall seagrass instead of seagrass
- [NBT Compound / JSON Object] config
- [Int][NBT Compound / JSON Object] count Value between 0 and 256 (inclusive). The max count of the sea pickle block (not single sea pickle).
- Int provider see Template:Nbt inherit/int_provider/template
- [Int][NBT Compound / JSON Object] count Value between 0 and 256 (inclusive). The max count of the sea pickle block (not single sea pickle).
- [NBT Compound / JSON Object] config
- [NBT Compound / JSON Object] to_place The block to use.
- Block state provider see Template:Nbt inherit/block state provider/template
- [NBT Compound / JSON Object] to_place The block to use.
- [NBT Compound / JSON Object] config
- [String][NBT Compound / JSON Object][NBT List / JSON Array] features: Any number of placed feature(s) (an [String] ID, or a new [NBT Compound / JSON Object] placed feature definition, or a [String] tag with
#, or an [NBT List / JSON Array] array containing either [String] IDs or new [NBT Compound / JSON Object] definitions in the same data type); Cannot be empty — Features to choose from.
- [String][NBT Compound / JSON Object][NBT List / JSON Array] features: Any number of placed feature(s) (an [String] ID, or a new [NBT Compound / JSON Object] placed feature definition, or a [String] tag with
- [NBT Compound / JSON Object] config
- [NBT Compound / JSON Object] state The fluid to use.
- Block state see Template:Nbt inherit/block state/template
- [Int] rock_count (optional, defaults to 4) The required number of blocks adjacent to the spring that belong to
valid_blocks. - [Int] hole_count (optional, defaults to 1) The required number of air blocks adjacent to the spring.
- [Boolean] requires_block_below (optional, defaults to true) Whether the spring feature requires a block in [NBT List / JSON Array] valid_blocks below the fluid.
- [String][NBT List / JSON Array] valid_blocks Can be a block ID or a block tag, or a list of block IDs.
- [NBT Compound / JSON Object] state The fluid to use.
- [NBT Compound / JSON Object]: Root object.
- [String] type:
minecraft:tree - [NBT Compound / JSON Object] config
- [Boolean] ignore_vines (optional, defaults to false) Allows the tree to generate even if there are vines blocking it.
- [Boolean] force_dirt (optional, defaults to false) If true, places the dirt provider even when the block below the tree is a valid dirt-like block.
- [NBT Compound / JSON Object] dirt_provider The block to place below the trunk. Places only if
force_dirtis true, or if there is not a valid dirt-like block below the trunk.- Block state provider see Template:Nbt inherit/block state provider/template
- [NBT Compound / JSON Object] trunk_provider The block to use for the trunk. Note that when the trunk placer is
fancy_trunk_placer, the block must haveaxisproperty, such as logs.- Block state provider see Template:Nbt inherit/block state provider/template
- [NBT Compound / JSON Object] foliage_provider The block to use for the foliage.
- Block state provider see Template:Nbt inherit/block state provider/template
- [NBT Compound / JSON Object] minimum_size Defines the width of the tree at different heights relative to the lowest trunk block, for the minimum size of the feature, see Tree definition § Minimum size
- [NBT Compound / JSON Object] trunk_placer Defines how the trunk is generated, see Tree definition § Trunk placer
- [NBT Compound / JSON Object] foliage_placer Defines how the foliage is generated, see Tree definition § Foliage placer
- [NBT Compound / JSON Object] root_placer (optional) Controls how roots are generated, and which blocks to use, see Tree definition § Root placer
- [NBT List / JSON Array] decorators (Required, but can be empty) Decorations to add to the tree apart from the trunk and leaves.
- [NBT Compound / JSON Object] A decorator, see Tree definition § Decorator
- [String] type:
- [NBT Compound / JSON Object] config
- [Int] spread_width Must be a positive integer. The max spread width is
spread_width * 2 + 1 - [Int] spread_height Must be a positive integer. The max spread height is
spread_height * 2 + 1 - [Int] max_height Must be a positive integer. The max length is
max_height * 2, and the min length is 1.
- [Int] spread_width Must be a positive integer. The max spread width is
- [NBT Compound / JSON Object] config
- [Int] floor_search_range Value between 0 and 512 (inclusive).
- [Int] placement_radius_around_floor Value between 0 and 64 (inclusive).
- [Float] placement_probability_per_valid_position Value between 0.0 and 1.0 (inclusive).
- [NBT Compound / JSON Object] config
- [String] surface The surface to place on. One of
floor, orceiling - [Int][NBT Compound / JSON Object] depth Value between 1 and 128 (inclusive).
- Int provider see Template:Nbt inherit/int_provider/template
- [Int] vertical_range Value between 1 and 256 (inclusive).
- [Float] extra_bottom_block_chance Value between 0.0 and 1.0 (inclusive).
- [Float] extra_edge_column_chance Value between 0.0 and 1.0 (inclusive).
- [Float] vegetation_chance Value between 0.0 and 1.0 (inclusive). The chance of placing a vegetation feature is evaluated for each block.
- [Int][NBT Compound / JSON Object] xz_radius The radius of the patch.
- Int provider see Template:Nbt inherit/int_provider/template
- [String] replaceable A block tag with
#specifying what blocks this feature can replace. - [Int][NBT Compound / JSON Object] ground_state The block to use for the ground of the patch.
- Block state provider see Template:Nbt inherit/block state provider/template
- [String][NBT Compound / JSON Object] vegetation_feature The placed feature to place on top of the patch. Can be a placed feature ID, or a placed feature object.
- [String] surface The surface to place on. One of
- [NBT Compound / JSON Object] config
- [String] surface The surface to place on. One of
floor, orceiling - [Int][NBT Compound / JSON Object] depth Value between 1 and 128 (inclusive).
- Int provider see Template:Nbt inherit/int_provider/template
- [Int] vertical_range Value between 1 and 256 (inclusive).
- [Float] extra_bottom_block_chance Value between 0.0 and 1.0 (inclusive).
- [Float] extra_edge_column_chance Value between 0.0 and 1.0 (inclusive).
- [Float] vegetation_chance Value between 0.0 and 1.0 (inclusive). The chance of placing a vegetation feature is evaluated for each block.
- [Int][NBT Compound / JSON Object] xz_radius The radius of the patch.
- Int provider see Template:Nbt inherit/int_provider/template
- [String] replaceable A block tag with
#specifying what blocks this feature can replace. - [Int][NBT Compound / JSON Object] ground_state The block to use for the ground of the patch.
- Block state provider see Template:Nbt inherit/block state provider/template
- [String][NBT Compound / JSON Object] vegetation_feature The placed feature to place on top of the patch. Can be a placed feature ID, or a placed feature object.
- [String] surface The surface to place on. One of
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.
- [NBT Compound / JSON Object] config: Empty
- [NBT Compound / JSON Object] config: Empty
- [NBT Compound / JSON Object] config: Empty
- [NBT Compound / JSON Object] config: Empty
- [NBT Compound / JSON Object] config: Empty
- [NBT Compound / JSON Object] config: Empty
- [NBT Compound / JSON Object] config: Empty
- [NBT Compound / JSON Object] config: Empty
- [NBT Compound / JSON Object] config: Empty
- [NBT Compound / JSON Object] config: Empty
- [NBT Compound / JSON Object] config: Empty
- [NBT Compound / JSON Object] config: Empty
- [NBT Compound / JSON Object] config: Empty
- [NBT Compound / JSON Object] config: Empty
- [NBT Compound / JSON Object] config: Empty
- [NBT Compound / JSON Object] config: Empty
- [NBT Compound / JSON Object] config: Empty
- [NBT Compound / JSON Object] config: Empty
- [NBT Compound / JSON Object] config: Empty
History
| Java Edition | |||||||
|---|---|---|---|---|---|---|---|
| 1.16.2 | 20w28a | Added experimental support for configured features in data packs. | |||||
| 20w29a | Renamed the minecraft:decorated_flower feature in minecraft:no_bonemeal_flower. | ||||||
| 1.17 | 20w45a | Added minecraft:geode feature. | |||||
| 20w49a | Added minecraft:dripstone_cluster, minecraft:large_dripstone, and minecraft:small_dripstone features. | ||||||
| 21w03a | Added minecraft:glow_lichen feature type. | ||||||
| 1.19 | 22w11a | Added block field into glow_lichen (multiface_growth) feature config.
| |||||
Added minecraft:sculk_patch feature type. | |||||||
| 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. | ||||||
| 22w13a | Added extra_rare_growths field into sculk_patch feature config. | ||||||
| 22w14a | Renamed the glow_lichen feature type to multiface_growth.
| ||||||
Added surface_disk feature type.
| |||||||
Added can_origin_replace field into the 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 root_placer field into the minecraft:tree feature config.
| |||||||
Added attached_to_leaves decorator into the minecraft:tree feature config.
| |||||||
Added probability field into the leave_vine decorator of the minecraft:tree feature config.
| |||||||
Added upwards_branching_trunk_placer trunk placer into the minecraft:tree feature config. | |||||||
| 22w15a | Merged the surface_disk and ice_patch feature types into the disk type.
| ||||||
Added state_provider and targets fields into the minecraft:disk feature config, replacing state, targets and can_origin_replace fields.
| |||||||
Added trunk_offset_y and above_root_placement fields into the root placer in the minecraft:tree feature config.
| |||||||
Removed the y_offset field of the mangrove_root_placer root placer in the minecraft:tree feature config. Moved all other additional fields of mangrove_root_placer into an object [NBT Compound / JSON Object] mangrove_root_placement. | |||||||
| 1.19.4 | 23w07a | Added minecraft:cherry_foliage_placer and minecraft:cherry_trunk_placer into the minecraft:tree feature config. | |||||
| 1.20 | 23w17a | Added replaceable_blocks field into the minecraft:huge_fungus feature config. | |||||
| 1.21.4 | 24w44a | The simple_block feature type has a new optional field: schedule_tick. | |||||
Issues
Issues relating to "Configured feature" are maintained on the bug tracker. Issues should be reported and viewed there.
External links
| |||||||||||||||||||||||||||||||
|
| |||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||
