Skip to content

About

A lightweight, customizable automatic tree chopping plugin for Paper/Folia servers.

Topics

Resources

Stars

8 stars

Watchers

2 watching

Forks

Repository files navigation

AutoTreeChop

atc-intro
AutoTreeChop lets your players chop entire trees by breaking just one log. It's async-friendly, lightweight, and fully customizable — with built-in support for MySQL(optional), CoreProtect, and popular protection plugins.


Key Features

🌲 Smart Tree Chopping

  • Chop entire trees by breaking just one log
  • Activation modes: command(/atc), hold sneak, command + sneak, or sneak + swap-hand key (normally Shift+F)
  • Async support for smooth performance on Modern servers
  • Customizable leaves cleaner

⚡ Lightweight & Easy to Configure

  • Minimal performance impact
  • Simple setup, and user-friendly configuration

🔁 Auto Replanting

  • Automatically replant saplings after chopping
  • Optionally require players to have saplings

🧑‍🤝‍🧑 Player Control & Limits

  • Daily limits for usage and chopped blocks
  • Optional Minecraft mined-block statistics for chopped logs (disabled by default)
  • Configurable cooldowns
  • Custom permission groups with priorities, daily limits and cooldowns

🛡️ Full Protection Plugin Support

  • Compatible with Residence, WorldGuard, Lands, GriefPrevention, BlockLocker and LockettePro
  • Supports CoreProtect for logging actions

🗄️ MySQL & SQLite Support

  • Scale with MySQL or keep it simple with SQLite (default)

Translations

Automatically switches to the player's locale if enabled.

Translation Status

Supported Plugins

Since we call the block break event directly by default, plugins such as CoreProtect and Drop2Inventory should be supported without modification.

  • WorldGuard
  • Residence
  • Lands
  • GriefPrevention
  • BlockLocker
  • LockettePro
  • PlaceholderAPI

Commands

Command Description
/atc Toggle AutoTreeChop
/atc confirm Confirm a pending chop after a safety warning
/atc usage Show daily usage
/atc settings [setting] [value] View or change personal settings
/atc settings reset Restore all server defaults
/atc settings player <player> [setting] [value] View or change an online player's settings (admin)
/atc settings player <player> reset Restore an online player's server defaults (admin)
/atc reload Reload plugin config
/atc toggle <player> Toggle for another player
/atc enable <player/@a/@r/@p> Enable for other players
/atc disable <player/@a/@r/@p> Disable for other players
/atc about Plugin info

Personal settings: activation accepts default, disabled, command, sneak, command-and-sneak, or hotkey; sneak-messages, leaves, and replant accept default, on, or off. For example: /atc settings activation hotkey. default follows server changes. Personal settings persist across logins; server-wide disabling and feature permissions still apply.

Permissions

Outside Lite mode, a permission manager such as LuckPerms can manage these permissions.

Permission Description Default
autotreechop.use Use /atc, /atc confirm, and /atc usage commands Everyone
autotreechop.settings Manage personal settings (also requires autotreechop.use) Everyone
autotreechop.settings.other View or change another online player's settings OP
autotreechop.group.<name> Apply a configured group Explicit grant
autotreechop.vip Legacy VIP fallback (deprecated) OP
autotreechop.other Toggle others' ATC status OP
autotreechop.reload Reload config file OP
autotreechop.updatechecker Receive update notifications OP
autotreechop.replant Enable auto replanting Everyone
autotreechop.leaves Enable leaves removal Everyone

Placeholders

Requires PlaceholderAPI

Placeholder Output
%autotreechop_status% Whether ATC is enabled
%autotreechop_daily_uses% Times used today
%autotreechop_daily_blocks_broken% Tree blocks chopped today

Developer API

Integrate through Bukkit ServicesManager to read player state, effective group limits/cooldown, and change the ATC preference. See the API guide for dependency setup, lifecycle and threading rules, explicit operation results, and a compiled example plugin.


Support & Contribute

  • Need help? Join our Matrix
  • Found a bug? Open an issue on GitHub
  • Want to help translate? Get started on this page
  • Love the plugin? Give it a ⭐️ on GitHub

bStats

This plugin uses bStats to collect anonymous usage statistics (such as plugin version, server software, and player count).
These statistics help us improve the plugin.
If you prefer not to participate, you can disable it anytime in: /plugins/bStats/config.yml

bstats


License

    Copyright (C) 2026 MilkTeaMC and contributors

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.

About

A lightweight, customizable automatic tree chopping plugin for Paper/Folia servers.

Topics

Resources

Stars

8 stars

Watchers

2 watching

Forks

Releases

Used by

Contributors

Languages