BetterTreecapitator

Turn tree chopping into a smoother and more satisfying experience.

BetterTreecapitator is a lightweight, configurable Treecapitator plugin for Paper and Spigot servers. Craft one special axe, chop connected logs quickly, keep track of its durability, and see exactly which logs are supported before chopping.

Looking for unlimited custom Treecapitators, per-tool permissions, effects, replanting, and an in-game admin editor? Check out BetterTreecapitator Premium.

Free Features

• One balanced, craftable Treecapitator.
• Configurable crafting recipe.
• Configurable cooldown and minimum/maximum number of logs chopped.
• The configured min and max count the total logs chopped, including the first log.
• Persistent custom durability with lore and action-bar feedback.
• Automatic aqua particle outlines while holding the axe and aiming at a supported log.
• Highlights are private: only the player holding the Treecapitator sees them.
• /treecapitator buy links players directly to the Premium edition.
• Built-in bStats metrics.

Commands

Command	Description
/treecapitator give <player>	Give the Free Treecapitator.
/treecapitator reload	Reload the configuration.
/treecapitator highlight	Instantly refresh the log outline. Highlighting is already automatic by default.
/treecapitator buy	Show the Premium edition link.
/treecapitator version	Show plugin information. Aliases: ver, v.

Permissions

Permission	Default
bettertreecapitator.give	OP
bettertreecapitator.reload	OP

Configuration

The Free edition intentionally keeps configuration simple:

cooldown: 5
min: 5
max: 5

display:
  durability-action-bar: true
  highlight-enabled: true
  highlight-interval-ticks: 10
  highlight-range: 16
  highlight-max-logs: 5

craft:
  enabled: true
  shape: ["III", "IAI", "III"]
  ingredients:
    I: IRON_INGOT
    A: DIAMOND_AXE

min and max are the total number of logs chopped, including the first log broken by the player. You can also configure the automatic highlight range, its refresh rate, the maximum number of outlined logs, and the durability action bar.

Premium Edition

Premium is made for servers that want a fully branded and expandable Treecapitator system:

• Unlimited custom Treecapitators.
• Per-tool permissions.
• Per-tool recipes, sounds, particles, cooldowns, durability, materials, and supported logs.
• Optional auto-pickup and auto-replanting.
• Configurable chat messages.
• In-game admin GUI with live editing for key settings.

Get it here: BetterTreecapitator Premium

Compatibility

• Paper / Spigot 1.18.2 to 26.3
• Java 17 to 25
• No ProtocolLib required.

Installation

1. Drop the JAR into your server's plugins folder.
2. Start or restart the server.
3. Edit plugins/BetterTreecapitator/config.yml if needed.
4. Use /treecapitator give <player> to test the axe.

When updating from an older version, back up your existing config.yml and merge the new configuration options.