β οΈ Early build. Tested by hand across oak, dark oak, jungle, mangrove, poplar, nether fungi and huge mushrooms β but not yet over a long run on a busy server. If something looks wrong, come and say so on Discord.
β¨ Why it is different
TreeFall does not keep a list of wood types.
It reads Minecraft's own block tags β minecraft:logs, minecraft:leaves,
minecraft:saplings β so when Mojang adds a new tree, it works on day one,
with no update and no new config.
πΈ Poplar, added in 26.3, works without the word "poplar" appearing anywhere in the source. So will whatever comes next.
The sapling is worked out from the log's own name β poplar_log β
poplar_sapling β with three exceptions for mangrove, crimson and warped.
πͺ What it does
| π³ Fells the whole tree | from the log standing on the ground, following diagonal branches. Cut a branch or the middle of a trunk and it behaves exactly like vanilla β one block at a time |
| π₯ Topples it | as falling blocks, with higher blocks pushed harder so the tree leans over as it comes down |
| π Brings the crown down | leaves, and anything growing on the tree: jungle vines, cocoa pods, shelf mushrooms, bee nests, hanging moss, nether wart canopies |
| πΏ Leaves neighbours alone | jungle canopies touch β a leaf is only taken if it belongs to this tree |
| π Handles the odd ones | mangroves on roots, and huge red and brown mushrooms β which Minecraft does not count as trees at all |
| π± Replants | all four saplings for 2Γ2 trees like dark oak and pale oak, which cannot regrow from one |
| π‘οΈ Respects claims | every block goes through a real BlockBreakEvent, so GriefPrevention, WorldGuard and Towny stay in charge |
| π« Blocks the exploit | hand-placed logs are remembered and refused β a stacked-up fake tree cannot be farmed. No CoreProtect needed |
β¨οΈ Commands
| Command | Permission | What it does |
|---|---|---|
/tf info |
β | current settings |
/tf reload |
treefall.admin |
reload config.yml |
/tf toggle [player] |
treefall.toggle.other |
turn it off for yourself |
/tf forcebreak [radius] |
treefall.forcebreak |
fell every tree in range |
/tf forcegrow [radius] |
treefall.forcegrow |
bone-meal every sapling in range |
π Permissions
| Node | Default | |
|---|---|---|
treefall.use |
β everyone | fell trees |
treefall.use.<wood> |
β everyone | per-species, when per-tree-permissions is on |
treefall.admin |
π op | reload, break guarded saplings |
treefall.bypass.cooldown |
π op | skip the cooldown |
βοΈ Configuration
Every setting is commented in config.yml. The ones worth knowing about:
| Setting | Default | |
|---|---|---|
require-bottom-block |
true |
only the log on the ground fells the tree |
falling-blocks |
true |
the toppling animation |
fall-spread |
1.0 |
how far the tree leans β try 2.0 π |
max-falling-blocks |
200 |
entity budget β this is the lag control |
max-leaves |
2000 |
how much of the crown breaks |
leaf-reach |
5 |
keeps a felled tree off its neighbours |
max-distance |
12 |
leash on the crown search |
decorations |
16 blocks | anything growing on a tree |
extra-trunk |
3 blocks | holds a tree up but is not a log |
respect-claims |
true |
check each block with protection plugins |
track-placed-logs |
true |
anti-farm |
𧩠Two lists, no code
Other plugins need a config file per species. TreeFall needs two lines:
- Something still floating after a tree falls? β add it to
decorations - A "tree" that ignores you completely? Its trunk is not a log β add it to
extra-trunk
That is all huge mushrooms needed. Neither takes a code change.
π« Not supported
Folia. TreeFall uses the classic Bukkit scheduler, which Folia does not provide. It will not work there.
π¬ Support
Something broken, or a block left floating that should have come down?
π Join the Discord
Quickest, and easiest for sharing a screenshot or a server log. Or open an issue on GitHub.
π‘ If a tree is misbehaving, the console log and the biome name are usually enough to work out what happened.
β Source on GitHub β’ π MIT licensed
Use it, change it, ship it. Just keep the copyright notice.
Pages
Members
1
Owner