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.