Luna UI Documentation

Progress Bars

Progress Bar family — one shared animation core (ProgressBarData + ProgressBarController), several shapes on top. This hub covers the family; siblings: Linear · Radial · RPG Demo · Architecture.

Luna provides a powerful progress bar system with smooth animations, multi-segment support, and indicator overlays.

Available Components

Component	Description
Progress Bar	Traditional horizontal/vertical bar with fill segments, overlay images, and icon support.
Radial Progress Bar	Circular progress indicator with arc rendering. Supports multi-segment displays (Overwatch-style).

Key Features

Animated Transitions — Duration + easing based fills and drains (fill-duration-ms, fill-easing, …) with per-direction control and start delays
Indicator Bar — Shows previous value during changes (damage preview, heal preview)
Multi-Segment — Stack multiple progress fills with different colors
Juice via Transition Assets — Punch, shake, flash, low-HP pulse as reusable TransitionSequenceAsset slots — see Transition effects
USS Styling — Full customization via USS properties and color classes

Quick Start

xml

<ui:UXML xmlns:ui="UnityEngine.UIElements" xmlns:luna="CupkekGames.Luna">
    <luna:ProgressBar name="health-bar" style="width: 300px; height: 24px;" />
</ui:UXML>

PanelRenderer delivers its visual tree asynchronously — query the bar in the reload callback, not in Awake/Start:

csharp

using UnityEngine;
using UnityEngine.UIElements;
using CupkekGames.Luna;

public class HealthBarQuickStart : MonoBehaviour
{
    private PanelRenderer _panelRenderer;
    private CupkekGames.Luna.ProgressBar _healthBar;

    private void Awake()
    {
        _panelRenderer = GetComponent<PanelRenderer>();
        _panelRenderer.RegisterUIReloadCallback(OnUIReload);
    }

    private void OnDestroy()
    {
        _panelRenderer.UnregisterUIReloadCallback(OnUIReload);
    }

    private void OnUIReload(PanelRenderer renderer, VisualElement root, int version)
    {
        _healthBar = root.Q<CupkekGames.Luna.ProgressBar>("health-bar");

        // Initialize at full without playing the animation.
        // Both flags default to true — set and clear BOTH, or later
        // negative changes (damage) will still snap instantly.
        _healthBar.InstantPositive = true;
        _healthBar.InstantNegative = true;
        _healthBar.Progress[0].TargetValue = 1f;
        _healthBar.Indicator.TargetValue = 1f;
        _healthBar.PlayProgress();
        _healthBar.PlayIndicator();
        _healthBar.InstantPositive = false;
        _healthBar.InstantNegative = false;
    }

    public void TakeDamage()
    {
        // Animate to 50%. (_healthBar.PlayTo(0.5f) replaces only the two
        // Progress lines — the Indicator lines are still needed for the
        // damage-preview ghost.)
        _healthBar.Progress[0].TargetValue = 0.5f;
        _healthBar.Indicator.TargetValue = 0.5f;
        _healthBar.PlayProgress();
        _healthBar.PlayIndicator();
    }
}

⚠️ ProgressBar is an ambiguous name. Luna's ProgressBar shares its class name with UnityEngine.UIElements.ProgressBar, so when both namespaces are imported you must qualify the type (as above) or alias it: using ProgressBar = CupkekGames.Luna.ProgressBar;

Only call RebuildProgressSegments() when you change the length of the Progress array — plain value changes just need PlayProgress() / PlayIndicator().

Rolling number labels. For the HUD counter next to a bar (gold, gems, score), Label has a matching one-liner: goldLabel.PlayCountTo(from, to, durationMs) animates the text as a rolling number, auto-cancelling any count-up already running on that label. Optional formatter parameter; defaults to "N0" ("12,345"). CancelCountTo() stops one mid-flight.

Architecture

For advanced customization and creating custom progress bar types, see the Architecture documentation.

Progress Bar

Available Components

Key Features

Quick Start

Architecture

See also