# XWUIGameWeightCapacity

A carry-weight bar that fills from `current` toward `max` and labels it as `current / max` in the chosen `unit` (`kg` or `lbs`). The fill changes class at 50% (medium), 75% (heavy), and 100% (over), and when `showThresholds` is on it draws marker lines at 50% and 75%. Reaching capacity - or setting `overencumbered` - adds an over state and an "OVERENCUMBERED" warning to the label. Update the load with `setCurrent(value)` or `updateData(...)`, and read the fill ratio via `getPercentage()`.

## Basic Usage

Shows a carry-weight bar with threshold markers and an over state.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A carry-weight bar with current/max label, threshold markers, and overencumbered warning.
```

## Overencumbered

A pack loaded past capacity, entering the over state with the OVERENCUMBERED warning.

```example
file: examples/Overencumbered.ts
html: examples/Overencumbered.html
title: Overencumbered
description: A carry-weight bar pushed above max with the overencumbered flag and warning label.
```

## Pounds, Light Load

A near-empty pack measured in pounds with threshold markers hidden.

```example
file: examples/PoundsLightLoad.ts
html: examples/PoundsLightLoad.html
title: Pounds, Light Load
description: A lightly loaded carry-weight bar using the lbs unit and showThresholds disabled.
```

```api
```