# adityamalu/spacewarrior architecture

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

- Interactive diagram: https://gitdiagram.com/adityamalu/spacewarrior
- Repository: https://github.com/adityamalu/spacewarrior

## Overview

SpaceWarrior is a LÖVE game where two local players battle in a physics-driven arena using lasers, bombs, and scatter shots. The documented user workflow starts the game, then players control their ships in combat; the repository separates game states from gameplay modules. The README names the entry point and broad structure but no source excerpts were provided, so internal links are dashed where their exact call relationships are unverified.

Main entry points: [`states/PlayState.lua`](https://github.com/adityamalu/spacewarrior/blob/main/states/PlayState.lua) (Play State), [`states`](https://github.com/adityamalu/spacewarrior/tree/main/states) (Game States), [`main.lua`](https://github.com/adityamalu/spacewarrior/blob/main/main.lua) (Game Entry), [`StateMachine.lua`](https://github.com/adityamalu/spacewarrior/blob/main/StateMachine.lua) (State Machine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Game Runtime"]
  node_main["Game Entry<br/>[main.lua]"]
  node_state_machine["State Machine<br/>[StateMachine.lua]"]
end

subgraph group_states["Game States"]
  node_game_states["Game States"]
  node_play_state["Play State<br/>[PlayState.lua]"]
  node_client_state["Network Client<br/>[NetClientState.lua]"]
end

subgraph group_combat["Combat Systems"]
  node_player["Player Ships<br/>[Player.lua]"]
  node_bullets["Weapons<br/>[bullets.lua]"]
  node_physics["Physics<br/>[physics.lua]"]
  node_powerups["Powerups<br/>[powerups.lua]"]
  node_power_supplier["Power Supply<br/>[powersuplier.lua]"]
end

subgraph group_support["Game Support"]
  node_maps["Arena Maps<br/>[maps.lua]"]
  node_audio["Audio<br/>[audio.lua]"]
  node_settings["Settings<br/>[settings.lua]"]
  node_network["Network<br/>[net.lua]"]
end

node_players(("Local Players"))

node_players -.->|"start game"| node_main
node_main -.->|"uses states"| node_state_machine
node_state_machine -.->|"manages"| node_game_states
node_game_states -.->|"includes"| node_play_state
node_play_state -.->|"runs combat"| node_player
node_play_state -.->|"uses weapons"| node_bullets
node_play_state -.->|"uses physics"| node_physics
node_play_state -.->|"uses powerups"| node_powerups
node_play_state -.->|"uses supplies"| node_power_supplier
node_play_state -.->|"uses arenas"| node_maps
node_play_state -.->|"plays audio"| node_audio
node_game_states -.->|"includes settings"| node_settings
node_game_states -.->|"includes client"| node_client_state
node_client_state -.->|"uses network"| node_network

click node_main "https://github.com/adityamalu/spacewarrior/blob/main/main.lua"
click node_state_machine "https://github.com/adityamalu/spacewarrior/blob/main/StateMachine.lua"
click node_game_states "https://github.com/adityamalu/spacewarrior/tree/main/states"
click node_play_state "https://github.com/adityamalu/spacewarrior/blob/main/states/PlayState.lua"
click node_player "https://github.com/adityamalu/spacewarrior/blob/main/modules/Player.lua"
click node_bullets "https://github.com/adityamalu/spacewarrior/blob/main/modules/bullets.lua"
click node_physics "https://github.com/adityamalu/spacewarrior/blob/main/modules/physics.lua"
click node_powerups "https://github.com/adityamalu/spacewarrior/blob/main/modules/powerups.lua"
click node_power_supplier "https://github.com/adityamalu/spacewarrior/blob/main/modules/powersuplier.lua"
click node_maps "https://github.com/adityamalu/spacewarrior/blob/main/modules/maps.lua"
click node_audio "https://github.com/adityamalu/spacewarrior/blob/main/modules/audio.lua"
click node_settings "https://github.com/adityamalu/spacewarrior/blob/main/modules/settings.lua"
click node_network "https://github.com/adityamalu/spacewarrior/blob/main/modules/net.lua"
click node_client_state "https://github.com/adityamalu/spacewarrior/blob/main/states/NetClientState.lua"

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_main,node_state_machine toneBlue
class node_game_states,node_play_state,node_client_state toneAmber
class node_player,node_bullets,node_physics,node_powerups,node_power_supplier toneMint
class node_maps,node_audio,node_settings,node_network toneRose
class node_players toneIndigo
```

## Components

### Game Runtime

- [Game Entry](https://github.com/adityamalu/spacewarrior/blob/main/main.lua): `main.lua`
- [State Machine](https://github.com/adityamalu/spacewarrior/blob/main/StateMachine.lua): `StateMachine.lua`

### Game States

- [Game States](https://github.com/adityamalu/spacewarrior/tree/main/states): `states`
- [Play State](https://github.com/adityamalu/spacewarrior/blob/main/states/PlayState.lua): `states/PlayState.lua`
- [Network Client](https://github.com/adityamalu/spacewarrior/blob/main/states/NetClientState.lua): `states/NetClientState.lua`

### Combat Systems

- [Player Ships](https://github.com/adityamalu/spacewarrior/blob/main/modules/Player.lua): `modules/Player.lua`
- [Weapons](https://github.com/adityamalu/spacewarrior/blob/main/modules/bullets.lua): `modules/bullets.lua`
- [Physics](https://github.com/adityamalu/spacewarrior/blob/main/modules/physics.lua): `modules/physics.lua`
- [Powerups](https://github.com/adityamalu/spacewarrior/blob/main/modules/powerups.lua): `modules/powerups.lua`
- [Power Supply](https://github.com/adityamalu/spacewarrior/blob/main/modules/powersuplier.lua): `modules/powersuplier.lua`

### Game Support

- [Arena Maps](https://github.com/adityamalu/spacewarrior/blob/main/modules/maps.lua): `modules/maps.lua`
- [Audio](https://github.com/adityamalu/spacewarrior/blob/main/modules/audio.lua): `modules/audio.lua`
- [Settings](https://github.com/adityamalu/spacewarrior/blob/main/modules/settings.lua): `modules/settings.lua`
- [Network](https://github.com/adityamalu/spacewarrior/blob/main/modules/net.lua): `modules/net.lua`

### Other components

- **Local Players**

## Connections

- Local Players → Game Entry: start game (evidence: `README.md`)
- Game Entry → State Machine: uses states
- State Machine → Game States: manages
- Game States → Play State: includes (evidence: `README.md`)
- Play State → Player Ships: runs combat
- Play State → Weapons: uses weapons
- Play State → Physics: uses physics
- Play State → Powerups: uses powerups
- Play State → Power Supply: uses supplies
- Play State → Arena Maps: uses arenas
- Play State → Audio: plays audio
- Game States → Settings: includes settings (evidence: `README.md`)
- Game States → Network Client: includes client
- Network Client → Network: uses network
