# AutoHarvest<\/p>\n
**Vanilla+ auto-harvest and replant for Paper 1.21.x**<\/p>\n
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.<\/p>\n
—<\/p>\n
## Features<\/p>\n
### Break Harvesting
\nBreak any mature crop and it drops normally \u2014 then replants at growth stage 0 automatically. Vanilla handles the break, drops, tool durability, enchantments, XP, and statistics. AutoHarvest only adds the replant.<\/p>\n
### Bonemeal Harvesting
\nRight-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 \u2014 all in one click. One bonemeal consumed per use, exactly like vanilla.<\/p>\n
### Seed Fairness
\nThe 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.<\/p>\n
### Per-Player Toggle
\n`\/autoharvest toggle` \u2014 players who want pure vanilla can opt out. State persists across relogs and server restarts via PersistentDataContainer. No database required.<\/p>\n
—<\/p>\n
## Supported Crops<\/p>\n
| Crop | Replant Age | Notes |
\n|——|————-|——-|
\n| Wheat | 0 | Standard ageable crop |
\n| Carrots | 0 | Standard ageable crop |
\n| Potatoes | 0 | Poisonous potato drops preserved |
\n| Beetroot | 0 | Standard ageable crop |
\n| Nether Wart | 0 | Validates soul sand beneath before replanting |
\n| Cocoa Beans | 0 | Preserves facing direction, validates jungle log |
\n| Sweet Berries | 1 | Matches vanilla right-click harvest feel |<\/p>\n
### Explicitly Not Supported
\n– **Sugar cane, bamboo, cactus, kelp** \u2014 vertical growth, dupe risk with pistons
\n– **Melons, pumpkins** \u2014 stem-based, already effectively auto-replant
\n– **Chorus fruit** \u2014 not a farm crop<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | Description | Permission | Alias: `\/ah` works for all commands.<\/p>\n —<\/p>\n ## Permissions<\/p>\n | Permission | Default | Description | Set `require-permission: true` in config to require `autoharvest.use` for the plugin to function at all. By default, it works for everyone.<\/p>\n —<\/p>\n ## Configuration<\/p>\n All settings in `plugins\/AutoHarvest\/config.yml`. Changes take effect with `\/autoharvest reload` \u2014 no server restart needed.<\/p>\n “`yaml harvest: drops: crops: # Enable\/disable individual crop types cooldown: feedback: debug: false # Log every harvest with player, location, crop, drops Messages are customizable in `messages.yml` using MiniMessage format.<\/p>\n —<\/p>\n ## How It Works<\/p>\n AutoHarvest is designed to be invisible to the game engine. It never cancels events or re-implements vanilla mechanics.<\/p>\n ### Break Path ### Bonemeal Path ### Why Not Cancel + Manual Drops? AutoHarvest avoids all of this by letting vanilla handle the break completely.<\/p>\n —<\/p>\n ## Performance<\/p>\n AutoHarvest is built for zero measurable TPS impact.<\/p>\n – **`EnumMap ### Benchmarks AutoHarvest+ is a QoL survival mode plugin for easier crop harvesting and replanting mechanics.<\/p>\n","protected":false},"featured_media":23431,"template":"","meta":{"_minecraft_slug":"autoharvest+","_minecraft_project_id":"4yunSeNx","_minecraft_author":"ashkarmalek0","_minecraft_license":"MIT","_minecraft_downloads":11,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"autoharvest+.zip","_minecraft_size_bytes":34989,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:03:46.998993Z","_minecraft_date_created":"2026-04-29T01:19:09.493519Z","_minecraft_date_modified":"2026-04-18T09:15:14.509731Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/autoharvest+","_minecraft_icon_attachment_id":23431,"_minecraft_imported_at":"2026-05-31T22:35:13+00:00","_minecraft_import_hash":"25f73045971695ff456043b0202f1106","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[85,89,127],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-23430","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-food","mod_category-game-mechanics","mod_category-paper","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————-|————|
\n| `\/autoharvest toggle` | Toggle for yourself | `autoharvest.use` |
\n| `\/autoharvest toggle
\n| `\/autoharvest info` | Show status, version, enabled crops | `autoharvest.use` |
\n| `\/autoharvest reload` | Reload configuration | `autoharvest.admin.reload` |<\/p>\n
\n|————|———|————-|
\n| `autoharvest.use` | `true` | Toggle and info commands |
\n| `autoharvest.break` | `true` | Auto-harvest on crop break |
\n| `autoharvest.bonemeal` | `true` | Auto-harvest via bonemeal |
\n| `autoharvest.admin` | `op` | All admin commands |
\n| `autoharvest.admin.reload` | `op` | Reload configuration |
\n| `autoharvest.admin.toggle-others` | `op` | Toggle for other players |<\/p>\n
\ngeneral:
\n default-enabled: true # New players start with auto-harvest on
\n require-permission: false # Require autoharvest.use permission
\n enabled-worlds: [] # Empty = all worlds. List specific worlds to restrict.
\n disabled-worlds: # These worlds are always excluded
\n – “world_nether”
\n – “world_the_end”<\/p>\n
\n on-break: true # Auto-replant when breaking mature crops
\n on-bonemeal: true # Harvest + replant when bonemealing to maturity
\n require-hoe: false # Only trigger when holding a hoe
\n bonemeal-subtract-replant-cost: true # Fairness: subtract 1 seed from bonemeal drops<\/p>\n
\n enabled: true # Set false to suppress all drops (adventure maps)
\n drop-at-center: true # Drop at block center vs exact break location
\n overflow-to-ground: true # Full inventory? Drop on ground, not void<\/p>\n
\n wheat: true
\n carrots: true
\n potatoes: true
\n beetroot: true
\n nether_wart: true
\n cocoa: true
\n sweet_berries: true<\/p>\n
\n bonemeal-ms: 50 # Anti-macro: ms between bonemeal harvests per player<\/p>\n
\n particles: true # Green sparkle particles on harvest
\n sound: true # Crop break sound on harvest
\n sound-name: “block.crop.break”
\n sound-volume: 0.5
\n sound-pitch: 1.2<\/p>\n
\n“`<\/p>\n
\n1. Player breaks a mature crop
\n2. `BlockBreakEvent` fires at `HIGH` priority with `ignoreCancelled = true`
\n3. AutoHarvest validates: survival mode, world enabled, player toggled on, crop mature, environment valid
\n4. Vanilla processes the break \u2014 handles drops, Fortune, tool durability, statistics, advancements
\n5. One tick later, AutoHarvest places the crop back at age 0<\/p>\n
\n1. Player right-clicks a crop with bonemeal
\n2. Vanilla applies the bonemeal \u2014 consumes item, advances growth, plays particles
\n3. One tick later, AutoHarvest checks if the crop is now mature
\n4. If mature: calculates drops, subtracts one seed (fairness), replants, drops items<\/p>\n
\nMany farming plugins cancel the break event and manually calculate drops. This breaks:
\n– **mcMMO \/ Jobs** XP hooks (they read vanilla drops)
\n– **Statistics** (`CROP_WASTED`, block break stats)
\n– **Advancements** (“A Seedy Place”, etc.)
\n– **Tool durability and enchantment processing**
\n– **Any downstream plugin** that listens to `BlockBreakEvent`<\/p>\n
\n– **No streams in event handlers** \u2014 plain loops for JIT-friendly hot paths
\n– **No config re-parsing per event** \u2014 immutable `PluginConfig` snapshot, atomically swapped on reload
\n– **No logging in event handlers** at INFO level \u2014 debug-gated only
\n– **1-tick scheduled replant** via `runTask`, not `runTaskLater(0)`
\n– **Folia compatible** \u2014 uses `RegionScheduler` when Folia is detected, standard `BukkitScheduler` on Paper<\/p>\n
\n| Scenario | Target |
\n|———-|——–|
\n| 10k wheat farm, 5 players harvesting continuously | 19.8+ TPS |
\n| Bonemeal spam (10 clicks\/sec\/player x 4 players) | 19.9+ TPS |
\n| Plugin load time | < 50ms |\n| `\/autoharvest reload` | < 100ms |\n\n---\n\n## Compatibility\n\n- **Paper 1.21.x** (1.21 - 1.21.4+)\n- **Folia** \u2014 detected at startup, uses region-aware scheduling\n- **Java 21** required\n- **Protection plugins** \u2014 AutoHarvest respects `BlockBreakEvent` cancellation. Any plugin that cancels the event (WorldGuard, GriefPrevention, Towny, Lands, Residence, etc.) will prevent auto-harvest in protected regions. No special configuration needed.\n- **Only fires in Survival mode** \u2014 Creative, Adventure, and Spectator are ignored\n\n---\n\n## Installation\n\n1. Download the jar from Modrinth\n2. Place in your server's `plugins\/` folder\n3. Restart the server\n4. Optionally edit `plugins\/AutoHarvest\/config.yml` and run `\/autoharvest reload`\n\n---\n\n## Building from Source\n\nRequires Java 21.\n\n```bash\ngit clone https:\/\/github.com\/yourusername\/AutoHarvest.git\ncd AutoHarvest\n.\/gradlew build\n```\n\nThe plugin jar will be in `build\/libs\/`.\n\n---\n\n## License\n\nMIT\n\n<\/p>\n","protected":false},"excerpt":{"rendered":"