Minecraft:Tree definition

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

JSON format

<section begin="json_format" />

• Template:Nbt: Root object.
  • Template:Nbt: Template:Cd
  • Template:Nbt
    • Template:Nbt (optional, defaults to false) Allows the tree to generate even if there are vines blocking it.
    • Template:Nbt An optional rule-based block state provider defining how to replace the block below the trunk. For the default value, see Template:Slink
      • Template:Nbt inherit/rule-based block state provider
    • Template:Nbt The block to use for the trunk. Note that when the trunk placer is fancy_trunk_placer, the block must have axis property, such as logs.
      • Template:Nbt inherit/block state provider
    • Template:Nbt The block to use for the foliage.
      • Template:Nbt inherit/block state provider
    • Template:Nbt Defines the width of the tree at different heights relative to the lowest trunk block, for the minimum size of the feature, see Template:Slink
    • Template:Nbt Defines how the trunk is generated, see Template:Slink
    • Template:Nbt Defines how the foliage is generated, see Template:Slink
    • Template:Nbt (optional) Controls how roots are generated, and which blocks to use, see Template:Slink
    • Template:Nbt (Required, but can be empty) Decorations to add to the tree apart from the trunk and leaves.
      • Template:Nbt A decorator, see Template:Slink

<section end="json_format" />

Default below trunk provider

When not specified the below trunk provider defaults to the following Minecraft:rule-based block state provider: <syntaxhighlight lang="json"> {

   "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"
               }
           }
       }
   ]

} </syntaxhighlight>

Minimum size

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.

• Template:Nbt
  • Template:Nbt One of two_layers_feature_size or three_layers_feature_size
  • Template:Nbt (optional) Value between 0 and 80 (inclusive). If specified and lower than the trunk height, specifies the minimum free height required for the tree to generate. Otherwise the trunk height is used instead.
  • Additional fields depend on the value of Template:Nbt, see below.

two_layers_feature_size

Specifies 2 different width based on height. At heights lower than Template:Nbt, Template:Nbt is used, otherwise Template:Nbt.

• Additional fields:
  • Template:Nbt (optional, defaults to 1) Value between 0 and 81 (inclusive). The limit between lower and upper layer.
  • Template:Nbt (optional, defaults to 0) Value between 0 and 16 (inclusive). Minimum width of the tree at heights under Template:Nbt.
  • Template:Nbt (optional, defaults to 1) Value between 0 and 16 (inclusive). Minimum width of the tree at heights greater than or equals Template:Nbt.

three_layers_feature_size

Specifies 3 different width based on height. At heights lower than Template:Nbt, the minimum width is Template:Nbt, at the topmost Template:Nbt of the trunk Template:Nbt is used, otherwise Template:Nbt is used.

• Additional fields:
  • Template:Nbt (optional, defaults to 1) Value between 0 and 80 (inclusive). Height of the lower layer, calculated from the bottom of the trunk.
  • Template:Nbt (optional, defaults to 1) Value between 0 and 80 (inclusive). Height of the upper layer, calculated from the top of the trunk.
  • Template:Nbt (optional. defaults to 0) Value between 0 and 16 (inclusive). Minimum width of the tree in the bottom layer (i.e. the bottom Template:Nbt blocks of the trunk).
  • Template:Nbt (optional, defaults to 1) Value between 0 and 16 (inclusive). Minimum width of the tree at the middle layer (i.e. between bottom and top layers).
  • Template:Nbt (optional, defaults to 1) Value between 0 and 16 (inclusive). Minimum width of the tree in the upper layer (i.e. the topmost Template:Nbt blocks of the trunk).

Trunk placer

The trunk placer determines the shape trunk of the tree.

• Template:Nbt
  • Template:Nbt One of straight_trunk_placer, forking_trunk_placer, giant_trunk_placer, mega_jungle_trunk_placer, dark_oak_trunk_placer, fancy_trunk_placer, bending_trunk_placer, upwards_branching_trunk_placer, or cherry_trunk_placer.
  • Template:Nbt Value between 0 and 32 (inclusive). The base height of the trunk.
  • Template:Nbt Value between 0 and 24 (inclusive). A random value between 0 and this value (inclusive) is added to the height of the trunk.
  • Template:Nbt Value between 0 and 24 (inclusive). Another random value between 0 and this value (inclusive) is added to the height of the trunk.
  • Additional fields depend on the value of Template:Nbt, see below.

Trunk placers

	Name	Description and Additional Fields
File:Straight trunk placer.png	straight_trunk_placer	Places a straight trunk of specified height. Foliage is attached to be block above the highest trunk block. No additional fields
File:Forking trunk placer.png	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
File:Giant trunk placer.png	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
File:Mega jungle trunk placer.png	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
File:Dark oak trunk placer.png	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
File:Fancy trunk placer.png	fancy_trunk_placer	Places a straight trunk of (height + 2) * 0.618 and branches in random directions. Branches always generate at least 20% up the tree. No additional fields
File:Bending trunk placer.png	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 Template:NbtTemplate:Nbt is generated. Foliage is attached to all block of the top branch and any trunk block that is higher than Template:Nbt. Additional fields: Template:NbtTemplate:Nbt Value between 1 and 64 (inclusive). Template:Nbt inherit/int provider Template:Nbt (optional, defaults to 1) Must be a positive integer.
File:Upwards branching trunk placer.png	upwards_branching_trunk_placer	Template:Info needed Additional fields: Template:NbtTemplate:Nbt The number of steps to generate extra branches. Must be a positive integer. Template:Nbt inherit/int provider Template:NbtTemplate:Nbt Generates extra branch length. Must be a non-negative integer. Template:Nbt inherit/int provider Template:Nbt The probability of each log producing a branch. Value between 0.0 and 1.0 (inclusive). Template:NbtTemplate:Nbt A block ID or a block tag, or a list of block IDs. Represents blocks that tree trunks can grow through.
File:Cherry trunk placer.png	cherry_trunk_placer	Template:Info needed Additional fields: Template:NbtTemplate:Nbt Value between 1 and 3 (inclusive). Template:Nbt inherit/int provider Template:NbtTemplate:Nbt Value between 2 and 16 (inclusive). Template:Nbt inherit/int provider Template:NbtTemplate:Nbt 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, Template:Cd must be at least Template:Cd. Template:Nbt The minimum possible value. Template:Nbt The maximum possible value. Template:NbtTemplate:Nbt Value between -16 and 16 (inclusive). Template:Nbt inherit/int provider

Foliage placer

Template:Info needed section The foliage placer determines the placement and shape of the foliage of the tree.

• Template:Nbt
  • Template:Nbt One of blob_foliage_placer, spruce_foliage_placer, pine_foliage_placer, acacia_foliage_placer, bush_foliage_placer, fancy_foliage_placer, jungle_foliage_placer, mega_pine_foliage_placer, dark_oak_foliage_placer, random_spread_foliage_placer, or cherry_foliage_placer.
  • Template:NbtTemplate:Nbt The radius of the foliage.
    • Template:Nbt inherit/int provider
  • Template:NbtTemplate:Nbt The vertical offset from the top of trunk to the top of the foliage.Template:Needs testing
    • Template:Nbt inherit/int provider
  • Additional fields depend on the value of Template:Nbt, see below.

Foliage placers

	Name	Description and Additional Fields
File:Blob foliage placer.png	blob_foliage_placer	Template:Info needed Additional fields: Template:Nbt The foliage's height. Value between 0 and 16 (inclusive).
File:Bush foliage placer.png	bush_foliage_placer	Template:Info needed Additional fields: Template:Nbt The foliage's height. Value between 0 and 16 (inclusive).
File:Fancy foliage placer.png	fancy_foliage_placer	Template:Info needed Additional fields: Template:Nbt The foliage's height. Value between 0 and 16 (inclusive).
File:Jungle foliage placer.png	jungle_foliage_placer	Template:Info needed Additional fields: Template:Nbt The foliage's height. Value between 0 and 16 (inclusive).
File:Spruce foliage placer.png	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: Template:NbtTemplate:Nbt Value between 0 and 24 (inclusive). Template:Nbt inherit/int provider
File:Pine foliage placer.png	pine_foliage_placer	Template:Info needed Additional fields: Template:NbtTemplate:Nbt Value between 0 and 24 (inclusive). Template:Nbt inherit/int provider
File:Mega pine foliage placer.png	mega_pine_foliage_placer	Template:Info needed Additional fields: Template:NbtTemplate:Nbt Value between 0 and 24 (inclusive). Template:Nbt inherit/int provider
File:Random spread foliage placer.png	random_spread_foliage_placer	Template:Info needed Additional fields: Template:NbtTemplate:Nbt Value between 1 and 512 (inclusive). Template:Nbt inherit/int provider Template:Nbt Value between 0 and 256 (inclusive).
File:Cherry foliage placer.png	cherry_foliage_placer	Template:Info needed Additional fields: Template:NbtTemplate:Nbt Value between 4 and 16 (inclusive). Template:Nbt inherit/int provider Template:Nbt Value between 0.0 and 1.0 (inclusive). Template:Nbt Value between 0.0 and 1.0 (inclusive). Template:Nbt Value between 0.0 and 1.0 (inclusive). Template:Nbt Value between 0.0 and 1.0 (inclusive).
File:Acacia foliage placer.png	acacia_foliage_placer	Template:Info needed No additional fields.
File:Dark oak foliage placer.png	dark_oak_foliage_placer	Template:Info needed No additional fields.

Root placer

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

• Template:Nbt
  • Template:Nbt Type of tree root placer, currently only Template:Cd.
  • Template:Nbt The block used as the root of the tree.
    • Template:Nbt inherit/block state provider
  • Template:NbtTemplate:Nbt Offset perpendicular to the trunk.
    • Template:Nbt inherit/int provider
  • Template:Nbt (optional) The blocks above the root.
    • Template:Nbt The block above the root.
      • Template:Nbt inherit/block state provider
    • Template:Nbt The probability of generating the block. Value between 0.0 and 1.0 (inclusive).
  • Additional fields depend on the value of Template:Nbt, see below.

Root placers

	Name	Description and Additional Fields
File:Mangrove root placer.png	mangrove_root_placer	Template:Info needed Additional fields: Template:Nbt Mangrove root placement parameter. Template:Nbt The maximum width of the root. Value between 1 and 12 (inclusive). Template:Nbt The maximum length of the root. Value between 1 and 64 (inclusive). Template:Nbt The probability of random skew. Value between 0.0 and 1.0 (inclusive). Template:NbtTemplate:Nbt A block ID or a block tag, or a list of block IDs. Blocks that roots can grow through. Template:NbtTemplate:Nbt A block ID or a block tag, or a list of block IDs. Roots in it turn into muddy root blocks. Template:Nbt Blocks used as muddy roots. Template:Nbt inherit/block state provider

Decorator

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

• Template:Nbt: A decorator.
  • Template:Nbt The type of decoration to add. One of alter_ground, attached_to_leaves, attached_to_logs, beehive, cocoa, creaking_heart, leave_vine, pale_moss, place_on_ground, or trunk_vine.
  • Additional fields depend on the value of Template:Nbt, see below.

Tree decorators

	Name	Description and Additional Fields
File:Alter ground tree decorator.png	alter_ground	Replaces blocks in the Template:Tag link tag around the tree with different blocks. Additional fields: Template:Nbt A rule-based block state provider defining how to replace the ground. Template:Nbt inherit/rule-based block state provider
File:Attached to leaves tree decorator.png	attached_to_leaves	Attaches blocks to exposed faces of all foliage blocks in specified directions. Additional fields: Template:Nbt Value between 0.0 and 1.0 (inclusive). Template:Nbt The minimum value of the horizontal distance between two decorations. Value between 0 and 16 (inclusive). Template:Nbt The minimum value of the vertical distance between two decorations. Value between 0 and 16 (inclusive). Template:Nbt The number of empty blocks required by the decoration. Value between 0 and 16 (inclusive). Template:Nbt The block of the decoration. Template:Nbt inherit/block state provider Template:Nbt (Cannot be empty) Directions to generate. Template:Nbt A direction. Must be Template:Cd, Template:Cd, Template:Cd, Template:Cd , Template:Cd, or Template:Cd.
File:Attached to logs tree decorator.png	attached_to_logs	Attaches blocks to exposed faces of all trunk blocks in specified directions. Additional fields: Template:Nbt Value between 0.0 and 1.0 (inclusive). Template:Nbt The block of the decoration. Template:Nbt inherit/block state provider Template:Nbt (Cannot be empty) Directions to generate. Template:Nbt A direction. Must be Template:Cd, Template:Cd, Template:Cd, Template:Cd , Template:Cd, or Template:Cd.
File:Beehive tree decorator.png	beehive	Places a single Minecraft: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: Template:Nbt Value between 0.0 and 1.0 (inclusive).
File:Cocoa tree decorator.png	cocoa	Places Minecraft: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: Template:Nbt Value between 0.0 and 1.0 (inclusive). Probability that this feature places any cocoa beans.
File:Creaking heart tree decorator.png	creaking_heart	Places a creaking heart, replacing a trunk block in a position where all 6 surrounding blocks are in the Template:Tag link tag. Additional fields: Template:Nbt Value between 0.0 and 1.0 (inclusive).
File:Leave vine tree decorator.png	leave_vine	Places Minecraft:vines attached to any foliage blocks. Each vine is extended by 4 blocks downwards if possible. Additional fields: Template:Nbt Value between 0.0 and 1.0 (inclusive). Probability of placing a vine at any given position.
File:Pale moss tree decorator.png	pale_moss	Places the Template:Cd Minecraft:configured feature at the position of the lowest log with probability Template:Nbt. Adds Minecraft:hanging moss to the bottom of trunk and foliage blocks with probability Template:Nbt and Template:Nbt respectively. Additional fields: Template:Nbt Value between 0.0 and 1.0 (inclusive). Template:Nbt Value between 0.0 and 1.0 (inclusive). Template:Nbt Value between 0.0 and 1.0 (inclusive).
File:Place on ground tree decorator.png	place_on_ground	Tries Template:Nbt positions within the specified radius and height range to find a position that is at the height of the MOTION_BLOCKING_NO_LEAVES Minecraft:heightmap, is solid, and has air above. Places the specified block on the block above any matching positions. Additional fields: Template:Nbt Optional positive int. Defaults to 128. Template:Nbt Optional non-negative int. Defaults to 2. Template:Nbt Optional non-negative int. Defaults to 1. Template:Nbt The block of the decoration. Template:Nbt inherit/block state provider
File:Trunk vine tree decorator.png	trunk_vine	Adds vines to each side of each trunk block with a probability of 75% each. No additional fields.