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