Timber Physics Plus

Quick rating

Community listing page, reviews here may not be monitored by the author.

How listings work Are you the author?

Timber Physics Plus

By Seikleiner

No reviews yet

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

Mod Loaders
Minecraft
26.2 26.1
Hosting Partner

Want to reach Minecraft players?

We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!

Get in touch

About

Description

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.