Buff & Status Effect Manager

v1.0.0

UI System

Complete guide to BSM's UI components for displaying status effects.

Overview

BSM includes a complete UI system for displaying active effects, tooltips, and immunity feedback. All components are designed to work out-of-the-box with included prefabs, while being fully customizable.

Icon-Based Display

StatusEffectBar + IconElement — Classic MMO-style buff/debuff bar with icons, timers, and stack counts.

Text-Based Display

StatusPanelUI — Simple text list showing effect names and durations. Great for debugging or minimal UI styles.

Quick Setup: Run Tools → BSM → Generate UI Prefabsto create ready-to-use prefabs, then drag them into your Canvas.

StatusEffectBar

The main UI component for displaying active effects as a horizontal or vertical bar of icons. Automatically spawns/pools IconElements as effects are applied and removed.

Inspector Properties

Source ModePlayer (auto-find), Explicit (assign), or Self
Explicit TargetTarget GameObject (for Explicit mode)
Icon PrefabPrefab with StatusEffectIconElement
Filter ModeAll, ByCategory, ByCategoryType, or ByTag
Max DisplayMaximum icons to show (0 = unlimited)
Sort ModeNewestFirst, OldestFirst, ByDuration, ByCategory

Filter Modes

All

Shows all active effects

ByCategory

Only effects from a specific category

ByCategoryType

Only Buffs, Debuffs, or CrowdControl

ByTag

Only effects with a specific tag

Multiple Bars: Create separate bars for buffs and debuffs by using two StatusEffectBar components with different ByCategoryType filters.

StatusEffectIconElement

Individual icon representing a single active effect. Managed by StatusEffectBar (you typically don't add these manually).

Visual Elements

Icon ImageDisplays the effect's icon sprite
Duration FillRadial/linear fill showing remaining time
Stack TextShows current stack count (hidden if 1)
Border/FrameOptional border tinted by category color

Customization

Edit the prefab to customize appearance. The component uses standard Unity UI elements (Image, Text/TMP) that you can style freely.

StatusEffectTooltip

Shows detailed information when hovering over an effect icon. Displays name, description, remaining duration, and stack count.

Inspector Properties

Name TextTMP/Text component for effect name
Description TextTMP/Text for description
Duration TextShows remaining time
Stacks TextShows "x3" for stacked effects
Follow CursorTooltip follows mouse position
OffsetPixel offset from cursor
Singleton Pattern: Only one tooltip instance is needed per canvas. It automatically shows/hides when hovering different icons.

StatusPanelUI

A simple text-based panel showing all active effects as a list. Great for debugging or games with minimal UI requirements.

Active Effects
● Poison [4.2s] x2
● Shield [12.5s]
● Speed Boost [permanent]

Properties

Text ComponentTMP/Text to write effect list
Update IntervalHow often to refresh (seconds)
Show DurationDisplay remaining time
Show StacksDisplay stack count

Immunity Feedback

Visual feedback when effect applications are blocked by immunity. Includes floating text and an immunity panel showing active immunities.

ImmunityFeedback

Spawns floating "IMMUNE!" text when an effect is blocked.

  • • Configurable text, color, font size
  • • Animation (fade, float up)
  • • Spawn at target or UI position

ImmunityPanelUI

Text panel showing all active immunities.

  • • Permanent immunities (from profile)
  • • Temporary immunities with countdown
  • • Color-coded by type

Prefab Generator

BSM includes an editor tool that generates ready-to-use UI prefabs.

Menu: Tools → BSM → Generate UI Prefabs

AllGenerates all prefabs
Effect Bar OnlyBSM_EffectBar.prefab + BSM_IconElement.prefab
Tooltip OnlyBSM_Tooltip.prefab
Status Panel OnlyBSM_StatusPanel.prefab
Immunity Panel OnlyBSM_ImmunityPanel.prefab

Generated prefabs are saved to Assets/Plugins/GameCreator/BuffStatusEffectManager/Prefabs/UI/