BlossomSuite

BlossomSuite is a client-side utility mod built specifically for BlossomCraft, bringing gameplay tracking, automation tools, customizable HUDs, cosmetics, emotes, inventory utilities, and quality-of-life features together in one mod.

BlossomSuite is designed to give you more information and control over your gameplay while staying out of the way when you don't need it.

Report bugs, suggest features, and follow development on Discord.

---

Features

🎭 Emotes

• Built-in collection of 120+ emotes and animations
• Standard, movement, and flying animations
• Set custom animations for running forward, running backward, and flying
• Customizable Emote Wheel for quick access to your favorites
• Assign individual emotes to hotkeys
• Emotes are visible to other players using BlossomSuite
• Access with /bsuite emotes

👕 Cosmetics & Wardrobe Vault

• Collection-based cosmetic system for showing off equipment without actually wearing it
• Unlock cosmetic items by collecting them in-game
• Usable cosmetics are managed through your Wardrobe Vault
• Hide your normally equipped armor and Offhand
• Layer up to two cosmetics on individual armor slots
• Supports:
  • Armor
  • Wings
  • Tools
  • Weapons
• Assign cosmetics to specific weapons
• Configurable Wing source for Head and Offhand-based wings
• Cosmetics are visible to other players using BlossomSuite
• Requires opt-in Remote Suite Data
• Access with /bsuite cosmetics

Learn how the Wardrobe Vault works:
Wardrobe Vault Guide

⏱️ Item Cooldown Tracking

• Visual cooldown HUD that displays supported items from your hotbar
• Clear Ready / Cooldown states with countdown timers
• Two HUD modes:
  • Full - item icon, name, and cooldown state
  • Compact - item icon and cooldown state only
• Optional sound, chat, and on-screen notifications when cooldowns complete
• Configurable notification display and fade times
• Notification settings for volume and cooldown thresholds
• Vanilla-style Hotbar cooldown animations
• Supports tracking cooldowns from alt accounts

📊 Jobs, Money & Statistics

• Job XP tracking
• Money gain tracking
• Lifetime job money totals
  • Tracks total money earned per server
  • Optional cross-server totals
• Session and segment-based statistics
• Optional session rollover between play sessions
• Optional automatic segment resets
• Session and Segment HUD controls
• Lifetime totals can be manually adjusted when needed

🎒 Inventory Management (Work in Progress)

• Inventory sorting
• Container sorting
• Deposit and Withdraw controls
• Inventory manipulation hotkeys
• Slot locking
• Inventory actions can respect locked slots
• Shift-click support for performing opposite actions

🗑️ AutoDropper

• Built-in configurable automatic item dropping
• Create custom item groups
• Import and export groups
• Supports importing settings from the standalone AutoDropper mod
• DROP LISTED / KEEP LISTED modes for blacklist or whitelist-style behavior
• Dedicated AutoDropper Slot Lock
• Add individual item exceptions to group rules
• Configurable pause conditions for player interactions
• Continue-to-mine-after-drop support

🔄 AutoSwapper

• Automatically swap to configured tools or weapons when needed
• Custom groups
• Import and export group configurations
• Attackable group for automatically selecting a configured weapon when targeting something that can be attacked
• Dedicated toggle keybind
• Designed to work alongside Tool Lock

🔒 Tool Lock

• Protect important hotbar slots from accidental actions
• Tool Lock profiles
• Prevent unwanted swapping
• Independently lock Left Click interactions
• Notifications when attempting to use a locked slot
• Integrates with AutoSwapper without preventing automatic swaps

⛏️ Mining Tools

• Mining Tracks for maintaining consistent mining paths
• Lock your mining path to the appropriate X or Z coordinate
• Configurable world overlay
• Custom Mining Track colors
• Rainbow color support
• Dedicated set, clear, and visibility keybinds

🧱 Break Filter

• Block Group-based mining protection
• Configure groups of blocks you do or don't want to break
• Two operating modes:
  • Block Selected - selected blocks are protected
  • Only Selected - only selected blocks can be broken
• Useful for protecting valuable blocks while mining

🏠 Rental Tracking

• Keep track of rental timers directly through BlossomSuite
• Create and manage rentals through the Options menu or commands
• Pause and resume Rent Timers
• Clear expired rentals
• Dedicated rental keybinds

🏰 Dungeon Cooldowns

• Track dungeon cooldowns
• Dedicated Dungeon Cooldown HUD
• Cooldowns are tracked separately per server

✈️ Auto Fly

• Automatically enables flight after supported teleports
• Per-world state tracking
• Designed to avoid unnecessary command spam and false activations
• Additional handling for staff
• Disabled by default

🗳️ Vote Party Tracking

• Track Vote Party progress
• Dedicated Vote Party HUD
• Improved tracking when switching between servers
• Optional on-screen notifications when a Vote Party is approaching or active

💰 Trade & Petal Data

• /bsuite trade provides quick access to tracked trade information
• Tracks Petals separately across:
  • Inventory
  • Backpack
  • Ender Chest
• Shows where your Petals are stored
• Displays when the information was last updated

💬 Chat & Advertisement Tools

• Chat HUD showing Public, Private, and Party chat states
• Advertisement system with manual keybind support
• Advertisement cooldown tracking
• Notification when your Advertisement comes off cooldown
• Prevents sending while still on cooldown
• Toggle job-related chat messages
• Pinata Balance filtering

🎯 Visuals & HUDs

• Customizable Crosshair
• Customizable Block Outline
  • Custom colors
  • Rainbow mode
• Coordinates HUD
• Biome HUD
• Individual Jobs, Session, Segment, Cooldown, Dungeon, Vote Party, and other feature HUDs
• HUD elements can be repositioned through Edit Mode
• Individual HUD scaling
• Adjustable opacity
• Optional automatic scaling based on Minecraft's GUI Scale

⌨️ Advanced Keybinds

• Dedicated keybinds for many BlossomSuite systems
• Mouse button support
• Modifier key support
• Multi-key combinations such as:
  • M + A
  • CTRL + M
• Keybind conflict handling
• Manage BlossomSuite keybinds directly through Options

⚙️ Options & Configuration

• Full in-game Options interface
• ModMenu support
• SuiteCore-themed interface
• Organized settings for each major feature
• Enable or disable BlossomSuite with:
  • /bsuite on
  • /bsuite off
• Automatic configuration backups help protect against configuration corruption
• Most settings and UI layouts remain stored locally

☁️ Remote Suite Data (Optional)

BlossomSuite includes an opt-in Remote Suite Data system for supported information.

Currently supported data includes:

• Jobs Lifetime / Earnings
• Cosmetic Unlocks
• Favorite Emotes

Supported data remains stored locally while a remote copy helps protect it against local corruption or data loss.

Remote Suite Data can be enabled or disabled at any time under Options -> Remote Suite Data.

Read more about what is stored and how it is handled:
BlossomSuite Privacy Information

🎣 Fishing Enhancements

• Replace the bobber sound when a fish bites
• Adjustable volume and pitch

---

Credits

Special thanks to Dissuh, Pigki, Opossum, and everyone else who has helped test BlossomSuite, report bugs, provide feedback, and suggest new features.