Treecapitator: chop down a whole tree in one hit
Treecapitator is one of the best-loved quality-of-life (QoL) plugins on Minecraft servers. It lets you chop down an entire tree with a single axe hit: every log in the trunk drops at once. It does away with tedious block-by-block chopping and is standard on most survival servers.
What Treecapitator is
Treecapitator is a classic Minecraft plugin that has been around in various versions for years. It does one simple thing: when a player hits the bottom block of a tree trunk with an axe, the whole trunk is destroyed at once. The logs drop as items, and the leaves decay naturally.
The name combines the words "tree" and "decapitator" (someone who cuts off heads). The plugin became hugely popular because chopping trees by hand is one of the most monotonous jobs in Minecraft, especially with big jungle or spruce trees.
SpigotMC has several versions of Treecapitator by different authors. The most popular one is Treecapitator on SpigotMC. Some servers also use similar plugins such as Timber or UltimateTimber.
How it works
Treecapitator's mechanics are intuitive:
- The player holds an axe (any material: wooden, stone, iron, diamond, netherite)
- They hit the bottom block of the tree trunk
- The plugin detects all connected logs of the same type above it
- All the blocks of the trunk are destroyed at the same time
- The wood drops as items to pick up
- The axe loses durability in proportion to the number of blocks destroyed
The plugin recognizes every type of tree: oak, spruce, birch, jungle, acacia, dark oak, cherry, mangrove and blocks of bamboo. It also supports modded trees, as long as they use the standard block tags.
- Sneaking turns it off: a player who sneaks (Shift) chops normally, block by block. Handy when you build with wood
- Axe durability: every block chopped uses up 1 durability point. The axe can break on a big tree
- Leaves: optionally, the plugin also destroys the leaves together with the trunk (configurable)
Commands and permissions
| Command / permission | What it does |
|---|---|
/treecapitator toggle | Turns the plugin on or off for yourself |
/treecapitator reload | Reloads the configuration (admin) |
treecapitator.use | Lets a player chop down trees with the plugin |
treecapitator.toggle | Lets a player turn it on or off for themselves |
treecapitator.bypass.durability | The axe doesn't lose durability |
By default, every player can chop down trees this way. If you want to limit it to VIP ranks, revoke the treecapitator.use permission from the default group in LuckPerms.
Configuration
# config.yml
max-blocks: 200 # block limit per tree
sneak-to-disable: true # sneaking turns the effect off
damage-axe: true # whether the axe loses durability
break-leaves: false # whether to break the leaves with the trunk
only-axes: true # whether it works only with an axe
require-tool: true # false = even with a bare fist
# Supported tools
allowed-tools:
- WOODEN_AXE
- STONE_AXE
- IRON_AXE
- GOLDEN_AXE
- DIAMOND_AXE
- NETHERITE_AXE The most important setting is max-blocks. Keep it at 100-200 to prevent lag from giant jungle trees (which can have more than 300 blocks).
Treecapitator vs Timber
Treecapitator and Timber do the same job, but they differ in the details:
- Treecapitator: chops instantly. Simpler to configure, with fewer options. Lighter on the server
- Timber (UltimateTimber): a falling-tree animation (block by block from the top). More configuration options, sapling replanting, cooldowns
On most survival servers both plugins work equally well. Treecapitator is more popular because it's simpler and uses fewer server resources.
Tips for admins
- Block limit: always set
max-blocks. Without a limit, a player can cause lag by chopping down a huge jungle tree - Axe durability: leave
damage-axe: trueon to keep things balanced. Without durability loss, a diamond axe chops down an unlimited number of trees - Sneaking: make sure
sneak-to-disableis on. Players who build with wood need a way to turn the effect off - WorldGuard: Treecapitator respects WorldGuard regions. In a protected area, trees are chopped the normal way
- CoreProtect: CoreProtect logs every block chopped by Treecapitator. Useful for tracking down griefing
Related plugins: Timber (an alternative with an animation), EssentialsX (commands), Jobs Reborn (earning money by chopping trees).