Croplant

# CropPlant - Auto-Replanting Plugin for PaperMC A PaperMC plugin that automatically plants seeds with intelligent area detection and visual effects. ## Features - **Area-based planting** - Seeds search for available farmland within configurable radius - **Connected farmland detection** - Uses flood fill algorithm to find only connected farmlands - **3D farm support** - Works with terraced/staircase farms (±1 block height difference) - **Multi-seed stacks** - Drops of 64 seeds plant on multiple farmlands automatically - **Visual effects** - Particle effects and sounds when planting (configurable) - **Fully configurable** via `config.yml` - **Per-world configuration** support - **9 different seed types** supported - **Lightweight and efficient** - **Debug mode** for troubleshooting ## Supported Seeds - Wheat Seeds → Wheat - Beetroot Seeds → Beetroots - Carrot → Carrots - Potato → Potatoes - Nether Wart → Nether Wart (on Soul Sand/Soil) - Torchflower Seeds → Torchflower Crop - Pitcher Pod → Pitcher Crop - Melon Seeds → Melon Stem - Pumpkin Seeds → Pumpkin Stem ## Requirements - **Java 21** or higher - **PaperMC 1.21+** server - **Maven** for building ## Installation ### Pre-built JAR 1. Download the latest `croplant.jar` from the releases 2. Place it in your server's `plugins` folder 3. Restart your server 4. Configure the plugin in `plugins/CropPlant/config.yml` ## Configuration The plugin creates a `config.yml` file in `plugins/CropPlant/`: ```yaml # Enable/disable the plugin enabled: true # Check interval (in ticks, 20 ticks = 1 second) check-interval: 1 # Maximum time to track an item (in ticks) max-track-time: 100 # Plant radius - search for available farmland within this radius # Only searches connected farmlands (flood fill algorithm) # Supports terraced farms with ±1 block height difference # Radius of 2 = 5x5 area, radius 3 = 7x7 area plant-radius: 2 # Remove item after planting? remove-item-after-plant: true # Play particle effects when planting? (green particles) play-particles: true # Play sound effects when planting? (planting sound) play-sounds: true # List of worlds where the plugin works (empty = all worlds) enabled-worlds: [] # Enabled seeds enabled-seeds: - WHEAT_SEEDS - BEETROOT_SEEDS - CARROT - POTATO - MELON_SEEDS - PUMPKIN_SEEDS - TORCHFLOWER_SEEDS - PITCHER_POD - NETHER_WART # Debug mode debug: false ``` ### Configuration Options - **enabled**: Enable or disable the plugin - **check-interval**: How often to check if items have landed (in ticks). Lower = more responsive but more CPU intensive - **max-track-time**: Maximum time to track a falling item before giving up (prevents memory leaks) - **plant-radius**: Search radius for connected farmlands (default: 2 blocks = 5x5 area) - **remove-item-after-plant**: Whether to remove the seed item after planting - **play-particles**: Show green particle effects when planting (default: true) - **play-sounds**: Play planting sound effects (default: true) - **enabled-worlds**: List of world names where the plugin works. Empty list = all worlds - **enabled-seeds**: List of seed types that will auto-plant - **debug**: Enable debug logging to console ## How It Works 1. **Seed Detection**: When a seed item is dropped in the world, the plugin starts tracking it 2. **Landing Check**: Every tick (or based on `check-interval`), it checks if the item has landed on the ground 3. **Farmland Validation**: Once landed, checks if it's on farmland (or soul sand for nether wart). If not, ignores the seed 4. **Connected Area Search**: Uses flood fill algorithm to find all connected farmlands within the configured radius - Only searches farmlands physically connected to the landing spot - Supports terraced/staircase farms with ±1 block height difference - Respects the `plant-radius` configuration as maximum search distance 5. **Smart Planting**: - Sorts available spots by distance (nearest first) - Plants one seed per available farmland - If you drop 64 seeds on a 5x5 farm with 10 free spots, it plants 10 and leaves 54 on the ground 6. **Visual Feedback**: Plays particle effects (green) and sound (planting sound) for each planted crop 7. **Cleanup**: Removes planted seeds from the item stack