Timber Physics Plus v1.2.0

Minecraft 1.21.1 / NeoForge

Physics and Canopy Overhaul

Version 1.2.0 introduces a major overhaul of tree canopy detection, leaf handling, configuration, and overall performance.

Canopy Detection

• 2D Voronoi Canopy Partitioning
  • Added a mathematical X/Z Voronoi partition algorithm for determining ownership of leaves between neighboring trees. In dense forests, leaves are assigned to the nearest tree trunk, preventing one tree from incorrectly collecting leaves belonging to another.
• BFS Leaf Flood-Fill
  • Replaced the previous fixed-radius canopy search with a connected-graph breadth-first search (BFS). The new system follows natural leaf connectivity and decay distances, improving detection of wide and irregular canopies such as Dark Oak, Big Oak, Mangrove, and Cherry trees while preventing floating leaves from being left behind.
• Leaf Species Isolation
  • Added the allowMixedLeaves configuration option. When disabled, only leaves matching the tree's primary leaf species are collected. This prevents touching canopies from different tree species from being affected. When enabled, multiple leaf species can be collected as part of the same canopy, allowing combinations such as Azalea and Flowering Azalea.

Leaf Behavior

• Natural Leaf Loot Shattering
  • Added leafShatterOnLand. Falling leaves now break when they hit the ground or water, producing normal block-breaking particles and sounds and generating vanilla leaf drops such as saplings, apples, and sticks instead of placing solid leaf blocks.

Axe Durability

• Optional Axe Damage
  Axe durability damage is now controlled by damageAxe and is disabled by default. When enabled, the axe loses additional durability for each log felled during a tree-felling event.

Configuration

Refined In-Game Configuration GUI
Reorganized the configuration screen into 10 structured rows with clearer labels and more intuitive toggle controls.

• Added and restored the following configuration options:
  • allowMixedLeaves
  • leafShatterOnLand
  • leafShatterPercent
  • damageAxe

Performance and Stability

• Native Java 21 Execution
  • Updated processing to use native Java 21 execution without background thread overhead.
• Low Processing Overhead
  • Canopy and physics calculations are designed for sub-millisecond execution times, improving responsiveness while maintaining the physics-based tree-felling system.