# akiratorizawa/terminalrpg architecture

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

- Interactive diagram: https://gitdiagram.com/akiratorizawa/terminalrpg
- Repository: https://github.com/akiratorizawa/terminalrpg

## Overview

TerminalRPG is a Java GUI Pokémon battle simulator. The user selects a battle or About from the menu, then battles randomly fetched Pokémon using moves, healing items, and Pokéballs; keyboard and optional XInput controls drive the screens. The graph preserves the menu, About, battle, domain data, and persistence/sprite responsibilities. Battle and menu wiring is supported by excerpts; the complete battle implementation was not sampled, so unshown details are omitted.

Main entry points: [`src/main/java/com/dominic/terminalrpg/Battle.java`](https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/Battle.java) (Battle state and UI), [`src/main/java/com/dominic/terminalrpg/Database.java`](https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/Database.java) (Pokémon data access), [`src/main/java/com/dominic/terminalrpg/Window.java`](https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/Window.java) (Window and audio), [`src/main/java/com/dominic/terminalrpg/Pokemon.java`](https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/Pokemon.java) (Pokémon)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Screens and navigation"]
  node_main["Application entry<br/>[Main.java]"]
  node_window["Window and audio<br/>[Window.java]"]
  node_menu["Main menu<br/>[mainMenu.java]"]
  node_about["About screen<br/>[About.java]"]
end

subgraph group_battle["Battle experience"]
  node_battle["Battle state and UI<br/>[Battle.java]"]
  node_bag["Item bag<br/>[Bag.java]"]
end

subgraph group_domain["Game domain"]
  node_pokemon["Pokémon<br/>[Pokemon.java]"]
  node_move["Moves<br/>[Move.java]"]
  node_type["Types<br/>[Type.java]"]
  node_item["Items<br/>[Item.java]"]
end

subgraph group_data["Game data"]
  node_database["Pokémon data access<br/>[Database.java]"]
  node_dbfile[("Pokémon database<br/>[pokemon.db]")]
  node_sprite_service["Sprite image service"]
end

node_player(("Player"))

node_player -->|"launches"| node_main
node_main -->|"opens"| node_window
node_window -->|"shows"| node_menu
node_menu -->|"routes selection"| node_window
node_window -->|"shows"| node_about
node_about -->|"returns to menu"| node_window
node_window -->|"shows"| node_battle
node_battle -->|"plays audio"| node_window
node_battle -->|"fetches battle data"| node_database
node_database -->|"queries"| node_dbfile
node_database -->|"creates"| node_pokemon
node_database -->|"creates"| node_move
node_database -->|"creates"| node_type
node_database -->|"loads sprites"| node_sprite_service
node_sprite_service -.->|"supplies images"| node_battle
node_battle -->|"uses fighters"| node_pokemon
node_battle -->|"creates and uses"| node_bag
node_battle -->|"creates and consumes"| node_item
node_bag -->|"holds"| node_item
node_pokemon -->|"holds"| node_move
node_pokemon -->|"has typing"| node_type
node_move -->|"has typing"| node_type
node_battle -->|"selects attacks"| node_move
node_battle -->|"checks effectiveness"| node_database

click node_main "https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/Main.java"
click node_window "https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/Window.java"
click node_menu "https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/mainMenu.java"
click node_about "https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/About.java"
click node_battle "https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/Battle.java"
click node_bag "https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/Bag.java"
click node_pokemon "https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/Pokemon.java"
click node_move "https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/Move.java"
click node_type "https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/Type.java"
click node_item "https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/Item.java"
click node_database "https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/Database.java"
click node_dbfile "https://github.com/akiratorizawa/terminalrpg/blob/main/assets/db/pokemon.db"

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_window,node_menu,node_about toneBlue
class node_battle,node_bag toneAmber
class node_pokemon,node_move,node_type,node_item toneMint
class node_database,node_dbfile,node_sprite_service toneRose
class node_player toneIndigo
```

## Components

### Screens and navigation

- [Application entry](https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/Main.java): `src/main/java/com/dominic/terminalrpg/Main.java`
- [Window and audio](https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/Window.java): `src/main/java/com/dominic/terminalrpg/Window.java`
- [Main menu](https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/mainMenu.java): `src/main/java/com/dominic/terminalrpg/mainMenu.java`
- [About screen](https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/About.java): `src/main/java/com/dominic/terminalrpg/About.java`

### Battle experience

- [Battle state and UI](https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/Battle.java): `src/main/java/com/dominic/terminalrpg/Battle.java`
- [Item bag](https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/Bag.java): `src/main/java/com/dominic/terminalrpg/Bag.java`

### Game domain

- [Pokémon](https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/Pokemon.java): `src/main/java/com/dominic/terminalrpg/Pokemon.java`
- [Moves](https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/Move.java): `src/main/java/com/dominic/terminalrpg/Move.java`
- [Types](https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/Type.java): `src/main/java/com/dominic/terminalrpg/Type.java`
- [Items](https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/Item.java): `src/main/java/com/dominic/terminalrpg/Item.java`

### Game data

- [Pokémon data access](https://github.com/akiratorizawa/terminalrpg/blob/main/src/main/java/com/dominic/terminalrpg/Database.java): `src/main/java/com/dominic/terminalrpg/Database.java`
- [Pokémon database](https://github.com/akiratorizawa/terminalrpg/blob/main/assets/db/pokemon.db): `assets/db/pokemon.db`
- **Sprite image service**

### Other components

- **Player**

## Connections

- Player → Application entry: launches (evidence: `README.md`)
- Application entry → Window and audio: opens (evidence: `src/main/java/com/dominic/terminalrpg/Main.java`)
- Window and audio → Main menu: shows (evidence: `src/main/java/com/dominic/terminalrpg/Window.java`)
- Main menu → Window and audio: routes selection (evidence: `src/main/java/com/dominic/terminalrpg/mainMenu.java`)
- Window and audio → About screen: shows (evidence: `src/main/java/com/dominic/terminalrpg/Window.java`)
- About screen → Window and audio: returns to menu (evidence: `src/main/java/com/dominic/terminalrpg/About.java`)
- Window and audio → Battle state and UI: shows (evidence: `src/main/java/com/dominic/terminalrpg/Window.java`)
- Battle state and UI → Window and audio: plays audio (evidence: `src/main/java/com/dominic/terminalrpg/Battle.java`)
- Battle state and UI → Pokémon data access: fetches battle data (evidence: `src/main/java/com/dominic/terminalrpg/Battle.java`)
- Pokémon data access → Pokémon database: queries (evidence: `src/main/java/com/dominic/terminalrpg/Database.java`)
- Pokémon data access → Pokémon: creates (evidence: `src/main/java/com/dominic/terminalrpg/Database.java`)
- Pokémon data access → Moves: creates (evidence: `src/main/java/com/dominic/terminalrpg/Database.java`)
- Pokémon data access → Types: creates (evidence: `src/main/java/com/dominic/terminalrpg/Database.java`)
- Pokémon data access → Sprite image service: loads sprites (evidence: `src/main/java/com/dominic/terminalrpg/Database.java`)
- Sprite image service → Battle state and UI: supplies images
- Battle state and UI → Pokémon: uses fighters (evidence: `src/main/java/com/dominic/terminalrpg/Battle.java`)
- Battle state and UI → Item bag: creates and uses (evidence: `src/main/java/com/dominic/terminalrpg/Battle.java`)
- Battle state and UI → Items: creates and consumes (evidence: `src/main/java/com/dominic/terminalrpg/Battle.java`)
- Item bag → Items: holds (evidence: `src/main/java/com/dominic/terminalrpg/Bag.java`)
- Pokémon → Moves: holds (evidence: `src/main/java/com/dominic/terminalrpg/Pokemon.java`)
- Pokémon → Types: has typing (evidence: `src/main/java/com/dominic/terminalrpg/Pokemon.java`)
- Moves → Types: has typing (evidence: `src/main/java/com/dominic/terminalrpg/Move.java`)
- Battle state and UI → Moves: selects attacks (evidence: `src/main/java/com/dominic/terminalrpg/Battle.java`)
- Battle state and UI → Pokémon data access: checks effectiveness (evidence: `src/main/java/com/dominic/terminalrpg/Battle.java`)
