## \ud83c\udf38 FloralSMP Plugin<\/p>\n
A powerful Bukkit\/Spigot plugin by **Abusefully** that turns simple flowers (and mushrooms!) into unique magical abilities. Equip up to two \u201cflowers\u201d at a time to gain passive buffs or unleash spectacular active powers.<\/p>\n
—<\/p>\n
### \ud83d\udce6 Installation<\/p>\n
1. **Download** the compiled JAR and place it in your server\u2019s `plugins\/` folder.
\n2. **Restart** or **reload** the server.
\n3. Upon startup, the plugin will automatically register its commands, event listeners, and begin its background tasks (action-bar updater, passive effect applier, cleanup routine).<\/p>\n
—<\/p>\n
### \u2699\ufe0f Core Concepts<\/p>\n
– **Flower Types**
\n Defined in `initializeFlowers()`. Each has:
\n – A unique **name** and **icon** (`Material`)
\n – **Display name** & **lore** (shown on hover)
\n – An **ability type**:
\n – **PASSIVE** \u2192 always-on (`INFINITE_DURATION` potion effects or automatic enhancements)
\n – **ACTIVE** \u2192 triggered on sneak\u2011click (`triggerActiveAbility()`), with individual cooldowns
\n – **Cooldown** (ms), optional **potion effect**, **amplifier**, **value** (e.g., healing\u00a0%), and\u2014if \u201cunique\u201d\u2014a required Minecraft **advancement**<\/p>\n
– **Player Data** (`PlayerFlowerData`)
\n 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.<\/p>\n
– **Ownership**
\n Unique flowers (tied to achievements) can only exist once. Ownership is stored in `flowerOwners` and released on death or drop.<\/p>\n
– **Cleanup Routine**
\n Every 24\u202fh asynchronously, purges offline players\u2019 data after 7 days, and frees up orphaned unique\u2011flower ownerships.<\/p>\n
—<\/p>\n
### \u2728 Flower Abilities<\/p>\n
– **Wind Flower** (ACTIVE)
\n \u2022 Launch yourself upward
\n \u2022 White spiral + cloud\/firework particles
\n \u2022 25\u202fs cooldown
\n \u2022 **Unlock**: `minecraft:adventure\/sleep_in_bed`<\/p>\n
– **Hypnosis Mushroom** (ACTIVE)
\n \u2022 Make nearby players holding writable books \u201csign\u201d & drop them, plus knockback
\n \u2022 60\u202fs cooldown
\n \u2022 **Unlock**: `minecraft:story\/enchant_item`<\/p>\n
– **Shadow Flower** (ACTIVE)
\n \u2022 Invisibility + flight for 15\u202fs
\n \u2022 Dark smoke\/spell particles
\n \u2022 180\u202fs cooldown
\n \u2022 **Unlock**: `minecraft:nether\/get_wither_skull`<\/p>\n
– **Teleport Flower** (ACTIVE)
\n \u2022 Teleport to targeted block (raycast up to\u00a0100\u202fblocks)
\n \u2022 Purple portal\/dragon\u2011breath effects
\n \u2022 45\u202fs cooldown
\n \u2022 **Unlock**: `minecraft:end\/enter_end_gateway`<\/p>\n
– **Mage Flower** (ACTIVE)
\n \u2022 Summon lightning at cursor (up to\u00a050\u202fblocks)
\n \u2022 Enchanted\u2011hit & crit effects
\n \u2022 20\u202fs cooldown
\n \u2022 **Unlock**: `minecraft:adventure\/lightning_rod_with_villager_no_fire`<\/p>\n
– **Masking Flower** (ACTIVE)
\n \u2022 Disguise self (and nearby allies) as \u201cUnknown\u201d (Steve skin) for\u00a0180\u202fs
\n \u2022 5\u202fmin cooldown
\n \u2022 **Unlock**: `minecraft:nether\/find_fortress`<\/p>\n
– **Rose of Strength** (PASSIVE)
\n \u2022 Strength\u202fI buff (infinite)
\n \u2022 **Unlock**: none<\/p>\n
– **Warrior Flower** (PASSIVE)
\n \u2022 Strength\u202fII buff (infinite)
\n \u2022 **Unlock**: `minecraft:adventure\/kill_all_mobs`<\/p>\n
– **Speed Flower** (PASSIVE)
\n \u2022 Speed\u202fIII buff (infinite)
\n \u2022 **Unlock**: `minecraft:story\/deflect_arrow`<\/p>\n
– **Vampiric Flower** (PASSIVE)
\n \u2022 Heals\u00a030% of melee damage dealt, with heart\/blood particles
\n \u2022 **Unlock**: `minecraft:story\/enter_the_nether`<\/p>\n
– **Effect Flower** (PASSIVE)
\n \u2022 Doubles amplifier of **all** potion effects (capped at amp\u202f10) and newly\u2011applied effects
\n \u2022 **Unlock**: `minecraft:nether\/all_potions`<\/p>\n
> _Passive effects are (re)applied on login and plugin reload via scheduled updaters._<\/p>\n
—<\/p>\n
### \ud83c\udfae Commands & Permissions<\/p>\n
– `\/floral help` (`floral.use`)
\n Show in\u2011game usage guide.<\/p>\n
– `\/floral list` (`floral.use`)
\n List all flowers, their unlocks, and current ownership status.<\/p>\n
– `\/floral bypass` (`floral.bypass`)
\n Toggle cooldown bypass for active abilities (self only).<\/p>\n
– `\/floral give – `\/floral reload` (`floral.admin`) – `\/unequip ### \ud83d\ude4f Credits<\/p>\n – **Author**: Abusefully <\/p>\n","protected":false},"excerpt":{"rendered":" The plugin made by Abusefully for the FloralSMP!<\/p>\n","protected":false},"featured_media":71210,"template":"","meta":{"_minecraft_slug":"floralsmp-plugin","_minecraft_project_id":"8b5iHJh9","_minecraft_author":"postica","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":46,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"floralsmp-plugin.zip","_minecraft_size_bytes":32570,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:22:36.036422Z","_minecraft_date_created":"2025-07-10T06:14:01.726193Z","_minecraft_date_modified":"2025-06-20T02:46:09.398902Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/floralsmp-plugin","_minecraft_icon_attachment_id":71210,"_minecraft_imported_at":"2026-06-04T01:10:37+00:00","_minecraft_import_hash":"9c0795189300f1f50456fb17b2513718","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,122,127,92],"mod_loader":[130,132],"minecraft_version":[59,36,60,93,94,101,102,62,37,73,74,38],"class_list":["post-71209","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-magic","mod_category-paper","mod_category-utility","mod_loader-bukkit","mod_loader-paper","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4"],"yoast_head":"\n
\n Grant any flower item to a player (unique flowers only if unowned).<\/p>\n
\n Reload flower definitions & reapply passive effects to online players.<\/p>\n
\n Unequip a flower slot and return the item to your inventory.<\/p>\n