AutoReplantCrop

AutoReplantCrop

🌐 English

Version: 1.0.0 | API: Paper 26.x (Java 25) | Author: Duong2012G
License: Apache-2.0 | Link: Modrinth

Harvest and replant with a single right-click. **Out of the box every player can use it — no permissions,
tools or extra setup get in the way.** Just right-click a fully grown crop: it is harvested and planted again
at once, and the seed needed for the replant is taken from the crop's own drops. Requiring a hoe, ignoring
sneaking, sending drops straight to the inventory and per-world / per-crop switches are optional settings
for server admins.

Features

Feature · Description
One-click harvest and replant · Right-click a fully grown crop with your main hand and it is harvested and reset to growth stage 0 in place. The crop block is never removed and placed again, so its state (for example the facing of cocoa pods) is kept.
Seed cost taken from the drops · One seed is held back from the crop's own drops and used for the replant. If a crop would normally drop 3 seeds, you receive 2 and the third one is planted. Nothing is created out of thin air.
Supported crops · Wheat, carrots, potatoes, beetroots, nether wart and cocoa. Each one can be switched off in crops. Replant items: wheat seeds, carrot, potato, beetroot seeds, nether wart, cocoa beans.
Fortune · Drops are calculated with the item in your main hand as the loot tool, so Fortune increases the drops exactly like when breaking the crop (one seed is still kept for the replant). Switch off with fortune-support.
Seed fallback · Some crops can drop no seed at all (for example beetroots). With take-seed-from-inventory one matching item is taken from your inventory instead. If there is none, harvest-without-seed decides: harvest without replanting, or leave the crop untouched.
Immature crops are never touched · Only fully grown crops react. Bone meal, block placement and every other vanilla interaction keep working on crops that are still growing.
Protection plugin support · Fires a normal BlockBreakEvent for the player before anything changes, so protection plugins that work through that event can cancel it. If it is cancelled, the crop is left exactly as it was.
Drop-plugin friendly · If another plugin calls setDropItems(false) on that event, the crop gives no vanilla drops. The replant then needs a seed from the inventory (see Seed fallback).
Per-player toggle · /arc toggle switches the feature off/on for yourself. The choice is saved on the player and survives restarts and relogs.
Game modes · Survival: normal behaviour. Creative: the crop is replanted for free and nothing drops, like vanilla creative breaking. Adventure and Spectator: ignored.
Effects · Arm swing plus the crop's own vanilla break sound and plant sound.
World restrictions · disabled-worlds, by world name (case-insensitive).
Lightweight · No dependencies, no scheduled tasks, no data files. The listener only does work when a player right-clicks a supported crop.

Optional settings for server admins

Setting · What it does
Require a hoe (require-hoe) · Only works while holding a hoe (any *_HOE) in the main hand. Off by default.
Ignore while sneaking (ignore-while-sneaking) · Sneak + right-click behaves like vanilla, which is handy for placing blocks next to crops. Off by default.
Drops to inventory (drops-to-inventory) · Drops go straight into the player's inventory; whatever does not fit is dropped on the ground. Off by default.
Per-crop switches (crops) · Enable or disable wheat, carrots, potatoes, beetroots, nether wart and cocoa individually.

Requirements

• A Paper server on Minecraft 26.1 or newer (compiled against the 26.1.2 API). Paper-based forks such as Purpur use the same API. plugin.yml declares api-version: 26.1.
• Java 25 (required by Minecraft 26.x itself)
• Paper API only: Spigot is not supported, and Folia is not declared supported.

Installation

1. Put AutoReplantCrop-1.0.0.jar into your server's plugins/ folder.
2. Start the server once; plugins/AutoReplantCrop/config.yml is created.
3. Edit it and apply changes with /arc reload (no restart needed).

How to use

Right-click a fully grown crop with your main hand. That is all — no sneaking and no special tool needed
by default.

Auto-replant only triggers when all of these hold:

• the player has autoreplantcrop.use (everyone does by default) and has not used /arc toggle to switch it off
• the world is not listed in disabled-worlds and the crop is enabled in crops
• the crop is fully grown and the player is in Survival or Creative mode
• the player is not sneaking (only when ignore-while-sneaking: true) and holds a hoe (only when require-hoe: true)
• the player's own break is not cancelled by a protection plugin
• a seed is available (drops or inventory), or harvest-without-seed is true

Example with wheat:

Wheat · Wheat seeds
A normal break would drop · 1 · 3
AutoReplantCrop gives you · 1 · 2 (1 seed is planted again)

In Creative mode crops are replanted too, but nothing drops.

Commands & permissions

Command · Permission · Description
/arc toggle · autoreplantcrop.use (default: everyone) · Turn auto-replant on/off for yourself. Saved — it survives restarts.
/arc reload · autoreplantcrop.admin (default: op) · Reload config.yml.

The /arc command itself requires autoreplantcrop.use, which everyone has by default. To take the feature away
from a group, set autoreplantcrop.use to false for that group in your permissions plugin.

Configuration

Everything lives in plugins/AutoReplantCrop/config.yml.

Key · Default · Range · Description
settings.require-hoe · false · Player must hold a hoe (any *_HOE) in the main hand.
settings.ignore-while-sneaking · false · Sneaking + right-click uses vanilla behaviour (no harvest).
settings.fortune-support · true · Use the main-hand item as the loot tool so Fortune increases the drops. If false, drops are always the un-enchanted amounts.
settings.drops-to-inventory · false · Put drops straight into the inventory (overflow is dropped on the ground).
settings.take-seed-from-inventory · true · When the crop dropped no seed, take one matching item from the player's inventory.
settings.harvest-without-seed · true · When no seed can be found anywhere: true = harvest like a normal break (no replant), false = leave the crop untouched.
settings.disabled-worlds · [] · Worlds (by name, case-insensitive) where the feature is disabled.
crops.wheat / .carrots / .potatoes / .beetroots / .nether_wart / .cocoa · true · Enable or disable each crop.
messages.* · see file · prefix, toggle-on, toggle-off, reloaded, no-permission, players-only, usage (legacy & colour codes). An empty string hides the message.

How the seed is chosen: the plugin first looks for the replant item in the crop's drops and holds one back. If the
drops contain none, it looks in the player's inventory (when take-seed-from-inventory is on). If that fails too,
harvest-without-seed decides what happens.

Examples:

Only allow right-click replanting with a hoe in hand, and keep sneaking free for placing blocks

settings:
require-hoe: true
ignore-while-sneaking: true

Collect everything straight into the inventory

settings:
drops-to-inventory: true

Never destroy a crop that cannot be replanted (e.g. a beetroot that dropped no seed)

settings:
harvest-without-seed: false

Missing keys fall back to the built-in defaults automatically, so an older config.yml keeps working after an update.

Compatibility notes

• Before changing anything, the plugin calls a regular BlockBreakEvent for the player and the crop. Region and claim plugins that protect against block breaking (WorldGuard, GriefPrevention, Lands, Towny...) therefore apply automatically.
• The plugin has no hard or soft dependencies.

Known limitations

• The drops are calculated with Block#getDrops and spawned by the plugin; they do not go through BlockDropItemEvent, so plugins that depend on that event (some auto-pickup / auto-smelt / drop-multiplier plugins) may not see them.
• The BlockBreakEvent is a simulated break: the crop block itself stays in place and is only reset to growth stage 0. Plugins that listen to the event (logging, statistics, skills) see it as a normal break of a fully grown crop. No BlockPlaceEvent is fired for the replant.
• The tool takes no durability damage.
• Only items that are plain (no custom name, lore or other item data) are used as the inventory seed fallback.
• Sweet berry bushes (already harvestable in vanilla), torchflowers, pitcher plants, melon / pumpkin stems and sugar cane are not supported.

Changelog

See [CHANGELOG.md](CHANGELOG.md).