███████╗███████╗████████╗██████╗░███████╗███████╗
██╔════╝╚════██║╚══██╔══╝██╔══██╗██╔════╝██╔════╝
█████╗░░░░███╔═╝░░░██║░░░██████╔╝█████╗░░█████╗░░
██╔══╝░░██╔══╝░░░░░██║░░░██╔══██╗██╔══╝░░██╔══╝░░
███████╗███████╗░░░██║░░░██║░░██║███████╗███████╗
╚══════╝╚══════╝░░░╚═╝░░░╚═╝░░╚═╝╚══════╝╚══════╝

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.





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

1. Install EzTree alongside optional dependencies (WorldGuard, Vault, EzSkills for built-in skill progression or mcMMO for legacy setups).
2. Reload or restart your server to generate the default configuration files.
3. Give your staff the /eztree command (alias /et) to hand out the custom Tree Breaker and /eztree reload for quick configuration tweaks.
4. Tune config.yml using one of the presets below or your own settings.

Standalone Tree Breaker usage

1. 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.
2. Prime it: Right-click to arm the breaker. Players can optionally keep it latched on consecutive trees by setting toggle.keep-activated: true.
3. 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.
4. 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:

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"]
CommandDescriptionPermission
/eztree or /etGive the configured custom Tree Breaker tool. eztree.custom-tool
/eztree reloadReload the configuration without restarting the server. eztree.reload
[/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:
Once the plugin loads it will automatically register the flags. Manage them in-game with standard WorldGuard region commands such as:
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.
  
  Spoiler: Survival-friendly defaults

  Code (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.
  
  Spoiler: Economy-focused

  Code (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.
  
  Spoiler: Ranked progression

  Code (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.
  
  Spoiler: EzSkills-friendly

  Code (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 for live support, release news and community tips.