# MOBA HUD (hud.moba)

## What it is for

Shows the on-screen interface of a lane game: score and clock, the hero bar with abilities, level, health and mana, items, the shop, allied frames, the kill feed and announcements.

It needs `moba.match`, `game.engine`; installing it brings them in.

## Turn it on

Install the kit in a project, then change a setting (the values shown are its defaults):

```text
gripforge_gamekit_install   { project_id: "gkp_…", id: "hud.moba" }
gripforge_gamekit_configure { project_id: "gkp_…", id: "hud.moba",
                              config: { "show": ["score", "hero", "abilities", "items", "stats", "shop", "team", "feed", "announcements", "respawn", "minimap"], "feedSize": 5 } }
```

## First example

The kit has no dedicated test yet; this installs it and sets two of its settings to their defaults.

```text
gripforge_gamekit_install   { project_id: "gkp_…", id: "hud.moba" }
gripforge_gamekit_configure { project_id: "gkp_…", id: "hud.moba",
                              config: { "show": ["score", "hero", "abilities", "items", "stats", "shop", "team", "feed", "announcements", "respawn", "minimap"], "feedSize": 5 } }
```

## Settings and defaults

Descriptions come from the kit manifest and stay in English.

| Setting | Type | Default | Range or values | Meaning |
|---|---|---|---|---|
| `show` | array | `["score", "hero", "abilities", "items", "stat…` |  | Elements the HUD draws. |
| `feedSize` | integer | `5` | 1–10 | Lines kept in the kill feed. |
| `feedSeconds` | number | `8` | 1–60 | Seconds a kill feed line stays. |
| `announceSeconds` | number | `3.5` | 0.5–30 | Seconds an announcement banner stays (and its toast). |

## Services, events, variables

- Service `hud.moba`: notify, shown, setShown for the MOBA HUD elements (the hud.bind service shape).
- Events emitted:
  - `hud.notify` (`text`, `seconds`, `style`)
- Events listened to: `moba.wave`, `moba.structure.destroyed`, `moba.hero.killed`, `moba.levelup`, `moba.victory`
- Variables:
  - `hud.moba.feed` (string) — Kill feed (JSON lines)
  - `hud.moba.announce` (string) — Announcement
- Input actions: `moba.shop`

## Hooks and modding

- Moddable settings: `show`, `feedSize`, `feedSeconds`, `announceSeconds`

## Engines

Declared targets: `web`, `rust`. `gripforge kit api hud.moba` lists the exact settings and services of your version.

## Versions

Kit version 1.3.0.