# alexandr1830/airplane_game_cpp architecture

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

- Interactive diagram: https://gitdiagram.com/alexandr1830/airplane_game_cpp
- Repository: https://github.com/alexandr1830/airplane_game_cpp

## Overview

This is a small SFML airplane shooter. The main loop creates the map, player and enemy groups, then handles input, movement, rendering, firing, hit detection and destruction. The airplane library separates individual aircraft, composite groups, object creation and shooting strategies. The map implementation and factory implementation are listed as read in the source index, but their excerpts were not provided; links that depend on their internal calls are therefore omitted or marked unverified.

Main entry points: [`src/main.cpp`](https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/main.cpp) (Game Loop), [`src/airplane_lib/Airplane_class.cpp`](https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/airplane_lib/Airplane_class.cpp) (Airplane), [`src/airplane_lib/Component.cpp`](https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/airplane_lib/Component.cpp) (Aircraft Groups), [`src/airplane_lib/AirVehicle_class.h`](https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/airplane_lib/AirVehicle_class.h) (Vehicle Interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Game Runtime"]
  node_player(("Player"))
  node_game_loop["Game Loop<br/>[main.cpp]"]
  node_map["Map Display<br/>[game_map.cpp]"]
end

subgraph group_aircraft["Aircraft Model"]
  node_vehicle_api["Vehicle Interface<br/>[AirVehicle_class.h]"]
  node_airplane["Airplane<br/>[Airplane_class.cpp]"]
  node_movement["Movement Controls<br/>[Airplane_nsp.cpp]"]
  node_groups["Aircraft Groups<br/>[Component.cpp]"]
end

subgraph group_combat["Combat System"]
  node_shooting["Shooting<br/>[shooting.cpp]"]
  node_shot_strategies["Shot Strategies<br/>[shooting_header.h]"]
  node_hit_detection["Hit Detection<br/>[Component.cpp]"]
end

subgraph group_creation["Object Creation"]
  node_creator_api["Creator Interface<br/>[Creator.h]"]
  node_factory["Concrete Creator"]
end

node_sfml["SFML"]

node_player -->|"plays"| node_game_loop
node_game_loop -->|"displays"| node_map
node_game_loop -->|"updates"| node_groups
node_game_loop -->|"creates aircraft"| node_factory
node_game_loop -->|"renders with"| node_sfml
node_factory -.->|"creates"| node_airplane
node_groups -->|"delegates to"| node_vehicle_api
node_airplane -->|"implements"| node_vehicle_api
node_airplane -->|"uses"| node_movement
node_airplane -->|"fires through"| node_shooting
node_shooting -.->|"selects strategy"| node_shot_strategies
node_groups -->|"checks collisions"| node_hit_detection
node_hit_detection -->|"applies damage"| node_vehicle_api

click node_game_loop "https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/main.cpp"
click node_map "https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/game_map/game_map.cpp"
click node_vehicle_api "https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/airplane_lib/AirVehicle_class.h"
click node_airplane "https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/airplane_lib/Airplane_class.cpp"
click node_movement "https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/airplane_lib/Airplane_nsp.cpp"
click node_groups "https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/airplane_lib/Component.cpp"
click node_creator_api "https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/airplane_lib/Creator.h"
click node_factory "https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/airplane_lib/ConcreteCreator.cpp"
click node_shooting "https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/airplane_lib/shooting_lib/shooting.cpp"
click node_shot_strategies "https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/airplane_lib/shooting_lib/shooting_header.h"
click node_hit_detection "https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/airplane_lib/Component.cpp"

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_player,node_game_loop,node_map toneBlue
class node_vehicle_api,node_airplane,node_movement,node_groups toneAmber
class node_shooting,node_shot_strategies,node_hit_detection toneMint
class node_creator_api,node_factory toneRose
class node_sfml toneIndigo
```

## Components

### Game Runtime

- **Player**
- [Game Loop](https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/main.cpp): `src/main.cpp`
- [Map Display](https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/game_map/game_map.cpp): `src/game_map/game_map.cpp`

### Aircraft Model

- [Vehicle Interface](https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/airplane_lib/AirVehicle_class.h): `src/airplane_lib/AirVehicle_class.h`
- [Airplane](https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/airplane_lib/Airplane_class.cpp): `src/airplane_lib/Airplane_class.cpp`
- [Movement Controls](https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/airplane_lib/Airplane_nsp.cpp): `src/airplane_lib/Airplane_nsp.cpp`
- [Aircraft Groups](https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/airplane_lib/Component.cpp): `src/airplane_lib/Component.cpp`

### Combat System

- [Shooting](https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/airplane_lib/shooting_lib/shooting.cpp): `src/airplane_lib/shooting_lib/shooting.cpp`
- [Shot Strategies](https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/airplane_lib/shooting_lib/shooting_header.h): `src/airplane_lib/shooting_lib/shooting_header.h`
- [Hit Detection](https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/airplane_lib/Component.cpp): `src/airplane_lib/Component.cpp`

### Object Creation

- [Creator Interface](https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/airplane_lib/Creator.h): `src/airplane_lib/Creator.h`
- [Concrete Creator](https://github.com/alexandr1830/airplane_game_cpp/blob/main/src/airplane_lib/ConcreteCreator.cpp): `src/airplane_lib/ConcreteCreator.cpp`

### Other components

- **SFML**

## Connections

- Player → Game Loop: plays (evidence: `src/main.cpp`)
- Game Loop → Map Display: displays (evidence: `src/main.cpp`)
- Game Loop → Aircraft Groups: updates (evidence: `src/main.cpp`)
- Game Loop → Concrete Creator: creates aircraft (evidence: `src/main.cpp`)
- Game Loop → SFML: renders with (evidence: `src/main.cpp`)
- Concrete Creator → Airplane: creates
- Aircraft Groups → Vehicle Interface: delegates to (evidence: `src/airplane_lib/Component.cpp`)
- Airplane → Vehicle Interface: implements
- Airplane → Movement Controls: uses (evidence: `src/airplane_lib/Airplane_class.cpp`)
- Airplane → Shooting: fires through (evidence: `src/airplane_lib/Airplane_class.cpp`)
- Shooting → Shot Strategies: selects strategy (evidence: `src/airplane_lib/shooting_lib/shooting.cpp`)
- Aircraft Groups → Hit Detection: checks collisions (evidence: `src/airplane_lib/Component.cpp`)
- Hit Detection → Vehicle Interface: applies damage (evidence: `src/airplane_lib/Component.cpp`)
