Timber Physics Plus

By
Seikleiner

Authentic physics-based tree falling for NeoForge. Superfast, modular, and works with all modded trees!

Timber Physics Plus

Timber Physics Plus is a native NeoForge tree-felling mod for Minecraft 1.21+ that adds physics-driven tree destruction.

Instead of instantly breaking into dropped items, trees physically fall in the direction the player is looking. Logs follow a natural kinematic trajectory, while leaves are detected and handled separately to preserve the structure of the surrounding forest.

The mod is written entirely in Java and does not require datapacks or marker entities.

Features

Directional tree physics
Trees tilt, arc, and fall in the direction the player is looking. Higher blocks travel faster along the falling trajectory, creating a natural kinematic motion.
2D Voronoi canopy partitioning
A mathematical X/Z Voronoi partition is used to determine the boundaries between neighboring trees. This prevents leaves from dense forests, jungles, and other crowded areas from being incorrectly assigned to another tree.
BFS leaf flood-fill
Recursive canopy scanning detects wide and branching tree structures, including Big Oak, Dark Oak, Mangrove, and Cherry trees, while minimizing the chance of leaving floating leaves behind.
Leaf species isolation
With allowMixedLeaves disabled, only leaves matching the tree's primary leaf type are collected. Leaves belonging to adjacent trees of another species remain untouched.
Natural leaf loot shattering
Falling leaves can break when they hit the ground or water, producing normal breaking particles and sounds and dropping vanilla leaf loot such as saplings, apples, and sticks.
Horizontal log alignment
Fallen logs are automatically placed horizontally using the appropriate X or Z axis, allowing them to rest naturally on the ground away from the stump.
Vertical bamboo physics
Bamboo stalks fall straight downward under vertical gravity, collapsing layer by layer similarly to falling sand or gravel.
Building protection
Only trees with natural leaves (persistent=false) can be felled. Player-built structures, decorative logs, cabins, roofs, and placed leaf blocks are protected.
Fallen log filtering
Logs that are already lying on solid ground can be ignored, preventing recursive felling and accidental destruction of nearby forests.
Configurable leaf shattering
Choose how many leaves instantly shatter when a tree is chopped: 0%, 10%, 25%, 50%, or 100%.
Optional axe durability damage
Axe durability can optionally be reduced for every log felled. Disabled by default.
Sneak to chop a single block
Hold Shift/Sneak to mine a single log without triggering the tree-felling effect.
In-game configuration
All settings can be configured through Mods > Timber Physics Plus > Config or directly through config/timber_physics_plus.toml.

Compatibility

Timber Physics Plus uses standard Minecraft log and leaf tags to support a wide range of tree types without requiring individual integrations.

Nether tree support can be disabled in the configuration.

Huge mushroom physics can be disabled in the configuration.

Bamboo uses its own vertical falling physics and can be enabled or disabled independently.

Modded Trees

The mod supports modded trees out of the box, including trees from:

Regions Unexplored
The Undergarden
Born in Chaos
Deeper and Darker
Biomes O' Plenty
Atmospheric
Autumnity

Other mods using the standard #minecraft:logs or #c:logs tags are supported automatically.

Configuration

All configuration options are available through the in-game Mods menu or config/timber_physics_plus.toml.

Setting	Default	Description
`ignoreFallenLogs`	`true`	Excludes logs already lying on solid ground from felling cascades.
`requireNaturalLeaves`	`true`	Requires natural tree leaves and protects player-built structures.
`allowMixedTrunks`	`false`	When disabled, only logs of the same species are felled together.
`allowCrossTreeBranches`	`false`	When disabled, branches crossing between trees must match the tree's species.
`allowMixedLeaves`	`false`	When disabled, only leaves matching the tree's primary leaf type are collected.
`enableVoronoiPartition`	`true`	Uses 2D X/Z Voronoi partitioning to prevent leaves from nearby trees being collected.
`voronoiSearchRadius`	`24`	Horizontal block radius used to search for neighboring trunks during Voronoi calculations.
`logsDestroyLeaves`	`true`	Allows falling logs to destroy leaves in their path.
`dropLogsOnLand`	`false`	When enabled, fallen logs drop as items instead of being placed as blocks.
`leafShatterOnLand`	`true`	Causes falling leaves to shatter into loot when they hit the ground.
`enableSneakToChopSingle`	`true`	Allows Shift/Sneak to mine a single block without felling the tree.
`leafShatterPercent`	`0`	Percentage of leaves instantly shattered when the tree is chopped: 0%, 10%, 25%, 50%, or 100%.
`leafSearchRadius`	`7`	Maximum leaf flood-fill graph distance from tree branches, from 1 to 14.
`damageAxe`	`false`	When enabled, axe durability is reduced for every log felled.
`enableNetherTrees`	`true`	Enables physics-based felling for Crimson and Warped trees.
`enableBamboo`	`true`	Enables vertical falling physics for bamboo.
`enableMushrooms`	`true`	Enables physics-based felling for huge mushrooms.
`enableModdedTrees`	`true`	Enables physics-based felling for modded trees.
`maxLogs`	`300`	Maximum number of logs that can be processed for a single tree, from 10 to 2000.
`maxLeaves`	`1000`	Maximum number of canopy leaves that can be scanned, from 50 to 5000.

Performance

Timber Physics Plus is designed to handle large tree structures without relying on datapacks or marker entities. Tree and canopy detection are performed directly in Java, with configurable limits for the maximum number of logs and leaves processed during a single felling event.

Credits and License

Original Concept: imalittlhigh — Timber Physics

NeoForge Port and Plus Features: Seikleiner & Antigravity, powered by Gemini 3.7 Flash

License: MIT License

You are free to include Timber Physics Plus in modpacks, use it in videos and showcases, and modify its source code.