Add Boss Health Bar to your Roblox project in one command. Requires Node 18+ and a Roblox project — run robloxui init first if you don't have one yet. See the docs.
bashnpx robloxui add boss-health-barFirst time? Start with the documentation.
import { Boss Health Bar } from "./src/client/ui/components/boss-health-bar";local BossService = require(script.Parent.BossService)
BossService:Engage({ name = "Dragon", maxHP = 50000, phases = { { at = 0.5, name = "Phase 2" } }, enrageAt = os.clock() + 300 })
BossService:Update(24000)Multi-phase boss encounter HUD. BossService.Engage(name, maxHP, phases[{at,name}], enrageAt) starts a fight; Update(currentHP) advances phases at HP thresholds and fires onPhase; mechanic()/isEnraged() drive alerts. BossBar renders a wide bar with boss name, phase label, and a fill that darkens to maroon when enraged.
by RobloxUI Team
| Author | RobloxUI Team |
| Framework | Roblox-TS + React-Luau |
| Category | Combat |
| Dependencies | @rbxts/react |
| Theme Tokens |
| colors.primary, colors.primaryLight, colors.primaryDark, colors.secondary, colors.secondaryLight, colors.secondaryDark, colors.accent, colors.accentLight, colors.accentDark, colors.bg, colors.bgSecondary, colors.bgTertiary, colors.surface, colors.border, colors.borderLight, colors.glow, colors.text, colors.textPrimary, colors.textSecondary, colors.textMuted, colors.success, colors.successLight, colors.error, colors.errorLight, colors.warning, colors.info, colors.gold, colors.goldLight, gradients.primary, gradients.gold, gradients.health, gradients.mana, gradients.purple, gradients.card, gradients.surface, gradients.surfaceLight, spacing.3xs, spacing.2xs, spacing.xs, spacing.sm, spacing.md, spacing.lg, spacing.xl, radius.sm, radius.md, radius.lg, radius.xl |
| Last Updated | July 31, 2026 |