# tejascodes0110/highway-racer architecture

> Architecture diagram of the GitHub repository tejascodes0110/highway-racer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tejascodes0110/highway-racer
- Repository: https://github.com/tejascodes0110/highway-racer

## Overview

Highway Racer is a Pygame lane-dodging game. The player starts or restarts a run, steers between lanes, avoids timed enemy spawns, earns points as enemies leave the screen, and sees a game-over screen with the high score. The controller coordinates gameplay, drawing, and score handling; player and enemy modules implement the main actors. A power-up type exists in the source tree but is not wired into the sampled game loop. The score manager implementation was not sampled, so its storage relationship is uncertain.

Main entry points: [`main.py`](https://github.com/tejascodes0110/highway-racer/blob/main/main.py) (Game controller), [`settings.py`](https://github.com/tejascodes0110/highway-racer/blob/main/settings.py) (Game settings), [`player.py`](https://github.com/tejascodes0110/highway-racer/blob/main/player.py) (Player car), [`enemy.py`](https://github.com/tejascodes0110/highway-racer/blob/main/enemy.py) (Enemy cars)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_game["Game flow"]
  node_controller["Game controller<br/>[main.py]"]
end

subgraph group_actors["Road actors"]
  node_player["Player car<br/>[player.py]"]
  node_enemy["Enemy cars<br/>[enemy.py]"]
  node_powerup["Power-ups<br/>[powerup.py]"]
end

subgraph group_support["Configuration and scores"]
  node_settings["Game settings<br/>[settings.py]"]
  node_scoremanager["High-score manager<br/>[score_manager.py]"]
  node_highscore[("High-score file<br/>[highscore.txt]")]
end

node_playerinput(("Player"))

node_playerinput -->|"sends controls"| node_controller
node_controller -->|"creates and updates"| node_player
node_controller -->|"spawns and updates"| node_enemy
node_controller -->|"loads and saves"| node_scoremanager
node_controller -->|"reads configuration"| node_settings
node_player -->|"reads lane and display values"| node_settings
node_enemy -->|"reads lane and display values"| node_settings
node_powerup -->|"reads lane and display values"| node_settings
node_scoremanager -.->|"persists scores"| node_highscore

click node_player "https://github.com/tejascodes0110/highway-racer/blob/main/player.py"
click node_enemy "https://github.com/tejascodes0110/highway-racer/blob/main/enemy.py"
click node_powerup "https://github.com/tejascodes0110/highway-racer/blob/main/powerup.py"
click node_controller "https://github.com/tejascodes0110/highway-racer/blob/main/main.py"
click node_settings "https://github.com/tejascodes0110/highway-racer/blob/main/settings.py"
click node_scoremanager "https://github.com/tejascodes0110/highway-racer/blob/main/score_manager.py"
click node_highscore "https://github.com/tejascodes0110/highway-racer/blob/main/highscore.txt"

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_controller toneBlue
class node_player,node_enemy,node_powerup toneAmber
class node_settings,node_scoremanager,node_highscore toneMint
class node_playerinput toneIndigo
```

## Components

### Game flow

- [Game controller](https://github.com/tejascodes0110/highway-racer/blob/main/main.py): `main.py`

### Road actors

- [Player car](https://github.com/tejascodes0110/highway-racer/blob/main/player.py): `player.py`
- [Enemy cars](https://github.com/tejascodes0110/highway-racer/blob/main/enemy.py): `enemy.py`
- [Power-ups](https://github.com/tejascodes0110/highway-racer/blob/main/powerup.py): `powerup.py`

### Configuration and scores

- [Game settings](https://github.com/tejascodes0110/highway-racer/blob/main/settings.py): `settings.py`
- [High-score manager](https://github.com/tejascodes0110/highway-racer/blob/main/score_manager.py): `score_manager.py`
- [High-score file](https://github.com/tejascodes0110/highway-racer/blob/main/highscore.txt): `highscore.txt`

### Other components

- **Player**

## Connections

- Player → Game controller: sends controls (evidence: `main.py`)
- Game controller → Player car: creates and updates (evidence: `main.py`)
- Game controller → Enemy cars: spawns and updates (evidence: `main.py`)
- Game controller → High-score manager: loads and saves (evidence: `main.py`)
- Game controller → Game settings: reads configuration (evidence: `main.py`)
- Player car → Game settings: reads lane and display values (evidence: `player.py`)
- Enemy cars → Game settings: reads lane and display values (evidence: `enemy.py`)
- Power-ups → Game settings: reads lane and display values (evidence: `powerup.py`)
- High-score manager → High-score file: persists scores
