# XWUIGameMechLoadout

Mech loadout builder. It draws a grid of named hardpoint slots (default `leftArm`, `rightArm`, `leftShoulder`, `rightShoulder`, `torso`, `legs`, configurable via `conf_comp.slots`), accepts drag-and-drop equipment into each slot, and tracks total weight against a cap. Data props are the `equipped` map (per-slot `name`, `icon`, `weight`, `stats`), `maxWeight`, and `currentWeight`; `showWeight` toggles the weight bar. `equip(slot, item)` and `unequip(slot)` mutate a slot and recompute weight; dropping an item fires `xwui-loadout-drop`.

## Basic Usage

Mounts the loadout builder with its hardpoint slot grid and weight bar.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Mounts the mech loadout builder with its named equipment slots, drag-drop targets, and weight tracking.
```

## Over Capacity

Loads heavier equipment than the tonnage cap allows so the weight bar trips its over-capacity warning styling.

```example
file: examples/OverCapacity.ts
html: examples/OverCapacity.html
title: Over Capacity
description: A build whose currentWeight of 118 exceeds maxWeight 100, rendering the weight bar with its over-limit styling.
```

## Live Equip

Fills an empty hardpoint after construction with equip(), which recomputes the total weight automatically.

```example
file: examples/LiveEquip.ts
html: examples/LiveEquip.html
title: Live Equip
description: Calls equip("rightArm", item) to drop a missile pack into an empty slot and advance the weight bar.
```

```api
```