# harpersdad/characterstats architecture

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

- Interactive diagram: https://gitdiagram.com/harpersdad/characterstats
- Repository: https://github.com/harpersdad/characterstats

## Overview

Character Stats is a desktop character-sheet and progression app. A user opens the Swing UI, creates or selects a character, views stats and equipment, adds XP, and can save, load, or delete characters. Startup initializes item/equipment definitions and checks for saved data; job and equipment rules supply character setup. The README also lists inventory, item creation, enemies, abilities, enchantments, status effects, and damage multipliers as present in code but not usable. Connections below follow shown calls or README claims; some feature internals were not sampled.

Main entry points: [`characterStats/src/Buttons.java`](https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Buttons.java) (UI actions), [`characterStats/src/Jobs.java`](https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Jobs.java) (Job setup), [`characterStats/src/OnStart.java`](https://github.com/harpersdad/characterstats/blob/main/characterStats/src/OnStart.java) (Startup setup), [`characterStats/src/CreateUI.java`](https://github.com/harpersdad/characterstats/blob/main/characterStats/src/CreateUI.java) (Creation form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup_ui["Startup and UI"]
  node_main["Application entry<br/>[Main.java]"]
  node_startup["Startup setup<br/>[OnStart.java]"]
  node_main_ui["Character screen<br/>[StatUI.java]"]
  node_create_ui["Creation form<br/>[CreateUI.java]"]
  node_ui_methods["UI helpers<br/>[UIMethods.java]"]
  node_actions["UI actions<br/>[Buttons.java]"]
end

subgraph group_character["Character domain"]
  node_player_model["Character model<br/>[Player.java]"]
  node_job_rules["Job setup<br/>[Jobs.java]"]
  node_equipment["Equipment rules<br/>[Equipment.java]"]
end

subgraph group_items_combat["Items and combat"]
  node_definitions["Item definitions<br/>[Objects.java]"]
  node_items["Inventory items<br/>[Items.java]"]
  node_variables["Game variables<br/>[Variables.java]"]
  node_abilities["Abilities<br/>[Abilities.java]"]
  node_enemy["Enemy data<br/>[Enemy.java]"]
end

subgraph group_persistence["Persistence"]
  node_save_logic["Save and load<br/>[Save.java]"]
  node_save_file[("Character save file<br/>[saveData.json]")]
end

node_user(("Player"))

node_user -->|"uses"| node_main_ui
node_main -->|"starts"| node_startup
node_startup -->|"initializes"| node_definitions
node_startup -->|"checks save"| node_save_logic
node_startup -->|"opens"| node_main_ui
node_main_ui -->|"registers actions"| node_actions
node_user -->|"creates character"| node_create_ui
node_actions -->|"opens form"| node_create_ui
node_create_ui -->|"creates player"| node_ui_methods
node_create_ui -->|"sets up"| node_player_model
node_actions -->|"refreshes display"| node_ui_methods
node_actions -->|"assigns job"| node_job_rules
node_actions -->|"sets equipment"| node_equipment
node_actions -->|"loads and saves"| node_save_logic
node_player_model -.->|"levels by job"| node_job_rules
node_job_rules -->|"assigns stats"| node_player_model
node_job_rules -->|"assigns starting items"| node_items
node_job_rules -->|"assigns starting gear"| node_equipment
node_player_model -->|"applies gear buffs"| node_equipment
node_definitions -->|"defines gear"| node_equipment
node_definitions -.->|"defines items"| node_items
node_save_logic -->|"reads and writes"| node_save_file
node_user -->|"levels character"| node_main_ui
node_user -->|"saves or loads"| node_save_logic

click node_main "https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Main.java"
click node_startup "https://github.com/harpersdad/characterstats/blob/main/characterStats/src/OnStart.java"
click node_main_ui "https://github.com/harpersdad/characterstats/blob/main/characterStats/src/StatUI.java"
click node_create_ui "https://github.com/harpersdad/characterstats/blob/main/characterStats/src/CreateUI.java"
click node_ui_methods "https://github.com/harpersdad/characterstats/blob/main/characterStats/src/UIMethods.java"
click node_actions "https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Buttons.java"
click node_player_model "https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Player.java"
click node_job_rules "https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Jobs.java"
click node_equipment "https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Equipment.java"
click node_definitions "https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Objects.java"
click node_items "https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Items.java"
click node_variables "https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Variables.java"
click node_abilities "https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Abilities.java"
click node_enemy "https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Enemy.java"
click node_save_logic "https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Save.java"
click node_save_file "https://github.com/harpersdad/characterstats/blob/main/characterStats/saveData.json"

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_startup,node_main_ui,node_create_ui,node_ui_methods,node_actions toneBlue
class node_player_model,node_job_rules,node_equipment toneAmber
class node_definitions,node_items,node_variables,node_abilities,node_enemy toneMint
class node_save_logic,node_save_file toneRose
class node_user toneIndigo
```

## Components

### Startup and UI

- [Application entry](https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Main.java): `characterStats/src/Main.java`
- [Startup setup](https://github.com/harpersdad/characterstats/blob/main/characterStats/src/OnStart.java): `characterStats/src/OnStart.java`
- [Character screen](https://github.com/harpersdad/characterstats/blob/main/characterStats/src/StatUI.java): `characterStats/src/StatUI.java`
- [Creation form](https://github.com/harpersdad/characterstats/blob/main/characterStats/src/CreateUI.java): `characterStats/src/CreateUI.java`
- [UI helpers](https://github.com/harpersdad/characterstats/blob/main/characterStats/src/UIMethods.java): `characterStats/src/UIMethods.java`
- [UI actions](https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Buttons.java): `characterStats/src/Buttons.java`

### Character domain

- [Character model](https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Player.java): `characterStats/src/Player.java`
- [Job setup](https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Jobs.java): `characterStats/src/Jobs.java`
- [Equipment rules](https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Equipment.java): `characterStats/src/Equipment.java`

### Items and combat

- [Item definitions](https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Objects.java): `characterStats/src/Objects.java`
- [Inventory items](https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Items.java): `characterStats/src/Items.java`
- [Game variables](https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Variables.java): `characterStats/src/Variables.java`
- [Abilities](https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Abilities.java): `characterStats/src/Abilities.java`
- [Enemy data](https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Enemy.java): `characterStats/src/Enemy.java`

### Persistence

- [Save and load](https://github.com/harpersdad/characterstats/blob/main/characterStats/src/Save.java): `characterStats/src/Save.java`
- [Character save file](https://github.com/harpersdad/characterstats/blob/main/characterStats/saveData.json): `characterStats/saveData.json`

### Other components

- **Player**

## Connections

- Player → Character screen: uses (evidence: `README.md`)
- Application entry → Startup setup: starts (evidence: `characterStats/src/Main.java`)
- Startup setup → Item definitions: initializes (evidence: `characterStats/src/OnStart.java`)
- Startup setup → Save and load: checks save (evidence: `characterStats/src/OnStart.java`)
- Startup setup → Character screen: opens (evidence: `characterStats/src/OnStart.java`)
- Character screen → UI actions: registers actions (evidence: `characterStats/src/StatUI.java`)
- Player → Creation form: creates character (evidence: `README.md`)
- UI actions → Creation form: opens form (evidence: `characterStats/src/Buttons.java`)
- Creation form → UI helpers: creates player (evidence: `characterStats/src/CreateUI.java`)
- Creation form → Character model: sets up (evidence: `characterStats/src/CreateUI.java`)
- UI actions → UI helpers: refreshes display (evidence: `characterStats/src/Buttons.java`)
- UI actions → Job setup: assigns job (evidence: `characterStats/src/Buttons.java`)
- UI actions → Equipment rules: sets equipment (evidence: `characterStats/src/Buttons.java`)
- UI actions → Save and load: loads and saves (evidence: `characterStats/src/Buttons.java`)
- Character model → Job setup: levels by job (evidence: `characterStats/src/Jobs.java`)
- Job setup → Character model: assigns stats (evidence: `characterStats/src/Jobs.java`)
- Job setup → Inventory items: assigns starting items (evidence: `characterStats/src/Jobs.java`)
- Job setup → Equipment rules: assigns starting gear (evidence: `characterStats/src/Jobs.java`)
- Character model → Equipment rules: applies gear buffs (evidence: `characterStats/src/Player.java`)
- Item definitions → Equipment rules: defines gear (evidence: `characterStats/src/Objects.java`)
- Item definitions → Inventory items: defines items (evidence: `characterStats/src/Objects.java`)
- Save and load → Character save file: reads and writes (evidence: `characterStats/src/Save.java`)
- Player → Character screen: levels character (evidence: `README.md`)
- Player → Save and load: saves or loads (evidence: `README.md`)
