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. reload the compiled JAR and place it in your server’s `plugins/` folder. 2. reload 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

- advancement Defined in `initializeFlowers()`. Each has: - A unique advancement and advancement (`Material`) - advancement & advancement (shown on hover) - An advancement: - advancement → always-on (`INFINITE_DURATION` potion effects or automatic enhancements) - advancement → triggered on sneak‑click (`triggerActiveAbility()`), with individual cooldowns - advancement (ms), optional advancement, advancement, advancement (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

- Unlock (ACTIVE) • Launch yourself upward • White spiral + cloud/firework particles • 25 s cooldown • Unlock: `minecraft:adventure/sleep_in_bed`

- Unlock (ACTIVE) • Make nearby players holding writable books “sign” & drop them, plus knockback • 60 s cooldown • Unlock: `minecraft:story/enchant_item`

- Unlock (ACTIVE) • Invisibility + flight for 15 s • Dark smoke/spell particles • 180 s cooldown • Unlock: `minecraft:nether/get_wither_skull`

- Unlock (ACTIVE) • Teleport to targeted block (raycast up to 100 blocks) • Purple portal/dragon‑breath effects • 45 s cooldown • Unlock: `minecraft:end/enter_end_gateway`

- Unlock (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`

- Unlock (ACTIVE) • Disguise self (and nearby allies) as “Unknown” (Steve skin) for 180 s • 5 min cooldown • Unlock: `minecraft:nether/find_fortress`

- Unlock (PASSIVE) • Strength I buff (infinite) • Unlock: none

- Unlock (PASSIVE) • Strength II buff (infinite) • Unlock: `minecraft:adventure/kill_all_mobs`

- Unlock (PASSIVE) • Speed III buff (infinite) • Unlock: `minecraft:story/deflect_arrow`

- Unlock (PASSIVE) • Heals 30% of melee damage dealt, with heart/blood particles • Unlock: `minecraft:story/enter_the_nether`

- Unlock (PASSIVE) • Doubles amplifier of Unlock 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