Skip to content

Tree Packs: Leaves Properties

supermassimo edited this page Apr 3, 2023 · 8 revisions

What is it

The leaves_properties folder contains JSON files that define the properties of leaves. Each species can have their own different leaves despite sharing a family, and are what usually distinguish them from each other.

Properties

The following properties MUST be included:

  • "primitive_leaves": The block the leaves are made of. These will drop when sheared

The following properties can be included:

  • "type": Changes the overall behavior of the leaves. The options are {solid, wart, palm, scruffy}. More can be added by addons. (Default: solid)
  • "cell_kit": The shape logic of the leaves. The options are {deciduous, conifer, acacia, dark_oak, bare, palm, nether_fungus}. More can be added by addons. (Default: deciduous)
  • "smother": The maximum count of leaves a leaf block can have on top before dying (Default: 4)
  • "light_requirement": The minimum light value for the leaves not to die (Default:12)
  • "fire_spread": THe fire spread value of the block
  • "flammability": The flammability value of the block
  • "connect_any_radius": If true, leaves will connect to any radius instead of just 1 (Default:false)
  • "does_age": depricated, use ageing_configuration instead.
  • "ageing_configuration": When leaves are allowed to tick and grow/decay. Options are {always, worldgen_only, growth_only, never}
  • "can_grow_on_ground": If false leave will leave a gap of air with the ground. (Default: false)
  • "color": The color of the leaves. It can be a Hex value, Int value or {@biome, @birch, @spruce}. More can be added by addons. (Default: @biome)
  • "family": The family of trees the leaves can connect to. It must first be defined in the Families folder. (By default its any)
  • "generate_block": Whether the leaves need a block to be registered (Default: true)
  • "block_registry_name": The registry name of the block (By default it uses the name of the file + "_leaves")

The following properties are only applicable dynamictrees:scruffy type leaves properties

  • "scruffy_leaf_chance": The percentage of leaf blocks that will be skipped (Default: 0.66)
  • "scruffy_max_hydro": The maximum distance value that skipped leaves can have (Default: 1)

The following properties are only useful for generating Loot Tables. Alternatively custom loot tables can be used and these properties should be avoided.

  • "seed_drop_chances": An array of 4 chances to drop leaves when harvested. Each value represents a level of fortune enchantment with 0 being no fortune. (Default: [0.015625, 0.03125, 0.046875, 0.0625])
  • "requires_shears": If leaves are required to obtain the full block. (Default: true)