Physis

Changelog

Added

• Leaf Litter system: oak trees now passively drop dry leaves (LEAF_LITTER) beneath their canopy over time.
• dropsLeafLitter field in TreeSpecies, mapped via BY_LEAVES lookup — only Oak triggers leaf litter drops.
• upgradeLeafLitter() function: gradually increments existing LEAF_LITTER segment_amount property from 1 up to 4.
• Wind-based scatter: placement offset scales with tree height; taller trees scatter leaves farther.
• 5×5 block leaf scan radius (up from immediate column), allowing litter to appear 2–3 blocks from the canopy edge.

Fixed

• Leaf litter not spawning: scan was starting from Y=0, always missing canopy at surface level. Changed to use Heightmap.MOTION_BLOCKING_NO_LEAVES to start from actual surface Y.
• Wrong property name: amount corrected to segment_amount (the correct LEAF_LITTER property).
• Dead bush placeholder: replaced DEAD_BUSH with the real Blocks.LEAF_LITTER block.
• CI compatibility (MC 26.1.2): removed call to getMaxBuildHeight() which does not exist in 26.1.2.
• Preprocessor indentation: fixed leaf litter call indentation in tickChunk().
• Player-placed leaf exclusion: checks LeavesBlock.PERSISTENT property; player-placed leaves (PERSISTENT=true) are skipped.

Changed

• Leaf Litter trigger rate: 1/2400 → 1/200 per chunk tick, matching the pink petals shouldRun frequency.
• Tree spread frequency: reduced baseChance from 200 to 300 (normal weather) and from 100 to 150 (rain). This reduces overall tree spread rate by approximately 50%, making forest expansion slower and more gradual.
• Leaf litter placement: removed soil restriction — can now settle on any block type.
• Upgrade scan: dedicated upgrade pass (3 attempts per trigger) independent from placement pass (2 attempts), ensuring gradual accumulation to the cap.