💡 Why SwiftHarvest?

Most VeinMiner plugins break hundreds of blocks at once and leave your server drowning in item entities. SwiftHarvest was built performance-first: drops are merged and sent to the player's inventory, blocks break in a smooth animation instead of a single-tick spike, and everything is configurable down to the tool tier.

✨ Features

🎮 For Players

• VeinMiner: hold a pickaxe and break an ore to mine the whole vein
• Timber: hold an axe and break a log to chop the whole tree
• Preview particles: green particles show which blocks will break before you commit
• Break animations: Ripple (outward), Wave (bottom-up), or Random
• Safe by design: won't activate if your tool would break mid-use
• Fortune & Silk Touch work exactly like vanilla

🛠️ For Admins

• Per-tier tool config: set max-blocks, durability cost, and cooldown for each tool tier, for both VeinMiner and Timber
• Anti-bleed tree detection: strict mode follows the trunk so neighboring trees stay untouched
• 3 activation modes: Sneak, Toggle, or Hold
• Fortune cap: stop overpowered drops with max-fortune-multiplier
• World blacklist: disable it in the Nether, End, or any world you choose
• WorldGuard support: custom swift-harvest region flag
• Custom messages: every player-facing string lives in messages.yml
• Hot reload: /sh reload applies config changes without a restart

🚀 Quick Start

1. Drop the jar into /plugins
2. Start your server (Paper/Purpur 1.21.11+, Java 21)
3. Done. Defaults work out of the box.

How players use it: hold a pickaxe or axe, hold Shift, then break the block.

Want a different feel? Change activation-mode in config.yml:

🧩 Supported Blocks

⌨️ Commands

🔐 Permissions

⚙️ Configuration

settings:
  activation-mode: "sneak"      # sneak | toggle | hold
  hold-ticks: 10
  cooldown: 10                  # ticks (20 = 1 second)
  preview-particles: true

veinminer:
  enabled: true
  scan-mode: "cardinal"         # cardinal (6 dirs) | diagonal (10 dirs)
  max-fortune-multiplier: 3.0
  use-tiers: false              # enable per-tier limits
  tool-tiers:
    DIAMOND_PICKAXE:
      max-blocks: 64
      durability-multiplier: 0.8
      cooldown-multiplier: 0.8

timber:
  enabled: true
  break-leaves: true
  detection: "strict"           # strict (anti-bleed) | loose
  max-horizontal-radius: 2

animation:
  enabled: true
  blocks-per-tick: 4
  style: "ripple"               # ripple | wave | random

worlds:
  blacklist:
    - world_nether
    - world_the_end

🔌 WorldGuard

SwiftHarvest registers the region flag swift-harvest (default: allow). Disable it in a region with:

/region flag <region> swift-harvest deny

WorldGuard is optional, and the integration turns on automatically when it's detected.

License: MIT • Version: 1.3.0