# wamos0922/invaders-sdp-23621-currencysystem architecture

> Architecture diagram of the GitHub repository wamos0922/invaders-sdp-23621-currencysystem, 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/wamos0922/invaders-sdp-23621-currencysystem
- Repository: https://github.com/wamos0922/invaders-sdp-23621-currencysystem

## Overview

Space Invaders is a Java desktop game whose main flow is menu selection, gameplay, and post-game scoring, with separate settings, ship selection, shop, high-score, and achievement screens. Core coordinates screen transitions; GameScreen owns the play session and its entity interactions. The graph also preserves the item and achievement systems documented by the source index. Some subsystem paths and links are based on the index rather than inspected implementations, so uncertain connections are omitted.

Main entry points: [`src/engine/Core.java`](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/engine/Core.java) (Core coordinator), [`src/screen/GameScreen.java`](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/screen/GameScreen.java) (Game session), [`src/item/ItemManager.java`](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/item/ItemManager.java) (Item orchestration), [`src/engine/FileManager.java`](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/engine/FileManager.java) (File persistence)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application flow"]
  node_core["Core coordinator<br/>[Core.java]"]
  node_title["Title menu<br/>[TitleScreen.java]"]
  node_screen["Screen runtime<br/>[Screen.java]"]
  node_settings["Settings"]
  node_shipselect["Ship selection"]
  node_shop["Shop<br/>[ShopScreen.java]"]
end

subgraph group_play["Gameplay"]
  node_game["Game session<br/>[GameScreen.java]"]
  node_ship["Player ship<br/>[Ship.java]"]
  node_formation["Enemy formation"]
  node_enemy["Enemy ships<br/>[EnemyShip.java]"]
  node_entity["Entity model<br/>[Entity.java]"]
  node_bullet["Bullets and pool<br/>[BulletPool.java]"]
end

subgraph group_items["Items"]
  node_itemmanager["Item orchestration<br/>[ItemManager.java]"]
  node_itemapi["Item contracts<br/>[ItemAPI.java]"]
  node_definitions["Item definitions"]
  node_drops["Item drops"]
  node_effects["Item effects"]
  node_inventory["Item inventory<br/>[ItemInventory.java]"]
end

subgraph group_progress["Progress and rendering"]
  node_draw["Drawing manager<br/>[DrawManager.java]"]
  node_files[("File persistence<br/>[FileManager.java]")]
  node_scores["Score screens<br/>[ScoreScreen.java]"]
  node_highscores["High scores"]
  node_scoredata["Score records<br/>[Score.java]"]
  node_achievements["Achievement manager"]
  node_achievementdata["Achievement model<br/>[Achievement.java]"]
  node_achievementsscreen["Achievements screen"]
  node_profile["Player profile<br/>[PlayerProfile.java]"]
end

node_player(("Player"))

node_player -.->|"starts game"| node_core
node_core -->|"opens"| node_title
node_core -->|"opens"| node_game
node_core -->|"opens"| node_settings
node_core -->|"opens"| node_shipselect
node_core -->|"opens"| node_shop
node_core -->|"opens"| node_scores
node_core -->|"opens"| node_highscores
node_core -->|"opens"| node_achievementsscreen
node_player -.->|"selects menu"| node_title
node_game -->|"updates"| node_ship
node_game -->|"updates"| node_formation
node_game -->|"uses"| node_enemy
node_game -->|"tracks"| node_bullet
node_formation -->|"manages"| node_enemy
node_formation -->|"creates"| node_bullet
node_ship -->|"creates"| node_bullet
node_ship -->|"extends"| node_entity
node_enemy -->|"extends"| node_entity
node_bullet -->|"extends"| node_entity
node_game -.->|"integrates items"| node_itemmanager
node_itemmanager -->|"uses contracts"| node_itemapi
node_itemmanager -->|"validates catalog"| node_definitions
node_itemmanager -->|"advances drops"| node_drops
node_itemmanager -->|"advances effects"| node_effects
node_itemmanager -->|"manages inventory"| node_inventory
node_game -.->|"renders"| node_draw
node_draw -->|"draws"| node_entity
node_draw -->|"loads sprites"| node_files
node_core -.->|"uses persistence"| node_files
node_files -->|"loads and saves"| node_scoredata
node_files -->|"loads and saves"| node_profile
node_game -->|"ends in results"| node_scores
node_scores -->|"shows score"| node_scoredata
node_highscores -->|"lists records"| node_scoredata
node_core -->|"accesses manager"| node_achievements
node_achievements -->|"manages"| node_achievementdata
node_achievements -->|"updates progress"| node_profile
node_achievementsscreen -->|"displays"| node_achievementdata

click node_core "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/engine/Core.java"
click node_title "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/screen/TitleScreen.java"
click node_screen "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/screen/Screen.java"
click node_settings "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/screen/SettingsScreen.java"
click node_shipselect "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/screen/ShipSelectScreen.java"
click node_shop "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/screen/ShopScreen.java"
click node_game "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/screen/GameScreen.java"
click node_ship "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/entity/Ship.java"
click node_formation "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/entity/EnemyShipFormation.java"
click node_enemy "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/entity/EnemyShip.java"
click node_entity "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/entity/Entity.java"
click node_bullet "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/entity/BulletPool.java"
click node_itemmanager "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/item/ItemManager.java"
click node_itemapi "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/item/ItemAPI.java"
click node_definitions "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/item/ItemDefinitions.java"
click node_drops "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/item/ItemDropSystem.java"
click node_effects "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/item/ItemEffectSystem.java"
click node_inventory "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/item/ItemInventory.java"
click node_draw "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/engine/DrawManager.java"
click node_files "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/engine/FileManager.java"
click node_scores "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/screen/ScoreScreen.java"
click node_highscores "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/screen/HighScoreScreen.java"
click node_scoredata "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/engine/Score.java"
click node_achievements "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/engine/AchievementManager.java"
click node_achievementdata "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/engine/Achievement.java"
click node_achievementsscreen "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/screen/AchievementsScreen.java"
click node_profile "https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/engine/PlayerProfile.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_core,node_title,node_screen,node_settings,node_shipselect,node_shop toneBlue
class node_game,node_ship,node_formation,node_enemy,node_entity,node_bullet toneAmber
class node_itemmanager,node_itemapi,node_definitions,node_drops,node_effects,node_inventory toneMint
class node_draw,node_files,node_scores,node_highscores,node_scoredata,node_achievements,node_achievementdata,node_achievementsscreen,node_profile toneRose
class node_player toneIndigo
```

## Components

### Application flow

- [Core coordinator](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/engine/Core.java): `src/engine/Core.java`
- [Title menu](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/screen/TitleScreen.java): `src/screen/TitleScreen.java`
- [Screen runtime](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/screen/Screen.java): `src/screen/Screen.java`
- [Settings](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/screen/SettingsScreen.java): `src/screen/SettingsScreen.java`
- [Ship selection](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/screen/ShipSelectScreen.java): `src/screen/ShipSelectScreen.java`
- [Shop](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/screen/ShopScreen.java): `src/screen/ShopScreen.java`

### Gameplay

- [Game session](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/screen/GameScreen.java): `src/screen/GameScreen.java`
- [Player ship](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/entity/Ship.java): `src/entity/Ship.java`
- [Enemy formation](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/entity/EnemyShipFormation.java): `src/entity/EnemyShipFormation.java`
- [Enemy ships](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/entity/EnemyShip.java): `src/entity/EnemyShip.java`
- [Entity model](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/entity/Entity.java): `src/entity/Entity.java`
- [Bullets and pool](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/entity/BulletPool.java): `src/entity/BulletPool.java`

### Items

- [Item orchestration](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/item/ItemManager.java): `src/item/ItemManager.java`
- [Item contracts](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/item/ItemAPI.java): `src/item/ItemAPI.java`
- [Item definitions](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/item/ItemDefinitions.java): `src/item/ItemDefinitions.java`
- [Item drops](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/item/ItemDropSystem.java): `src/item/ItemDropSystem.java`
- [Item effects](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/item/ItemEffectSystem.java): `src/item/ItemEffectSystem.java`
- [Item inventory](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/item/ItemInventory.java): `src/item/ItemInventory.java`

### Progress and rendering

- [Drawing manager](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/engine/DrawManager.java): `src/engine/DrawManager.java`
- [File persistence](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/engine/FileManager.java): `src/engine/FileManager.java`
- [Score screens](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/screen/ScoreScreen.java): `src/screen/ScoreScreen.java`
- [High scores](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/screen/HighScoreScreen.java): `src/screen/HighScoreScreen.java`
- [Score records](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/engine/Score.java): `src/engine/Score.java`
- [Achievement manager](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/engine/AchievementManager.java): `src/engine/AchievementManager.java`
- [Achievement model](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/engine/Achievement.java): `src/engine/Achievement.java`
- [Achievements screen](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/screen/AchievementsScreen.java): `src/screen/AchievementsScreen.java`
- [Player profile](https://github.com/wamos0922/invaders-sdp-23621-currencysystem/blob/main/src/engine/PlayerProfile.java): `src/engine/PlayerProfile.java`

### Other components

- **Player**

## Connections

- Player → Core coordinator: starts game
- Core coordinator → Title menu: opens (evidence: `src/engine/Core.java`)
- Core coordinator → Game session: opens (evidence: `src/engine/Core.java`)
- Core coordinator → Settings: opens (evidence: `src/engine/Core.java`)
- Core coordinator → Ship selection: opens (evidence: `src/engine/Core.java`)
- Core coordinator → Shop: opens (evidence: `src/engine/Core.java`)
- Core coordinator → Score screens: opens (evidence: `src/engine/Core.java`)
- Core coordinator → High scores: opens (evidence: `src/engine/Core.java`)
- Core coordinator → Achievements screen: opens (evidence: `src/engine/Core.java`)
- Player → Title menu: selects menu
- Game session → Player ship: updates (evidence: `src/screen/GameScreen.java`)
- Game session → Enemy formation: updates (evidence: `src/screen/GameScreen.java`)
- Game session → Enemy ships: uses (evidence: `src/screen/GameScreen.java`)
- Game session → Bullets and pool: tracks (evidence: `src/screen/GameScreen.java`)
- Enemy formation → Enemy ships: manages (evidence: `src/entity/EnemyShipFormation.java`)
- Enemy formation → Bullets and pool: creates (evidence: `src/entity/EnemyShipFormation.java`)
- Player ship → Bullets and pool: creates (evidence: `src/entity/Ship.java`)
- Player ship → Entity model: extends (evidence: `src/entity/Ship.java`)
- Enemy ships → Entity model: extends (evidence: `src/entity/EnemyShip.java`)
- Bullets and pool → Entity model: extends
- Game session → Item orchestration: integrates items
- Item orchestration → Item contracts: uses contracts (evidence: `src/item/ItemManager.java`)
- Item orchestration → Item definitions: validates catalog (evidence: `src/item/ItemManager.java`)
- Item orchestration → Item drops: advances drops (evidence: `src/item/ItemManager.java`)
- Item orchestration → Item effects: advances effects (evidence: `src/item/ItemManager.java`)
- Item orchestration → Item inventory: manages inventory (evidence: `src/item/ItemManager.java`)
- Game session → Drawing manager: renders
- Drawing manager → Entity model: draws (evidence: `src/engine/DrawManager.java`)
- Drawing manager → File persistence: loads sprites (evidence: `src/engine/DrawManager.java`)
- Core coordinator → File persistence: uses persistence (evidence: `src/engine/Core.java`)
- File persistence → Score records: loads and saves (evidence: `src/engine/FileManager.java`)
- File persistence → Player profile: loads and saves (evidence: `src/engine/FileManager.java`)
- Game session → Score screens: ends in results (evidence: `src/engine/Core.java`)
- Score screens → Score records: shows score (evidence: `src/screen/ScoreScreen.java`)
- High scores → Score records: lists records (evidence: `src/screen/HighScoreScreen.java`)
- Core coordinator → Achievement manager: accesses manager (evidence: `src/engine/Core.java`)
- Achievement manager → Achievement model: manages (evidence: `src/engine/AchievementManager.java`)
- Achievement manager → Player profile: updates progress (evidence: `src/engine/AchievementManager.java`)
- Achievements screen → Achievement model: displays (evidence: `src/screen/AchievementsScreen.java`)
