# markeljhunpalatan/galaxy-shooter architecture

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

- Interactive diagram: https://gitdiagram.com/markeljhunpalatan/galaxy-shooter
- Repository: https://github.com/markeljhunpalatan/galaxy-shooter

## Overview

Starlight Rescue is a Java Swing side-view space shooter. The runtime starts in SpaceShooter, opens a GameFrame, and presents the game through GamePanel, which handles gameplay input, enemies, bullet collisions, and drawing; Player, Enemy, and Bullet supply gameplay objects. The README also advertises scrap, crafting, upgrades, mission progression, a mothership boss, and a rescue-and-return ending. Those latter capabilities are represented as documented features, not verified implementation stages; the excerpts do not show their wiring or full gameplay loop.

Main entry points: [`src/starlightrescue/GamePanel.java`](https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/GamePanel.java) (Game Panel), [`src/starlightrescue/SpaceShooter.java`](https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/SpaceShooter.java) (Launch), [`src/starlightrescue/GameFrame.java`](https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/GameFrame.java) (Game Window), [`src/starlightrescue/Player.java`](https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/Player.java) (Player Ship)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Game Runtime"]
  node_launch["Launch<br/>[SpaceShooter.java]"]
  node_window["Game Window<br/>[GameFrame.java]"]
  node_game["Game Panel<br/>[GamePanel.java]"]
end

subgraph group_gameplay["Gameplay Objects"]
  node_ship["Player Ship<br/>[Player.java]"]
  node_shots["Bullets<br/>[Bullet.java]"]
  node_aliens["Alien Enemies<br/>[Enemy.java]"]
end

subgraph group_campaign["Campaign Features"]
  node_scrap["Scrap Collection<br/>[GamePanel.java]"]
  node_crafting["Weapon Crafting<br/>[GamePanel.java]"]
  node_upgrades["Ship Upgrades<br/>[GamePanel.java]"]
  node_missions["Mission Progression<br/>[GamePanel.java]"]
  node_boss["Mothership Boss<br/>[GamePanel.java]"]
  node_rescue["Rescue Ending<br/>[GamePanel.java]"]
end

node_player(("Player"))

node_player -->|"starts"| node_launch
node_launch -->|"opens"| node_window
node_window -->|"creates"| node_game
node_game -->|"controls"| node_ship
node_game -->|"updates and checks"| node_shots
node_game -->|"spawns and checks"| node_aliens
node_game -.->|"documents"| node_scrap
node_game -.->|"documents"| node_crafting
node_game -.->|"documents"| node_upgrades
node_game -.->|"documents"| node_missions
node_game -.->|"documents"| node_boss
node_game -.->|"documents"| node_rescue

click node_launch "https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/SpaceShooter.java"
click node_window "https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/GameFrame.java"
click node_game "https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/GamePanel.java"
click node_ship "https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/Player.java"
click node_shots "https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/Bullet.java"
click node_aliens "https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/Enemy.java"
click node_scrap "https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/GamePanel.java"
click node_crafting "https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/GamePanel.java"
click node_upgrades "https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/GamePanel.java"
click node_missions "https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/GamePanel.java"
click node_boss "https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/GamePanel.java"
click node_rescue "https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/GamePanel.java"

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_launch,node_window,node_game toneBlue
class node_ship,node_shots,node_aliens toneAmber
class node_scrap,node_crafting,node_upgrades,node_missions,node_boss,node_rescue toneMint
class node_player toneIndigo
```

## Components

### Game Runtime

- [Launch](https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/SpaceShooter.java): `src/starlightrescue/SpaceShooter.java`
- [Game Window](https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/GameFrame.java): `src/starlightrescue/GameFrame.java`
- [Game Panel](https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/GamePanel.java): `src/starlightrescue/GamePanel.java`

### Gameplay Objects

- [Player Ship](https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/Player.java): `src/starlightrescue/Player.java`
- [Bullets](https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/Bullet.java): `src/starlightrescue/Bullet.java`
- [Alien Enemies](https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/Enemy.java): `src/starlightrescue/Enemy.java`

### Campaign Features

- [Scrap Collection](https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/GamePanel.java): `src/starlightrescue/GamePanel.java`
- [Weapon Crafting](https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/GamePanel.java): `src/starlightrescue/GamePanel.java`
- [Ship Upgrades](https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/GamePanel.java): `src/starlightrescue/GamePanel.java`
- [Mission Progression](https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/GamePanel.java): `src/starlightrescue/GamePanel.java`
- [Mothership Boss](https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/GamePanel.java): `src/starlightrescue/GamePanel.java`
- [Rescue Ending](https://github.com/markeljhunpalatan/galaxy-shooter/blob/main/src/starlightrescue/GamePanel.java): `src/starlightrescue/GamePanel.java`

### Other components

- **Player**

## Connections

- Player → Launch: starts (evidence: `src/starlightrescue/SpaceShooter.java`)
- Launch → Game Window: opens (evidence: `src/starlightrescue/SpaceShooter.java`)
- Game Window → Game Panel: creates (evidence: `src/starlightrescue/GameFrame.java`)
- Game Panel → Player Ship: controls (evidence: `src/starlightrescue/GamePanel.java`)
- Game Panel → Bullets: updates and checks (evidence: `src/starlightrescue/GamePanel.java`)
- Game Panel → Alien Enemies: spawns and checks (evidence: `src/starlightrescue/GamePanel.java`)
- Game Panel → Scrap Collection: documents (evidence: `README.md`)
- Game Panel → Weapon Crafting: documents (evidence: `README.md`)
- Game Panel → Ship Upgrades: documents (evidence: `README.md`)
- Game Panel → Mission Progression: documents (evidence: `README.md`)
- Game Panel → Mothership Boss: documents (evidence: `README.md`)
- Game Panel → Rescue Ending: documents (evidence: `README.md`)
