SwiftHarvest

# SwiftHarvest **Mine Faster, Lag Less. The Ultimate Vein & Timber Solution.** A modern, lightweight Minecraft server plugin for PaperMC that brings VeinMiner and Timber functionality with performance optimizations. --- ## Features - **VeinMiner** - Mine entire ore veins with one swing (Pickaxe + Sneak + Break) - **Timber** - Chop entire trees instantly (Axe + Sneak + Break) - **Preview Particles** - See which blocks will be mined before breaking - **Smart Durability** - Tool durability decreases proportionally to blocks broken - **Drop Consolidation** - Items automatically go to inventory (no lag from 100+ drops) - **XP Orb Consolidation** - Multiple XP drops merge into one orb - **WorldGuard Support** - Respects region protection flags - **Configurable** - Full control over tools, blocks, and limits --- ## Commands | Command | Description | |---------|-------------| | `/swifthavert reload` | Reload configuration (admin) | **Aliases:** `/sh` --- ## Permissions | Permission | Description | Default | |------------|-------------|---------| | `swifthavert.use` | Use SwiftHarvest features | true | | `swifthavert.veinminer` | Use VeinMiner | true | | `swifthavert.timber` | Use Timber | true | | `swifthavert.bypass` | Bypass world blacklist | op | | `swifthavert.admin` | Admin commands | op | --- ## Usage ### VeinMiner 1. Hold a **Pickaxe** 2. **Sneak** (hold Shift) 3. **Break** an ore block 4. All connected ores of the same type will break! ### Timber 1. Hold an **Axe** 2. **Sneak** (hold Shift) 3. **Break** a log block 4. The entire tree will be chopped! ### Preview Particles When enabled in config, aiming at a block while sneaking will show green particles indicating how many blocks will be affected. --- ## Configuration Example `config.yml`: ```yaml settings: require-sneak: true max-blocks: 64 cooldown: 10 preview-particles: true veinminer: enabled: true allowed-tools: - WOODEN_PICKAXE - STONE_PICKAXE - IRON_PICKAXE - GOLDEN_PICKAXE - DIAMOND_PICKAXE - NETHERITE_PICKAXE valid-blocks: - COAL_ORE - IRON_ORE - GOLD_ORE - DIAMOND_ORE - REDSTONE_ORE - LAPIS_ORE - EMERALD_ORE timber: enabled: true allowed-tools: - WOODEN_AXE - STONE_AXE - IRON_AXE - GOLDEN_AXE - DIAMOND_AXE - NETHERITE_AXE break-leaves: false worlds: blacklist: - world_nether - world_the_end ``` --- ## Technical Details - **Algorithm**: BFS (Breadth-First Search) - No recursion, prevents StackOverflow - **Max Blocks**: Configurable limit (default: 64) prevents lag - **Thread Safety**: Block calculation runs async, breaking on main thread - **Drop System**: Consolidates drops to inventory before dropping --- ## Support - Issues: (https://github.com/Syaaddd/SwiftHarvest/issues) --- **License:** MIT **Version:** 1.0.0