# XWUIGameMechHUD

Mech-specific HUD overlay built around a piloted-mech silhouette. It shows `core` HP (`hp`/`maxHp`), per-limb health for `limbs` (`leftArm`, `rightArm`, `leftLeg`, `rightLeg`), a `heat`/`maxHeat` gauge, and ammo bars for each entry in `weapons` (`name`, `ammo`, `maxAmmo`). Toggle the limb silhouette with `conf_comp.showLimbs` and the weapon readouts with `showWeapons`; pick a layout variant via `layout`. Push live combat values with `updateData({ core, limbs, heat, weapons })`.

## Basic Usage

Mounts the mech HUD with its core HP, limb status, heat gauge, and weapon ammo bars.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Mounts the mech HUD showing core HP, per-limb silhouette, heat gauge, and weapon ammo bars.
```

## Critical Damage

Drops core HP, destroys a limb, and pushes heat near overload so the gauges flip to their red danger colors.

```example
file: examples/CriticalDamage.ts
html: examples/CriticalDamage.html
title: Critical Damage
description: A failing mech with low core HP, a 0% right arm, and heat at 94/100 driving the red danger styling.
```

## Compact Core-Only

Hides the limb silhouette and weapon bars with showLimbs and showWeapons off, leaving just core HP and heat.

```example
file: examples/CompactCoreOnly.ts
html: examples/CompactCoreOnly.html
title: Compact Core-Only
description: A slim overlay with showLimbs and showWeapons set to false, showing only the core HP and heat gauges.
```

```api
```