Our news See more of us on Google? Add
Discord
Treecapitator
Wiki - Plugins

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.

Reading time: ~4 min Platform: Paper / Spigot / Purpur

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:

  1. The player holds an axe (any material: wooden, stone, iron, diamond, netherite)
  2. They hit the bottom block of the tree trunk
  3. The plugin detects all connected logs of the same type above it
  4. All the blocks of the trunk are destroyed at the same time
  5. The wood drops as items to pick up
  6. 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: true on to keep things balanced. Without durability loss, a diamond axe chops down an unlimited number of trees
  • Sneaking: make sure sneak-to-disable is 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).