Sappy Tree Physics

TreePhysics brings satisfying, physically-driven tree felling to your Minecraft world. Break any log in a tree and watch the whole thing — trunk, branches, leaves, vines, and hanging decorations — come crashing down together as a single falling object, powered by the Sable physics engine.

Features:

• Trees fall as a single rigid body when any of their logs is broken
• Leaves, vines, moss, dripleaves, cave vines, and other hanging decorations fall with the tree
• Intelligent natural-tree detection — player-built log structures won’t accidentally collapse
• Full support for modded trees via a simple JSON config file
• In-game commands to register new tree species, log variants, and custom decoration blocks without restarting
• A convenient keybind (default: O) to point at any block in the world and instantly add it to a tree definition through a GUI
• Global “public decoration” support for mod plants that can hang from any tree species (e.g. Spanish moss, custom vines)
• Configurable tree size limit, leaf scan radius, and more

Adding modded blocks in-game:

TreePhysics includes a simple GUI for registering new blocks without touching any config files or typing commands.

1. Look directly at the block you want to register — a log, leaf block, vine, or decoration
2. Press O (rebindable in Controls) to open the Add Block screen
3. Choose what role the block plays in its tree:
   • Add as Log — the block is part of the trunk or branches
   • Add as Leaf — the block is part of the canopy foliage
   • Add as Decoration — the block hangs off this specific tree species (e.g. a mod-specific vine)
   • Add as Public Decoration — the block can hang from any tree, regardless of species (e.g. Spanish moss)
4. For the first three options, type the name of the tree species the block belongs to (e.g. malum_soulwood) and press Enter to confirm. If that species doesn’t exist yet it will be created automatically.

That’s it — the block is registered immediately and saved to your config. No restart required.

Commands:

All commands require permission level 2 (operator). Changes take effect immediately and are saved to config automatically.

Tree definitions:

/treephysics tree create <name> — creates a new empty tree definition with the given name.

/treephysics tree add <name> <category> <block_id> — adds a block to an existing tree definition. Category must be logs, leaves, or decorations. Example: /treephysics tree add malum_soulwood logs malum:soulwood_log

/treephysics tree list — lists all currently loaded tree definitions with a count of their logs, leaf types, and decorations.

Public decorations:

/treephysics decoration add <block_id> — adds a block to the global public decoration list, making it fall with every tree regardless of species. Example: /treephysics decoration add regions_unexplored:spanish_moss

/treephysics decoration list — lists all currently registered public decoration blocks.

Other:

/treephysics reload — reloads all tree definitions from config/treephysics-trees.json without restarting the server. Useful if you’ve edited the file manually.

Mod compatibility: TreePhysics works out of the box for all vanilla trees. For modded trees, use the GUI or the in-game /treephysics commands, or edit config/treephysics-trees.json directly to register custom log, leaf, and decoration blocks. Any modded block can be supported in seconds.

Requires: NeoForge, Sable