Tree definition

JSON format

• [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.
    • [NBT Compound / JSON Object] below_trunk_provider An optional rule-based block state provider defining how to replace the block below the trunk. For the default value, see Tree definition § Default below trunk provider
      • A rule-based block state provider see Template:Nbt inherit/rule-based 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 have axis property, 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

Default below trunk 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"
}
}
}
]
}

Minimum size

• [NBT Compound / JSON Object] minimum_size
  • [String] type One of two_layers_feature_size or three_layers_feature_size
  • [Float] min_clipped_height (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 [String] type, see below.

two_layers_feature_size

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

three_layers_feature_size

• Additional fields:
  • [Int] limit (optional, defaults to 1) Value between 0 and 80 (inclusive). Height of the lower layer, calculated from the bottom of the trunk.
  • [Int] upper_limit (optional, defaults to 1) Value between 0 and 80 (inclusive). Height of the upper layer, calculated from the top of the trunk.
  • [Int] lower_size (optional. defaults to 0) Value between 0 and 16 (inclusive). Minimum width of the tree in the bottom layer (i.e. the bottom [Int] limit blocks of the trunk).
  • [Int] middle_size (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).
  • [Int] upper_size (optional, defaults to 1) Value between 0 and 16 (inclusive). Minimum width of the tree in the upper layer (i.e. the topmost [Int] upper_limit blocks of the trunk).

Trunk placer

• [NBT Compound / JSON Object] trunk_placer
  • [String] type 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.
  • [Int] base_height Value between 0 and 32 (inclusive). The base height of the trunk.
  • [Int] height_rand_a Value between 0 and 24 (inclusive). A random value between 0 and this value (inclusive) is added to the height of the trunk.
  • [Int] height_rand_b 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 [String] type, see below.

Foliage placer

• [NBT Compound / JSON Object] foliage_placer
  • [String] type 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.
  • [Int][NBT Compound / JSON Object] radius The radius of the foliage.
    • Int provider see Template:Nbt inherit/int_provider/template
  • [Int][NBT Compound / JSON Object] offset The vertical offset from the top of trunk to the top of the foliage.^{[needs testing]}
    • Int provider see Template:Nbt inherit/int_provider/template
  • Additional fields depend on the value of [String] type, see below.

Root placer

• [NBT Compound / JSON Object] root_placer
  • [String] type Type of tree root placer, currently only mangrove_root_placer.
  • [NBT Compound / JSON Object] root_provider The block used as the root of the tree.
    • Block state provider see Template:Nbt inherit/block state provider/template
  • [Int][NBT Compound / JSON Object] trunk_offset_y Offset perpendicular to the trunk.
    • Int provider see Template:Nbt inherit/int_provider/template
  • [NBT Compound / JSON Object] above_root_placement (optional) The blocks above the root.
    • [NBT Compound / JSON Object] above_root_provider The block above the root.
      • Block state provider see Template:Nbt inherit/block state provider/template
    • [Float] above_root_placement_chance The probability of generating the block. Value between 0.0 and 1.0 (inclusive).
  • Additional fields depend on the value of [String] type, see below.

Decorator

• [NBT Compound / JSON Object]: A decorator.
  • [String] type 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 [String] type, see below.

History

Navigation