🌾 FrozenCrops

📦 Plugin Info

A high-performance accelerated crop growth plugin for Paper. It speeds up growth for regular crops (age-based) and vertical plants (bamboo, cane, kelp, vines, cactus), with per-crop toggles, smart pickup/auto-collect, optional growth effects, and a permission-based bypass for vanilla-speed growth.

• Name: FrozenCrops
• Version: 1.0.0 (versioned via Maven ${project.version})
• Main class: me.dev.drfrozen.frozencrops.FrozenCrops
• Description (plugin.yml): High-performance accelerated crop growth for Paper 1.21

👤 Author Info

• Author: DrFrozenXD

✅ Versions / Compatibility / Software Support

• API Version: 1.21
• Built against: Paper API 1.21.4-R0.1-SNAPSHOT (Java 21 toolchain, Maven + Shade plugin) ☕
• Server software: Paper / Spigot forks
• Folia support: ✅ yes!
• Dependencies: None external — pure Paper API plugin

🔐 Permissions

Permission	Default	Purpose
frozencrops.admin	op	Access to /frozencrops commands (reload, toggle)
frozencrops.bypass	false	Players with this permission get normal (vanilla) growth speed instead of accelerated growth

⌨️ Commands

Command	Aliases	Permission	Usage
/frozencrops	/fc	frozencrops.admin	/frozencrops <reload|toggle>

• reload — reloads config.yml on the fly
• toggle — flips the master enabled switch, turning fast growth on/off server-wide without a reload
• Tab-completes reload/toggle as the first argument

🎯 Uses

• 🌱 Speed up regular crop growth (wheat, carrots, potatoes, beetroot, nether wart, melon/pumpkin stems, cocoa, berry bushes, saplings, mushrooms, and more) on a configurable timer, with adjustable randomness so growth doesn't feel robotic.
• 🎋 Accelerate vertical plants (bamboo, sugar cane, kelp, cactus, vines, twisting/weeping vines, cave vines) toward configurable max heights via periodic proximity scans near players.
• 🧺 Smart Pickup: block-break and harvest drops go straight into the breaking player's inventory; overflow merges into a single ground pile with a count hologram instead of scattering as separate item entities.
• 🎛️ Fine-grained control: enable/disable growth boosting per individual crop/plant type in config.yml.
• ✨ Optional particle effects on growth stages and a sound on full maturity.
• 🚫 Give trusted players/areas vanilla-speed growth via the bypass permission.
• 🐛 Debug mode for troubleshooting growth behavior.

⚙️ Key Config Options (config.yml)

• enabled — master on/off toggle for the whole plugin
• growth.crop-growth-seconds — time (seconds) for a crop to go from planted to fully mature; also the target time for vertical plants to reach max height
• growth.randomness — 0.0 (no randomness) to 1.0 (fully random within the interval)
• vertical.growth-interval-seconds — how often the plugin scans near players for vertical plants (affects server load, not growth speed)
• vertical.max-*-height — max height per vertical plant type (0 = vanilla limit)
• pickup.* — smart pickup toggle, merge radius, hologram color, pickup sound
• crops.* — per-crop/plant true/false toggle for accelerated growth
• effects.* — particle-on-growth and sound-on-mature settings
• debug — verbose logging toggle
• messages.* — all user-facing message strings, color-coded with & formatting