# Myth II Battlefield Cluster Map — Project Option

**Status:** Option recorded for future design and implementation
**Recorded:** 2026-09-16

## Idea

Create a Myth II battlefield viewer that overlays unit activity on a map. The viewer could show colored clusters or heat areas, team positions, unit-type concentrations, movement trails, and changes over a replay timeline.

The supplied reference image shows a small overhead map with smooth color bands. Red/orange appears to indicate the strongest concentration, with yellow/green indicating lower density or surrounding activity. This color meaning is an observation, not a confirmed legend.

## Evidence checked

- Bagrada's public `metaserver-status` endpoint returns rooms, players, map names, and active-game metadata.
- The endpoint does **not** expose unit coordinates, movement paths, or cluster values, so it cannot produce the supplied visualization by itself.
- Myth II's normal overhead map uses green for the player's army, red for enemies, blue for friendly non-player units, and a yellow camera-view trapezoid. Team-color display can be enabled with F9.

## Possible implementation

1. Load the correct Myth II map color/overhead image.
2. Ingest unit positions from replay/film analysis or an approved live telemetry source.
3. Convert world coordinates to map pixels.
4. Aggregate positions into a density grid or heatmap.
5. Offer separate display modes for density, team colors, unit types, and movement trails.
6. Add a legend, timestamp/replay scrubber, filters, and a plain-language explanation of the colors.

## Boundaries and next evidence

- Do not claim that the current Bagrada status API provides tactical unit data.
- Obtain a sample film, replay-analysis output, or Gholsbane's tool/legend before assigning exact color semantics.
- Preserve the original map image and record the source and coordinate transform for every generated overlay.
- Treat any live-game integration as a separate, permissioned project from the public reference library.

## Sources

- Bagrada status endpoint: https://bagrada.net/rank-server/api/public/metaserver-status
- Bagrada overview and metaserver description: https://bagrada.net/webui/faq
- Myth II manual (overhead-map colors and F9 team-color display): https://manuals.plus/m/dd377820b34ed3740fb58ecc55d45303b035acef6e1699259a29a9721a0b5077