Harvest+ v1.2

Farming on most servers is tedious. You break a crop, replant by hand, wait, repeat. Tree chopping means floating leaves and half-destroyed trunks. Bonemeal only affects one crop. There is no reward system, no progression, no reason to actually care about your farm.

Harvest+ changes that. Every crop harvest is instant with auto-replant. Every tree you chop falls as a full physics animation - trunks crash down and damage entities below or destroy instantly, you pick the mode. Bonemeal becomes an area-of-effect tool that boosts entire rows of crops at once. Sneak near your fields and Farmer's Dance accelerates growth with visual and audio feedback.

This is not a simple auto-replant plugin. It is a complete farming overhaul with per-player settings, XP rewards, booster multipliers, WorldGuard respect, and a settings GUI your players will actually use.



◆ Auto-Replant System

• 8 supported crops: Wheat, Carrots, Potatoes, Beetroots, Nether Wart, Cocoa, Sweet Berries, Glow Berries
• Left-click or right-click harvesting - per-player harvest mode toggle (BOTH, LEFT, RIGHT)
• Seed cost configurable per crop type - seeds deducted from harvest drops first, then inventory
• VIP permissions for instant replant, no seed cost, and custom delay tiers
• Auto-replant saplings from broken leaves - finds valid soil automatically

◆ Tree Fall Mechanic

• Three modes: FALL (animate physics), DESTROY (instant removal), FALL_DESTROY (animate then drop items)
• Full physics simulation - logs fly proportional to height, leaves scatter
• Entity damage on impact - configurable damage value, never hurts the chopper
• Natural-only detection via PDC - skip player-placed logs automatically
• WorldGuard integration - respects region build permissions
• Optional axe requirement, per-world whitelist/blacklist, auto-replant sapling after fall

◆ Farmer's Dance

• Sneak near crops to periodically advance their growth stage
• Configurable range, check interval, growth chance, and max crops per tick
• Particle and sound feedback per boosted crop
• Optional permission requirement - gated by harvestplus.farmersdance

◆ Bonemeal Enhancement

• Area-of-effect bonemeal - boosts multiple crops in configurable radius
• Configurable growth stages per use, max crops per application
• Randomized crop selection with particle effects and sound
• Optional bonemeal consumption, per-player enable/disable toggle

◆ Immature Crop Protection

• Prevents breaking crops that are not fully grown
• Action bar warning message when protection blocks a break
• Bypass permission for staff - harvestplus.bypass.immature
• Per-player toggle via GUI - players opt out individually

Every harvest rewards XP. The amount is configurable per crop type and scales through three multiplier layers:

◆ Fortune Multiplier

• Fortune I 1.2x - Fortune II 1.4x - Fortune III 1.5x - all configurable
• Vanilla XP drops are disabled - Harvest+ manages everything

◆ VIP Multipliers

• harvestplus.vip.xp.1.5 - 1.5x multiplier
• harvestplus.vip.xp.2 - 2.0x multiplier
• harvestplus.vip.xp.3 - 3.0x multiplier
• Highest takes priority - permissions nest cleanly

◆ Booster System

• Admin-granted temporary XP and drop multipliers per player
• Configurable default duration, max duration, and cooldown between uses
• Persisted to MySQL and loaded on player join
• Command-driven: /harvestplus booster <player> <duration> <xp> <drops>

◆ Settings GUI

• Open with /harvestplus settings - clean 36-slot GUI with glass-pane borders
• Seven per-player toggles: Auto-Replant, Harvest Mode, BossBar, Farmer's Dance, Tree Fall, Bonemeal, Crop Protection
• Globally disabled features shown as gray fillers - no confusion
• Changes save instantly and persist across restarts

◆ BossBar Feedback

• +XP and crop name displayed on harvest with configurable duration
• Configurable color and style - YELLOW SOLID by default
• Per-player toggle - players who prefer minimal UI can disable it

◆ Particles and Sounds

• Harvest, replant, sapling, farmer's dance, and bonemeal each have their own particle and sound
• Every particle type, amount, spread, and speed is config-driven
• Every sound type, volume, and pitch is config-driven
• Global enable/disable toggle for both particles and sounds

◆ Storage

• MySQL via HikariCP: connection pooling, async load and save, safe shutdown flush
• YAML flat-file: zero external dependencies, instant setup
• Mode selected in config.yml - switch anytime, data stays intact
• Migration system for MySQL - new columns added automatically without data loss

◆ Performance Safeguards

• Debounce system - configurable millisecond window prevents spam harvesting
• In-memory player data cache with on-quit cleanup - no memory leaks
• Async database operations toggle - keep heavy I/O off the main thread
• Concurrent data structures throughout - no race conditions under load

◆ Aliases: /hp /harvest

• Survival and SMP servers Make farming feel rewarding instead of a chore. VIP permissions give you monetisation hooks built right in.
• Skyblock and OneBlock Every crop matters. Auto-replant, XP bonuses, and boosters turn small islands into efficient production lines.
• Earth and Towny servers WorldGuard integration means crop harvesting and tree fall respect town and nation borders. Per-world whitelists give you full control.
• Farming and economy servers Drop multipliers via boosters, Fortune scaling, and configurable seed costs let you tune the entire farming economy from one file.