FloralSMP Plugin

## 🌸 FloralSMP Plugin A powerful Bukkit/Spigot plugin by **Abusefully** that turns simple flowers (and mushrooms!) into unique magical abilities. Equip up to two “flowers” at a time to gain passive buffs or unleash spectacular active powers. --- ### 📦 Installation 1. **Download** the compiled JAR and place it in your server’s `plugins/` folder. 2. **Restart** or **reload** the server. 3. Upon startup, the plugin will automatically register its commands, event listeners, and begin its background tasks (action-bar updater, passive effect applier, cleanup routine). --- ### ⚙️ Core Concepts - **Flower Types** Defined in `initializeFlowers()`. Each has: - A unique **name** and **icon** (`Material`) - **Display name** & **lore** (shown on hover) - An **ability type**: - **PASSIVE** → always-on (`INFINITE_DURATION` potion effects or automatic enhancements) - **ACTIVE** → triggered on sneak‑click (`triggerActiveAbility()`), with individual cooldowns - **Cooldown** (ms), optional **potion effect**, **amplifier**, **value** (e.g., healing %), and—if “unique”—a required Minecraft **advancement** - **Player Data** (`PlayerFlowerData`) Tracks equipped flowers (`flower1`, `flower2`), per-flower cooldown timers, and flags for special abilities (e.g., hypnosis state, masking). Holds rate-limit timestamps and original state for flight/skin. - **Ownership** Unique flowers (tied to achievements) can only exist once. Ownership is stored in `flowerOwners` and released on death or drop. - **Cleanup Routine** Every 24 h asynchronously, purges offline players’ data after 7 days, and frees up orphaned unique‑flower ownerships. --- ### ✨ Flower Abilities - **Wind Flower** (ACTIVE) • Launch yourself upward • White spiral + cloud/firework particles • 25 s cooldown • **Unlock**: `minecraft:adventure/sleep_in_bed` - **Hypnosis Mushroom** (ACTIVE) • Make nearby players holding writable books “sign” & drop them, plus knockback • 60 s cooldown • **Unlock**: `minecraft:story/enchant_item` - **Shadow Flower** (ACTIVE) • Invisibility + flight for 15 s • Dark smoke/spell particles • 180 s cooldown • **Unlock**: `minecraft:nether/get_wither_skull` - **Teleport Flower** (ACTIVE) • Teleport to targeted block (raycast up to 100 blocks) • Purple portal/dragon‑breath effects • 45 s cooldown • **Unlock**: `minecraft:end/enter_end_gateway` - **Mage Flower** (ACTIVE) • Summon lightning at cursor (up to 50 blocks) • Enchanted‑hit & crit effects • 20 s cooldown • **Unlock**: `minecraft:adventure/lightning_rod_with_villager_no_fire` - **Masking Flower** (ACTIVE) • Disguise self (and nearby allies) as “Unknown” (Steve skin) for 180 s • 5 min cooldown • **Unlock**: `minecraft:nether/find_fortress` - **Rose of Strength** (PASSIVE) • Strength I buff (infinite) • **Unlock**: none - **Warrior Flower** (PASSIVE) • Strength II buff (infinite) • **Unlock**: `minecraft:adventure/kill_all_mobs` - **Speed Flower** (PASSIVE) • Speed III buff (infinite) • **Unlock**: `minecraft:story/deflect_arrow` - **Vampiric Flower** (PASSIVE) • Heals 30% of melee damage dealt, with heart/blood particles • **Unlock**: `minecraft:story/enter_the_nether` - **Effect Flower** (PASSIVE) • Doubles amplifier of **all** potion effects (capped at amp 10) and newly‑applied effects • **Unlock**: `minecraft:nether/all_potions` > _Passive effects are (re)applied on login and plugin reload via scheduled updaters._ --- ### 🎮 Commands & Permissions - `/floral help` (`floral.use`) Show in‑game usage guide. - `/floral list` (`floral.use`) List all flowers, their unlocks, and current ownership status. - `/floral bypass` (`floral.bypass`) Toggle cooldown bypass for active abilities (self only). - `/floral give <player> <flower>` (`floral.admin`) Grant any flower item to a player (unique flowers only if unowned). - `/floral reload` (`floral.admin`) Reload flower definitions & reapply passive effects to online players. - `/unequip <flower_name>` (`floral.use`) Unequip a flower slot and return the item to your inventory. ### 🙏 Credits - **Author**: Abusefully