# zerodaylight0/pubg-tracker architecture

> Architecture diagram of the GitHub repository zerodaylight0/pubg-tracker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zerodaylight0/pubg-tracker
- Repository: https://github.com/zerodaylight0/pubg-tracker

## Overview

PUBG Tracker is a local match-analysis application: a player searches by nickname and platform, the Python server retrieves recent matches and squad statistics, and the browser presents match history and selected-player movement and events on a tactical map. The server also proxies telemetry and caches map images locally while keeping the API key server-side. The HTML files were not sampled, so UI-to-endpoint wiring is shown only where documented; unsampled implementation details are not inferred.

Main entry points: [`app.py`](https://github.com/zerodaylight0/pubg-tracker/blob/main/app.py) (HTTP proxy), [`index.html`](https://github.com/zerodaylight0/pubg-tracker/blob/main/index.html) (Tactical map), [`start.html`](https://github.com/zerodaylight0/pubg-tracker/blob/main/start.html) (Search screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Browser interface"]
  node_start["Search screen<br/>[start.html]"]
  node_mapui["Tactical map<br/>[index.html]"]
  node_history["Match history<br/>[index.html]"]
  node_squad["Squad statistics<br/>[index.html]"]
  node_events["Combat and telemetry<br/>[index.html]"]
end

subgraph group_server["Local Python server"]
  node_server["HTTP proxy<br/>[app.py]"]
  node_analysis["Match analysis<br/>[app.py]"]
end

subgraph group_data["Match data and assets"]
  node_matchstore[("Match storage<br/>[app.py]")]
  node_cache[("Local map cache<br/>[app.py]")]
end

node_player(("Player"))
node_pubg["PUBG API"]
node_telemetry["PUBG telemetry"]
node_mapassets["PUBG map assets"]

node_player -->|"searches"| node_start
node_start -.->|"requests analysis"| node_server
node_server -->|"routes request"| node_analysis
node_analysis -->|"fetches matches"| node_pubg
node_analysis -->|"stores results"| node_matchstore
node_server -->|"serves match data"| node_matchstore
node_server -->|"fetches telemetry"| node_telemetry
node_server -->|"reads and writes"| node_cache
node_server -->|"downloads assets"| node_mapassets
node_server -->|"serves page"| node_start
node_server -->|"serves page"| node_mapui
node_player -->|"selects match"| node_history
node_history -->|"selects member"| node_squad
node_squad -->|"shows route"| node_mapui
node_mapui -->|"renders events"| node_events
node_player -->|"inspects map"| node_mapui

click node_start "https://github.com/zerodaylight0/pubg-tracker/blob/main/start.html"
click node_mapui "https://github.com/zerodaylight0/pubg-tracker/blob/main/index.html"
click node_history "https://github.com/zerodaylight0/pubg-tracker/blob/main/index.html"
click node_squad "https://github.com/zerodaylight0/pubg-tracker/blob/main/index.html"
click node_events "https://github.com/zerodaylight0/pubg-tracker/blob/main/index.html"
click node_server "https://github.com/zerodaylight0/pubg-tracker/blob/main/app.py"
click node_analysis "https://github.com/zerodaylight0/pubg-tracker/blob/main/app.py"
click node_matchstore "https://github.com/zerodaylight0/pubg-tracker/blob/main/app.py"
click node_cache "https://github.com/zerodaylight0/pubg-tracker/blob/main/app.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_start,node_mapui,node_history,node_squad,node_events toneBlue
class node_server,node_analysis toneAmber
class node_matchstore,node_cache,node_pubg toneMint
class node_player,node_telemetry,node_mapassets toneIndigo
```

## Components

### Browser interface

- [Search screen](https://github.com/zerodaylight0/pubg-tracker/blob/main/start.html): `start.html`
- [Tactical map](https://github.com/zerodaylight0/pubg-tracker/blob/main/index.html): `index.html`
- [Match history](https://github.com/zerodaylight0/pubg-tracker/blob/main/index.html): `index.html`
- [Squad statistics](https://github.com/zerodaylight0/pubg-tracker/blob/main/index.html): `index.html`
- [Combat and telemetry](https://github.com/zerodaylight0/pubg-tracker/blob/main/index.html): `index.html`

### Local Python server

- [HTTP proxy](https://github.com/zerodaylight0/pubg-tracker/blob/main/app.py): `app.py`
- [Match analysis](https://github.com/zerodaylight0/pubg-tracker/blob/main/app.py): `app.py`

### Match data and assets

- [Match storage](https://github.com/zerodaylight0/pubg-tracker/blob/main/app.py): `app.py`
- [Local map cache](https://github.com/zerodaylight0/pubg-tracker/blob/main/app.py): `app.py`

### Other components

- **Player**
- **PUBG API**
- **PUBG telemetry**
- **PUBG map assets**

## Connections

- Player → Search screen: searches (evidence: `README.md`)
- Search screen → HTTP proxy: requests analysis (evidence: `README.md`)
- HTTP proxy → Match analysis: routes request (evidence: `app.py`)
- Match analysis → PUBG API: fetches matches (evidence: `app.py`)
- Match analysis → Match storage: stores results (evidence: `app.py`)
- HTTP proxy → Match storage: serves match data (evidence: `app.py`)
- HTTP proxy → PUBG telemetry: fetches telemetry (evidence: `app.py`)
- HTTP proxy → Local map cache: reads and writes (evidence: `app.py`)
- HTTP proxy → PUBG map assets: downloads assets (evidence: `README.md`)
- HTTP proxy → Search screen: serves page (evidence: `app.py`)
- HTTP proxy → Tactical map: serves page (evidence: `app.py`)
- Player → Match history: selects match (evidence: `README.md`)
- Match history → Squad statistics: selects member (evidence: `README.md`)
- Squad statistics → Tactical map: shows route (evidence: `README.md`)
- Tactical map → Combat and telemetry: renders events (evidence: `README.md`)
- Player → Tactical map: inspects map (evidence: `README.md`)
