AutoHarvest+

# AutoHarvest **Vanilla+ auto-harvest and replant for Paper 1.21.x** Break a mature crop and it replants itself. Right-click with bonemeal and it grows, harvests, and replants in one action. No cheats, no duplication, no TPS impact. Just the QoL feature vanilla forgot. --- ## Features ### Break Harvesting Break any mature crop and it drops normally — then replants at growth stage 0 automatically. Vanilla handles the break, drops, tool durability, enchantments, XP, and statistics. AutoHarvest only adds the replant. ### Bonemeal Harvesting Right-click an immature crop with bonemeal. Vanilla advances the growth. If the crop becomes mature from that application, AutoHarvest harvests it, drops the items, and replants — all in one click. One bonemeal consumed per use, exactly like vanilla. ### Seed Fairness The bonemeal path subtracts one seed from drops to prevent duplication. Without this, every bonemeal harvest would create a free seed (the crop is replanted but drops include the replant cost). AutoHarvest enforces net-zero: bonemeal harvesting produces the same drops as manually breaking and replanting. ### Per-Player Toggle `/autoharvest toggle` — players who want pure vanilla can opt out. State persists across relogs and server restarts via PersistentDataContainer. No database required. --- ## Supported Crops | Crop | Replant Age | Notes | |------|-------------|-------| | Wheat | 0 | Standard ageable crop | | Carrots | 0 | Standard ageable crop | | Potatoes | 0 | Poisonous potato drops preserved | | Beetroot | 0 | Standard ageable crop | | Nether Wart | 0 | Validates soul sand beneath before replanting | | Cocoa Beans | 0 | Preserves facing direction, validates jungle log | | Sweet Berries | 1 | Matches vanilla right-click harvest feel | ### Explicitly Not Supported - **Sugar cane, bamboo, cactus, kelp** — vertical growth, dupe risk with pistons - **Melons, pumpkins** — stem-based, already effectively auto-replant - **Chorus fruit** — not a farm crop --- ## Commands | Command | Description | Permission | |---------|-------------|------------| | `/autoharvest toggle` | Toggle for yourself | `autoharvest.use` | | `/autoharvest toggle <player>` | Toggle for another player | `autoharvest.admin.toggle-others` | | `/autoharvest info` | Show status, version, enabled crops | `autoharvest.use` | | `/autoharvest reload` | Reload configuration | `autoharvest.admin.reload` | Alias: `/ah` works for all commands. --- ## Permissions | Permission | Default | Description | |------------|---------|-------------| | `autoharvest.use` | `true` | Toggle and info commands | | `autoharvest.break` | `true` | Auto-harvest on crop break | | `autoharvest.bonemeal` | `true` | Auto-harvest via bonemeal | | `autoharvest.admin` | `op` | All admin commands | | `autoharvest.admin.reload` | `op` | Reload configuration | | `autoharvest.admin.toggle-others` | `op` | Toggle for other players | Set `require-permission: true` in config to require `autoharvest.use` for the plugin to function at all. By default, it works for everyone. --- ## Configuration All settings in `plugins/AutoHarvest/config.yml`. Changes take effect with `/autoharvest reload` — no server restart needed. ```yaml general: default-enabled: true # New players start with auto-harvest on require-permission: false # Require autoharvest.use permission enabled-worlds: # Empty = all worlds. List specific worlds to restrict. disabled-worlds: # These worlds are always excluded - "world_nether" - "world_the_end" harvest: on-break: true # Auto-replant when breaking mature crops on-bonemeal: true # Harvest + replant when bonemealing to maturity require-hoe: false # Only trigger when holding a hoe bonemeal-subtract-replant-cost: true # Fairness: subtract 1 seed from bonemeal drops drops: enabled: true # Set false to suppress all drops (adventure maps) drop-at-center: true # Drop at block center vs exact break location overflow-to-ground: true # Full inventory? Drop on ground, not void crops: # Enable/disable individual crop types wheat: true carrots: true potatoes: true beetroot: true nether_wart: true cocoa: true sweet_berries: true cooldown: bonemeal-ms: 50 # Anti-macro: ms between bonemeal harvests per player feedback: particles: true # Green sparkle particles on harvest sound: true # Crop break sound on harvest sound-name: "block.crop.break" sound-volume: 0.5 sound-pitch: 1.2 debug: false # Log every harvest with player, location, crop, drops ``` Messages are customizable in `messages.yml` using (https://docs.advntr.dev/minimessage/format.html). --- ## How It Works AutoHarvest is designed to be invisible to the game engine. It never cancels events or re-implements vani