TreeCutter

TreeCutter is a lightweight and configurable Minecraft plugin that allows players to cut down entire natural trees instantly by sneaking and breaking the bottom log. Tool durability is respected, commands are LuckPerms-friendly, and admins have full control.

Features

• Instant tree cutting when sneaking and breaking the bottom log.
• Tool durability handling with Unbreaking support.
• Durability break confirmation (crouch + break again) with silent confirmed break.
• Player-made tree blocking with a dedicated toggle: behavior.block-player-made-trees.
• Tracking for player-placed and command-placed logs (setblock / fill) with configurable max fill volume.
• WorldGuard compatibility with strict block-break checks and optional plugin flag support.
• Blacklist system with action-bar warnings and /tcmsg off to hide blacklist warnings.
• Unblacklist action-bar notice, including delivery when the player joins later.
• Prefix and messages fully configurable through config.yml and messages.yml.
• Compatible with Paper, Purpur, and Spigot 1.21+.

Installation

1. Download TreeCutter.jar.
2. Place it in the server's plugins folder.
3. Start the server to generate default config files: config.yml messages.yml
4. Configure options as needed.
5. Restart the server (or run /tcadmin reload) to apply changes.

Commands

Player Commands

Admin Commands

Admin commands are only visible to users with permission.

Permissions

• treecutter.use -> Allows cutting trees
• treecutter.command.tc -> Base access to /tc
• treecutter.command.tcmsg -> Access to /tcmsg
• treecutter.command.tc.on -> Access to /tc on
• treecutter.command.tc.off -> Access to /tc off
• treecutter.command.tc.status -> Access to /tc status
• treecutter.command.tc.help -> Access to /tc help
• treecutter.command.tcadmin -> Base access to /tcadmin
• treecutter.command.tcadmin.on -> Access to /tcadmin on
• treecutter.command.tcadmin.off -> Access to /tcadmin off
• treecutter.command.tcadmin.reload -> Access to /tcadmin reload
• treecutter.command.tcadmin.blacklist -> Access to blacklist admin actions
• treecutter.command.tcadmin.check -> Access to /tcadmin check
• treecutter.command.tcadmin.help -> Access to /tcadmin help
• treecutter.bypass.worldguard -> Bypass WorldGuard checks

Permissions are fully enforced with LuckPerms. OP fallback only applies if LuckPerms is not installed.

Configuration Files

config.yml

enabled: true

disabled-players: []
blacklist: []
blacklist-message-disabled: []
pending-unblacklist-notice: []
prefix: "&8[&3T&bC&8]"

behavior:
  sneak-required: true
  block-player-made-trees: true
  require-axe: false
  max-tree-size: 256
  cooldown-seconds: 1.0
  confirmation-required: true
  confirmation-time-seconds: 10

  tree-detection:
    max-leaf-search-radius: 3
    max-leaf-search-up: 5
    min-leaf-count: 4
    max-horizontal-spread: 6
    require-upward-growth: true

placed-log-tracking:
  player-placed: true
  command-placed: true
  max-fill-volume: 50000

notifications:
  blacklist-actionbar-seconds: 10
  unblacklist-actionbar-seconds: 10

drops:
  drop-items: true
  preserve-tool-durability: false
  allow-vanilla-drops: false

hooks:
  worldguard:
    enabled: true
    deny-partial-breaks: true
  placeholderapi:
    enabled: true

messages.yml

• Fully customizable player/admin messages.
• Supports placeholder replacements ({prefix}, {player}, {time}, {tool}, {count}, etc).
• Blacklist action-bar warning text is configurable, including /tcmsg off hint.

Notes

• /tcmsg does not show tab suggestions by design.
• If a player is unblacklisted while offline, the green unblacklist notice appears on next join.
• For region protection, keep hooks.worldguard.enabled: true and avoid giving treecutter.bypass.worldguard unless intended.