Tree definition

This feature is exclusive to Java Edition.

 

Trees are features with a stem and leaves, and optionally roots and decorations. They are configured using configured features in data packs.

When not specified the below trunk provider defaults to the following rule-based block state provider:

{
    "rules": [
        {
            "if_true": {
                "type": "minecraft:not",
                "predicate": {
                    "type": "minecraft:matching_block_tag",
                    "tag": "minecraft:cannot_replace_below_tree_trunk"
                }
            },
            "then": {
                "type": "minecraft:simple_state_provider",
                "state": {
                    "Name": "minecraft:dirt"
                }
            }
        }
    ]
}

The minimum size determines how much space needs to be available for the tree to be able to place. This is done by checking a square area of varying widths at each vertical position of the tree. The available free height is calculated as the height until all square are free.

Specifies 2 different width based on height. At heights lower than [Int] limit, [Int] lower_size is used, otherwise [Int] upper_size.

Specifies 3 different width based on height. At heights lower than [Int] limit, the minimum width is [Int] lower_size, at the topmost [Int] upper_limit of the trunk [Int] upper_size is used, otherwise [Int] middle_size is used.

The trunk placer determines the shape trunk of the tree.

Trunk placers

	Name	Description and Additional Fields
	straight_trunk_placer	Places a straight trunk of specified height. Foliage is attached to be block above the highest trunk block. No additional fields
	forking_trunk_placer	Places a trunk with 1 or 2 branches, with an overhang of 1 to 3 blocks. Foliage is attached to the top of each branch. No additional fields
	giant_trunk_placer	Places a 2×2 trunk of the specified height, except the topmost block is only a single block. Foliage is attached to be block above the highest trunk block. No additional fields
	mega_jungle_trunk_placer	Extends the giant_trunk_placer with branches of length 5 in random directions in the top half of the trunk. Foliage is additionally attached to the end of each branch. No additional fields
	dark_oak_trunk_placer	Places a 2×2 trunk of the specified height. Additionally places columns of branches in a 4×4 area around the stem in the topmost 5 blocks of the trunk. Foliage is attached to the top of the trunk as well as the top of each branch. No additional fields
	fancy_trunk_placer	Places a straight trunk of (height + 2) * 0.618 and branches in random directions. Foliage is attached to the end of all branches that are at least 20% up the tree. No additional fields
	bending_trunk_placer	Places a trunk of the specified height. The topmost 2 blocks have a chance to be moved by one block each. On top of the trunk a straight branch of length [Int][NBT Compound / JSON Object] bend_length is generated. Foliage is attached to all block of the top branch and any trunk block that is higher than [Int] min_height_for_leaves. Additional fields: [Int][NBT Compound / JSON Object] bend_length Value between 1 and 64 (inclusive). Int provider see Template:Nbt inherit/int_provider/template [Int] min_height_for_leaves (optional, defaults to 1) Must be a positive integer.
	upwards_branching_trunk_placer	​[more information needed] Additional fields: [Int][NBT Compound / JSON Object] extra_branch_steps The number of steps to generate extra branches. Must be a positive integer. Int provider see Template:Nbt inherit/int_provider/template [Int][NBT Compound / JSON Object] extra_branch_length Generates extra branch length. Must be a non-negative integer. Int provider see Template:Nbt inherit/int_provider/template [Float] place_branch_per_log_probability The probability of each log producing a branch. Value between 0.0 and 1.0 (inclusive). [String][NBT List / JSON Array] can_grow_through A block ID or a block tag, or a list of block IDs. Represents blocks that tree trunks can grow through.
	cherry_trunk_placer	​[more information needed] Additional fields: [Int][NBT Compound / JSON Object] branch_count Value between 1 and 3 (inclusive). Int provider see Template:Nbt inherit/int_provider/template [Int][NBT Compound / JSON Object] branch_horizontal_length Value between 2 and 16 (inclusive). Int provider see Template:Nbt inherit/int_provider/template [Int][NBT Compound / JSON Object] branch_start_offset_from_top A uniform int provider, which provides a number between two bounds with uniform distribution. Must between -16 and 0 (inclusive). And since it needs at least 2 blocks variation for the branch starts to fit both branches, max_inclusive must be at least min_inclusive + 1. [Int] min_inclusive The minimum possible value. [Int] max_inclusive The maximum possible value. [Int][NBT Compound / JSON Object] branch_end_offset_from_top Value between -16 and 16 (inclusive). Int provider see Template:Nbt inherit/int_provider/template

The foliage placer determines the placement and shape of the foliage of the tree.

Foliage placers

	Name	Description and Additional Fields
	blob_foliage_placer	​[more information needed] Additional fields: [Int] height The foliage's height. Value between 0 and 16 (inclusive).
	bush_foliage_placer	​[more information needed] Additional fields: [Int] height The foliage's height. Value between 0 and 16 (inclusive).
	fancy_foliage_placer	​[more information needed] Additional fields: [Int] height The foliage's height. Value between 0 and 16 (inclusive).
	jungle_foliage_placer	​[more information needed] Additional fields: [Int] height The foliage's height. Value between 0 and 16 (inclusive).
	spruce_foliage_placer	Places cones starting from the top of the trunk + offset, with increasing radius that increases until it hits a maximum radius, where it will keep generating frustums at maximum radius until the foliage is trunk_height + 1 tall Additional fields: [Int][NBT Compound / JSON Object] trunk_height Value between 0 and 24 (inclusive). Int provider see Template:Nbt inherit/int_provider/template
	pine_foliage_placer	​[more information needed] Additional fields: [Int][NBT Compound / JSON Object] height Value between 0 and 24 (inclusive). Int provider see Template:Nbt inherit/int_provider/template
	mega_pine_foliage_placer	​[more information needed] Additional fields: [Int][NBT Compound / JSON Object] crown_height Value between 0 and 24 (inclusive). Int provider see Template:Nbt inherit/int_provider/template
	random_spread_foliage_placer	​[more information needed] Additional fields: [Int][NBT Compound / JSON Object] foliage_height Value between 1 and 512 (inclusive). Int provider see Template:Nbt inherit/int_provider/template [Int] leaf_placement_attempts Value between 0 and 256 (inclusive).
	cherry_foliage_placer	​[more information needed] Additional fields: [Int][NBT Compound / JSON Object] height Value between 4 and 16 (inclusive). Int provider see Template:Nbt inherit/int_provider/template [Float] wide_bottom_layer_hole_chance Value between 0.0 and 1.0 (inclusive). [Float] corner_hole_chance Value between 0.0 and 1.0 (inclusive). [Float] hanging_leaves_chance Value between 0.0 and 1.0 (inclusive). [Float] hanging_leaves_extension_chance Value between 0.0 and 1.0 (inclusive).
	acacia_foliage_placer	​[more information needed] No additional fields.
	dark_oak_foliage_placer	​[more information needed] No additional fields.

The root placer is optional and controls the placement and shape of the roots, and moving the trunk upwards.

Root placers

	Name	Description and Additional Fields
	mangrove_root_placer	​[more information needed] Additional fields: [NBT Compound / JSON Object] mangrove_root_placement Mangrove root placement parameter. [Int] max_root_width The maximum width of the root. Value between 1 and 12 (inclusive). [Int] max_root_length The maximum length of the root. Value between 1 and 64 (inclusive). [Float] random_skew_chance The probability of random skew. Value between 0.0 and 1.0 (inclusive). [String][NBT List / JSON Array] can_grow_through A block ID or a block tag, or a list of block IDs. Blocks that roots can grow through. [String][NBT List / JSON Array] muddy_roots_in A block ID or a block tag, or a list of block IDs. Roots in it turn into muddy root blocks. [NBT Compound / JSON Object] muddy_roots_provider Blocks used as muddy roots. Block state provider see Template:Nbt inherit/block state provider/template

Decorators are used to add additional blocks to various parts of the tree.

Tree decorators

	Name	Description and Additional Fields
	alter_ground	Replaces blocks in the #minecraft:dirt tag around the tree with different blocks. Additional fields: [NBT Compound / JSON Object] provider​[until JE 26.1] The block to replace the ground with. Block state provider see Template:Nbt inherit/block state provider/template [NBT Compound / JSON Object] provider​[upcoming JE 26.1] A rule-based block state provider defining how to replace the ground. A rule-based block state provider see Template:Nbt inherit/rule-based block state provider/template
	attached_to_leaves	Attaches blocks to exposed faces of all foliage blocks in specified directions. Additional fields: [Float] probability Value between 0.0 and 1.0 (inclusive). [Int] exclusion_radius_xz The minimum value of the horizontal distance between two decorations. Value between 0 and 16 (inclusive). [Int] exclusion_radius_y The minimum value of the vertical distance between two decorations. Value between 0 and 16 (inclusive). [Int] required_empty_blocks The number of empty blocks required by the decoration. Value between 0 and 16 (inclusive). [NBT Compound / JSON Object] block_provider The block of the decoration. Block state provider see Template:Nbt inherit/block state provider/template [NBT List / JSON Array] directions (Cannot be empty) Directions to generate. [String] A direction. Must be up, down, north, south , west, or east.
	attached_to_logs	Attaches blocks to exposed faces of all trunk blocks in specified directions. Additional fields: [Float] probability Value between 0.0 and 1.0 (inclusive). [NBT Compound / JSON Object] block_provider The block of the decoration. Block state provider see Template:Nbt inherit/block state provider/template [NBT List / JSON Array] directions (Cannot be empty) Directions to generate. [String] A direction. Must be up, down, north, south , west, or east.
	beehive	Places a single beehive with the specified probability. The beehive is always located 1 block below the lowest leaves block, but possibly on a different branch. Additional fields: [Float] probability Value between 0.0 and 1.0 (inclusive).
	cocoa	Places cocoa beans on the bottom 3 blocks of the trunk with a probability of 25% for each face. The specified probability determines how often any cocoa beans are placed. Additional fields: [Float] probability Value between 0.0 and 1.0 (inclusive). Probability that this feature places any cocoa beans.
	creaking_heart	Places a creaking heart, replacing a trunk block in a position where all 6 surrounding blocks are in the #minecraft:logs tag. Additional fields: [Float] probability Value between 0.0 and 1.0 (inclusive).
	leave_vine	Places vines attached to any foliage blocks. Each vine is extended by 4 blocks downwards if possible. Additional fields: [Float] probability Value between 0.0 and 1.0 (inclusive). Probability of placing a vine at any given position.
	pale_moss	Places the minecraft:pale_moss_patch configured feature at the position of the lowest log with probability [Float] ground_probability. Adds hanging moss to the bottom of trunk and foliage blocks with probability [Float] trunk_probability and [Float] ground_probability respectively. Additional fields: [Float] leaves_probability Value between 0.0 and 1.0 (inclusive). [Float] trunk_probability Value between 0.0 and 1.0 (inclusive). [Float] ground_probability Value between 0.0 and 1.0 (inclusive).
	place_on_ground	Tries [Int] tries positions within the specified radius and height range to find a position that is at the height of the MOTION_BLOCKING_NO_LEAVES heightmap, is solid, and has air above. Places the specified block on the block above any matching positions. Additional fields: [Int] tries Optional positive int. Defaults to 128. [Int] radius Optional non-negative int. Defaults to 2. [Int] height Optional non-negative int. Defaults to 1. [NBT Compound / JSON Object] block_state_provider The block of the decoration. Block state provider see Template:Nbt inherit/block state provider/template
	trunk_vine	Adds vines to each side of each trunk block with a probability of 75% each. No additional fields.