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

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.





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.
• Progression & balancing: Drop configurable XP, enable cooldowns, gate larger trees behind player ranks, 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), mcMMO (TREE_FELLER awareness) and Vault ensure EzTree fits right into established server stacks.

Quick start

1. Install EzTree alongside optional dependencies (WorldGuard, Vault, mcMMO).
2. Reload or restart your server to generate the default configuration files.
3. Give your staff the /eztree command 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.

Core commands & permissions

Command	Description	Permission
/eztree	Give the configured custom Tree Breaker tool.	eztree.custom-tool
/eztree reload	Reload the configuration without restarting the server.	eztree.reload

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.

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.
• Player stats: Track totals in player-stats.yml to unlock larger trees after players reach tree/log milestones.
• 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.

Version support

• EzTree 1.x – Targets Minecraft 1.20.6 servers.
• EzTree 2.x – Built for Minecraft 1.21+ with the 1.20.6 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 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
   
• mcMMO-friendly – Respect TREE_FELLER while still allowing EzTree automation.
  
  Spoiler: mcMMO-friendly

  Code (YAML):

  
  integrations:
    mcmmo:
      enabled : true
      skill : WOODCUTTING
      level-specific : 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.