███████╗███████╗████████╗██████╗░███████╗███████╗ ██╔════╝╚════██║╚══██╔══╝██╔══██╗██╔════╝██╔════╝ █████╗░░░░███╔═╝░░░██║░░░██████╔╝█████╗░░█████╗░░ ██╔══╝░░██╔══╝░░░░░██║░░░██╔══██╗██╔══╝░░██╔══╝░░ ███████╗███████╗░░░██║░░░██║░░██║███████╗███████╗ ╚══════╝╚══════╝░░░╚═╝░░░╚═╝░░╚═╝╚══════╝╚══════╝ ## **Simplify tree farming in Minecraft EzTree** is a lightweight yet highly configurable Minecraft plugin that turns repetitive log chopping into a single swing. Whether you manage a survival server, an MMO economy or a creative community, EzTree accelerates tree farming while keeping resource usage minimal. ![https://img.shields.io/badge/Latest%20version-3.0.1-blue](https://img.shields.io/badge/Latest%20version-3.0.1-blue) ![https://img.shields.io/badge/Minecraft%20version-1.7%20to%201.21-blue](https://img.shields.io/badge/Minecraft%20version-1.7%20to%201.21-blue) ![https://img.shields.io/badge/Requires-Java%2017+-brightgreen](https://img.shields.io/badge/Requires-Java%2017+-brightgreen) **Dial in your preferred automation style** * **Toggle system**: Decide whether players flip automation on with any axe, only the custom Tree Breaker, or a curated list of vanilla tools. Persist activation between trees, add cooldowns, and surface action-bar feedback to keep players informed. * **Tree detection**: Mix-and-match per-species size limits, minimum leaf requirements, stripped log support and 2x2 trunk checks so every tree type behaves the way your server expects. * **Cleanup rules**: Configure separate attachment lists for Tree Breaker swings and auto-replant so vines, berries, buttons or lights disappear before saplings return. * **Economy hooks**: Pair with Vault to pay or charge per tree, per log, or per permission group. Combine with `groups.yml` to give donors and jobs bespoke rates. * **Progression gates**: Gate automation behind EzSkills or mcMMO skill brackets, EzTree's built-in stat milestones, or permission-group overrides. Mix these levers to keep early-game balanced while letting veterans tear through mega-trees. * **Messaging & UX**: Localize every chat prompt, toggle notice and error with bundled English, Spanish and Dutch translations. Optional titles, action bars and sounds let you craft the exact feedback loop your players prefer. ### **Why servers choose EzTree** * **Instant tree breaking**: Right-click with any whitelisted axe (or the custom Tree Breaker) to toggle full-tree harvesting. Optional chat messages, action bar animations (`eztree.animation`) and a persistent activation mode keep farmers in the zone. * **Smart detection**: Every tree is validated by leaves, trunk size and optional per-species min/max limits, with support for 2x2 giants, stripped logs and the quirkiest custom trees. * **Automatic clean-up**: Replant saplings immediately—even 2x2 formations—and configure attachments to clear vines, berries or grass before replanting. * **Anti-abuse safeguards**: Stop piston farming or bone meal spam with built-in abuse-prevention toggles, and curb idle macroing with the anti-AFK timer. * **Progression & balancing**: Drop configurable XP, enable cooldowns, gate larger trees behind player ranks or EzSkills/mcMMO levels, or restrict usage through permission checks and group-specific size caps. * **Economy & metrics ready**: Pay or charge players per tree with Vault, surface usage analytics through bStats, and let update checks warn you about new releases. * **Plugin friendly**: Integrations for WorldGuard (custom region flags), EzSkills (TREE_FELLER awareness + level configs), mcMMO (classic skill progression) and Vault ensure EzTree fits right into established server stacks. ### **Quick start** * **Install** EzTree alongside optional dependencies ([WorldGuard](https://www.spigotmc.org/resources/worldguard.51532/), [Vault](https://www.spigotmc.org/resources/vault.34315/), [EzSkills](https://www.spigotmc.org/resources/1-7-1-21-ezskills-lightweight-rpg-skill-ability-framework.131061/) for built-in skill progression or `mcMMO` for legacy setups). * **Reload or restart** your server to generate the default configuration files. * **Give your staff** the `/eztree` command (alias `/et`) to hand out the custom Tree Breaker and `/eztree reload` for quick configuration tweaks. * **Tune** `config.yml` using one of the presets below or your own settings. ### **Standalone Tree Breaker usage** * **Spawn the tool**: Run `/eztree` (permission `eztree.custom-tool`) to place the Tree Breaker directly into a player's inventory. This works even when the toggle system is disabled. * **Prime it**: Right-click to arm the breaker. Players can optionally keep it latched on consecutive trees by setting `toggle.keep-activated: true`. * **Harvest**: Break a single log to trigger the full-tree felling logic. Attachments such as vines or berries are cleared automatically when `attachments.tree-breaker.enabled` is true. * **Share sparingly**: Because the tool is only obtainable via the command, staff retain control over who can wield it—perfect for crates, quest rewards or VIP kits. ### **Tool configuration deep dive** * **Whitelist the right gear**: Populate `toggle.tools` with vanilla axe materials, the bespoke `CUSTOM_TOOL` placeholder, or even non-axe items to shape how players opt into automation. * **Separate Tree Breaker rules**: Tweak `custom-tool` to rename the breaker, inject lore, swap out the icon and assign glow or enchantments without touching the rest of the toggle flow. * **Per-context behavior**: Use `toggle.keep-activated`, `toggle.cooldown` and `toggle.message` flags to define how tools behave for casual players versus high-output farms. * **Override by group**: Combine tool whitelists with `groups.yml` presets so donors, factions or staff can access exclusive automation tools. * **Audit usage**: Track which tools trigger EzTree through `player-stats.yml` counters to see which presets resonate with your community. ### **Custom tool-only axe setups** Lock the automation to the Tree Breaker (or a specific set of axe icons) by trimming the toggle list: ```yaml toggle: enabled: true tools: # - CUSTOM_TOOL Only the /eztree Tree Breaker can toggle automation custom-tool: enabled: true tool: material: NETHERITE_AXE name: "&6TREE BREAKER" lore: - "Exclusive guild reward" ``` Want a mix of icon-only axes? Swap `CUSTOM_TOOL` for regular Minecraft materials (for example `GOLDEN_AXE` or `STONE_AXE`) so only those textures activate EzTree while everyone else keeps vanilla breaking. ### **Core commands & permissions** [table="width: 100%, class: grid"] [tr][th]Command[/th][th]Description[/th][th]Permission[/th][/tr] [tr][td]`/eztree` or `/et`[/td][td]Give the configured custom Tree Breaker tool.[/td][td]`eztree.custom-tool`[/td][/tr] [tr][td]`/eztree reload`[/td][td]Reload the configuration without restarting the server.[/td][td]`eztree.reload`[/td][/tr] [/table] Additional permissions: * `eztree.use` – Allow players to toggle and use automated tree breaking (granted by default). * `eztree.animation` – Show the toggle animation when the breaker is activated (great for cosmetic donator perks). * `eztree.command` – Base permission required to run `/eztree` commands. * `eztree.reload` – Restrict configuration reloads to trusted staff. ### **Configuration highlights** * **Toggle**: Choose which tools can activate EzTree, whether to keep the breaker active between trees, and how cooldowns behave. * **Auto-replant & attachments**: Configure which blocks get cleared before saplings return and whether vine/cobweb cleanup happens automatically. * **Anti-abuse & anti-AFK**: Use `abuse-prevention` to block piston or bone-meal automation, and enable `anti-afk` to ignore tree breaks after an idle threshold. * **Player stats**: Track totals in `player-stats.yml` to unlock larger trees after players reach tree/log milestones. * **Skill integrations**: Define per-skill thresholds in `ezskills.yml` or `mcmmo.yml` so seasoned players unlock higher limits automatically, and flip `integrations.ezskills.ranked-progression` or `integrations.mcmmo.ranked-progression` to enforce max tree sizes per preset. * **Groups**: Pair Vault with `groups.yml` to override tree size limits per permission group. * **Messages**: Fully customize chat text and colors for toggles, cooldown warnings, economy feedback and errors, and pick the default bundle with `language: en|es|nl`. ### **Auto-replant & farm upkeep** Keep farms tidy with two complementary systems: * **attachments.tree-breaker** sweeps vines, cobwebs and other clutter before the tree collapses. * **attachments.auto-replant** frees the planting space, guaranteeing saplings replant instantly even in tight farms. * **auto-replant.enabled** reintroduces the next generation of trees without relying on drops or hopper setups. ### **Anti-abuse & anti-AFK controls** Protect high-throughput farms without banning the feature: * **Block piston farms**: Set `abuse-prevention.piston.enabled` to stop logs or saplings from being shoved into repeatable EzTree triggers. * **Limit bone meal spam**: Turn on `abuse-prevention.bone-meal.enabled` and optionally `remove-target` to clear the sapling when someone tries to bone-meal it. * **Stop idle macroing**: Enable `anti-afk.enabled` with `max-idle-seconds` to ignore EzTree breaks from idle players. ### **Player progression levers** * **Ranks**: Gate tree size through `player-stats.yml` thresholds, rewarding loyal farmers with bigger harvests. * **Skill sync**: Respect `TREE_FELLER`, blend EzTree limits with EzSkills or mcMMO levels for skill-driven growth, and optionally clamp tree size per skill bracket by enabling `integrations.ezskills.ranked-progression` or `integrations.mcmmo.ranked-progression`. * **Groups**: Combine Vault with `groups.yml` to give donors, factions or jobs bespoke height caps. ### **Skill mastery integrations** * **mcMMO synergy**: Honor classic woodcutting levels by enabling `integrations.mcmmo.enabled` and optionally `ranked-progression` to clamp automation until players earn it. * **Hybrid progression**: Layer EzTree's internal `player-stats.yml` ranks on top of skill plugins so servers can mix playtime-based unlocks with ability-driven caps. * **Configurable boosts**: Trigger temporary perks like double drops or faster cooldown recovery via EzSkills ability windows, aligning automation bursts with your RPG events. * **Clear feedback**: Surface skill requirements through localized messages (`messages.toggle.skill-requirement`) so players always know the next goal to unlock bigger trees. ### **Economy balancing** * **Rewards**: Pay per tree or scale by logs felled with `integrations.vault.reward`. * **Costs**: Charge upkeep for automated harvesting using `integrations.vault.cost` with optional per-log scaling. * **Cooldowns**: Rein in throughput via `cooldown.amount` so servers with hyper-fast farms keep pace. ### **Version support** * **EzTree 1.x** – Targets Minecraft 1.21.* servers. * **EzTree 2.x** – Built for Minecraft 1.21.* with the 1.20.6 API for backwards compatibility. * **EzTree 3.x** – Built for Minecraft 1.21.* with the 1.7 API for backwards compatibility ### **WorldGuard integration** EzTree registers two custom flags: * **eztree-allowed** – Permit EzTree actions inside the region (use with `allow-sections-only: true`). * **eztree-use** – Deny EzTree actions when set to `deny`. Enable the integration by toggling the following in `config.yml`: ```yaml integrations: worldguard: enabled: true allow-sections-only: false ``` Once the plugin loads it will automatically register the flags. Manage them in-game with standard WorldGuard region commands such as: ``` /rg flag spawn eztree-allowed allow /rg flag market eztree-use deny ``` ### **Ready-to-use presets** Copy a preset into `config.yml` (and companion files) to hit the ground running. * **Survival-friendly defaults** – Keep gameplay close to vanilla while speeding up farming.

survival-friendly defaults

```yaml auto-replant: enabled: true exp: enabled: true fixed: true amount: 5 toggle: enabled: true message: true animation: true keep-activated: false integrations: worldguard: enabled: false vault: enabled: false spigot: check-for-update: true messages: toggle: activation: "&aTree breaking activated" deactivation: "&cTree breaking deactivated" ```

* **Economy-focused** – Reward players per tree and optionally charge for the service.

economy-focused

```yaml integrations: vault: enabled: true # group-specific: true Pair with tree.*.group-specific flags to read limits from groups.yml reward: enabled: true amount: 15 # fixed: false Reward scales with the number of logs cost: enabled: true amount: 5 # per-log: false Flat cost per tree messages: cost: insufficientFunds: "&cYou do not have enough money to use this tool." transactionError: "&cAn error occurred while processing the payment." ```

* **Ranked progression** – Gate larger trees behind bStats player milestones.

ranked progression

```yaml player-stats: enabled: true storage: player-stats.yml default-max-tree-size: 24 ranks: sapling: minimum-trees: 0 minimum-logs: 0 max-tree-size: 24 lumberjack: minimum-trees: 50 minimum-logs: 1000 max-tree-size: 64 grandmaster: minimum-trees: 200 minimum-logs: 4000 max-tree-size: 128 tree: max-count: # group-specific: true Requires Vault group-specific support to load from groups.yml ```

* **EzSkills-friendly** – Respect TREE_FELLER while still allowing EzTree automation. Flip `ranked-progression` on to read `max-tree-size` caps from the level presets you define in `ezskills.yml`.

ezskills-friendly

```yaml integrations: ezskills: enabled: true skill: WOODCUTTING level-specific: true ranked-progression: true prevent-toggle-conflict: true ability: TREE_FELLER ability-preparation-grace-period-ticks: 10 ```

### **Need help?** Join the discussion on our SpigotMC support thread for questions, feature requests or bug reports. [Hop into our Discord server](https://discord.gg/ywp95xfmbs) for live support, release news and community tips. ![https://bstats.org/signatures/bukkit/eztree.svg](https://bstats.org/signatures/bukkit/eztree.svg)