Description
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.
- Look directly at the block you want to register — a log, leaf block, vine, or decoration
- Press O (rebindable in Controls) to open the Add Block screen
- 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)
- 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