# chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game architecture

> Architecture diagram of the GitHub repository chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game
- Repository: https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game

## Overview

Typing Battle Arena is a Swing typing-combat game with story, versus-AI, and local two-player modes. The main flow is launch, choose a mode and fighters/settings, type prompts in an arena, then review match results; a leaderboard and local records are additional product capabilities. CombatEngine owns combat rules and uses word generation, effects, audio, and fighter/stat state. Several UI relationships are documented by the source index; persistence implementation is not present in the supplied tree, so its node uses the enclosing source directory and the README as evidence.

Main entry points: [`src/com/typingbattle/engine/CombatEngine.java`](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/engine/CombatEngine.java) (Combat engine), [`src/com/typingbattle/ui/ScreenManager.java`](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/ScreenManager.java) (Screen manager), [`src/com/typingbattle/ui/ArenaPanel.java`](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/ArenaPanel.java) (Single-player arena), [`src/com/typingbattle/ui/TwoPlayerArenaPanel.java`](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/TwoPlayerArenaPanel.java) (Two-player arena)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Game interface"]
  node_main["Application entry<br/>[Main.java]"]
  node_screens["Screen manager<br/>[ScreenManager.java]"]
  node_menu["Main menu<br/>[MainMenuPanel.java]"]
  node_storyui["Story selection<br/>[StoryPanel.java]"]
  node_character["Character selection"]
  node_difficulty["Match settings"]
  node_arena["Single-player arena<br/>[ArenaPanel.java]"]
  node_duel["Two-player arena"]
  node_render["Fighter rendering"]
  node_backdrop["Arena backdrop"]
end

subgraph group_combat["Combat runtime"]
  node_combatengine["Combat engine<br/>[CombatEngine.java]"]
  node_words["Word bank<br/>[WordBank.java]"]
  node_particles["Particle effects"]
  node_sound["Sound engine<br/>[SoundEngine.java]"]
end

subgraph group_domain["Game domain"]
  node_fighters["Fighter state<br/>[Fighter.java]"]
  node_profiles["Character profiles"]
  node_rules["Difficulty and AI"]
  node_stages["Story stages<br/>[StoryStage.java]"]
  node_stats["Match statistics<br/>[MatchStats.java]"]
end

subgraph group_records["Results and records"]
  node_results["Results and coaching<br/>[ResultPanel.java]"]
  node_leaderboard["Leaderboard view"]
  node_localrecords[("Local match records")]
end

node_player(("Player"))

node_main -->|"creates"| node_screens
node_player -.->|"starts game"| node_menu
node_screens -->|"routes to"| node_menu
node_screens -->|"routes to"| node_storyui
node_screens -->|"routes to"| node_character
node_screens -->|"routes to"| node_difficulty
node_screens -->|"starts battle"| node_arena
node_screens -->|"routes to"| node_duel
node_screens -->|"shows results"| node_results
node_screens -->|"shows records"| node_leaderboard
node_storyui -->|"reads stages"| node_stages
node_character -->|"selects fighter"| node_profiles
node_difficulty -->|"selects settings"| node_rules
node_arena -->|"creates and updates"| node_combatengine
node_duel -->|"uses"| node_combatengine
node_arena -->|"creates"| node_particles
node_arena -->|"gets instance"| node_sound
node_combatengine -->|"requests prompts"| node_words
node_combatengine -->|"spawns effects"| node_particles
node_combatengine -->|"plays effects"| node_sound
node_combatengine -->|"updates combatants"| node_fighters
node_combatengine -->|"records performance"| node_stats
node_combatengine -->|"uses parameters"| node_rules
node_combatengine -->|"uses fighter profiles"| node_profiles
node_arena -->|"renders fighters"| node_render
node_arena -->|"renders backdrop"| node_backdrop
node_duel -->|"renders fighters"| node_render
node_duel -->|"renders backdrop"| node_backdrop
node_results -->|"reads match"| node_combatengine
node_results -->|"displays analytics"| node_stats
node_results -.->|"saves records"| node_localrecords
node_leaderboard -.->|"reads records"| node_localrecords

click node_main "https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/Main.java"
click node_screens "https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/ScreenManager.java"
click node_menu "https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/MainMenuPanel.java"
click node_storyui "https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/StoryPanel.java"
click node_character "https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/CharacterSelectPanel.java"
click node_difficulty "https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/DifficultySelectPanel.java"
click node_arena "https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/ArenaPanel.java"
click node_duel "https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/TwoPlayerArenaPanel.java"
click node_render "https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/FighterRenderer.java"
click node_backdrop "https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/ArenaBackgroundRenderer.java"
click node_combatengine "https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/engine/CombatEngine.java"
click node_words "https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/engine/WordBank.java"
click node_particles "https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/engine/ParticleSystem.java"
click node_sound "https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/engine/SoundEngine.java"
click node_fighters "https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/model/Fighter.java"
click node_profiles "https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/model/CharacterProfile.java"
click node_rules "https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/tree/main/src/com/typingbattle/model"
click node_stages "https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/model/StoryStage.java"
click node_stats "https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/model/MatchStats.java"
click node_results "https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/ResultPanel.java"
click node_leaderboard "https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/LeaderboardPanel.java"
click node_localrecords "https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/tree/main/src/com/typingbattle"

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_screens,node_menu,node_storyui,node_character,node_difficulty,node_arena,node_duel,node_render,node_backdrop toneBlue
class node_combatengine,node_words,node_particles,node_sound toneAmber
class node_fighters,node_profiles,node_rules,node_stages,node_stats toneMint
class node_results,node_leaderboard,node_localrecords toneRose
class node_player toneIndigo
```

## Components

### Game interface

- [Application entry](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/Main.java): `src/com/typingbattle/Main.java`
- [Screen manager](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/ScreenManager.java): `src/com/typingbattle/ui/ScreenManager.java`
- [Main menu](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/MainMenuPanel.java): `src/com/typingbattle/ui/MainMenuPanel.java`
- [Story selection](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/StoryPanel.java): `src/com/typingbattle/ui/StoryPanel.java`
- [Character selection](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/CharacterSelectPanel.java): `src/com/typingbattle/ui/CharacterSelectPanel.java`
- [Match settings](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/DifficultySelectPanel.java): `src/com/typingbattle/ui/DifficultySelectPanel.java`
- [Single-player arena](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/ArenaPanel.java): `src/com/typingbattle/ui/ArenaPanel.java`
- [Two-player arena](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/TwoPlayerArenaPanel.java): `src/com/typingbattle/ui/TwoPlayerArenaPanel.java`
- [Fighter rendering](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/FighterRenderer.java): `src/com/typingbattle/ui/FighterRenderer.java`
- [Arena backdrop](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/ArenaBackgroundRenderer.java): `src/com/typingbattle/ui/ArenaBackgroundRenderer.java`

### Combat runtime

- [Combat engine](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/engine/CombatEngine.java): `src/com/typingbattle/engine/CombatEngine.java`
- [Word bank](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/engine/WordBank.java): `src/com/typingbattle/engine/WordBank.java`
- [Particle effects](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/engine/ParticleSystem.java): `src/com/typingbattle/engine/ParticleSystem.java`
- [Sound engine](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/engine/SoundEngine.java): `src/com/typingbattle/engine/SoundEngine.java`

### Game domain

- [Fighter state](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/model/Fighter.java): `src/com/typingbattle/model/Fighter.java`
- [Character profiles](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/model/CharacterProfile.java): `src/com/typingbattle/model/CharacterProfile.java`
- [Difficulty and AI](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/tree/main/src/com/typingbattle/model): `src/com/typingbattle/model`
- [Story stages](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/model/StoryStage.java): `src/com/typingbattle/model/StoryStage.java`
- [Match statistics](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/model/MatchStats.java): `src/com/typingbattle/model/MatchStats.java`

### Results and records

- [Results and coaching](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/ResultPanel.java): `src/com/typingbattle/ui/ResultPanel.java`
- [Leaderboard view](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/blob/main/src/com/typingbattle/ui/LeaderboardPanel.java): `src/com/typingbattle/ui/LeaderboardPanel.java`
- [Local match records](https://github.com/chetan590/typing-battle-arena-a-java-gui-based-interactive-typing-combat-game/tree/main/src/com/typingbattle): `src/com/typingbattle`

### Other components

- **Player**

## Connections

- Application entry → Screen manager: creates (evidence: `src/com/typingbattle/Main.java`)
- Player → Main menu: starts game
- Screen manager → Main menu: routes to (evidence: `src/com/typingbattle/ui/ScreenManager.java`)
- Screen manager → Story selection: routes to (evidence: `src/com/typingbattle/ui/ScreenManager.java`)
- Screen manager → Character selection: routes to (evidence: `src/com/typingbattle/ui/ScreenManager.java`)
- Screen manager → Match settings: routes to (evidence: `src/com/typingbattle/ui/ScreenManager.java`)
- Screen manager → Single-player arena: starts battle (evidence: `src/com/typingbattle/ui/ScreenManager.java`)
- Screen manager → Two-player arena: routes to (evidence: `src/com/typingbattle/ui/ScreenManager.java`)
- Screen manager → Results and coaching: shows results (evidence: `src/com/typingbattle/ui/ScreenManager.java`)
- Screen manager → Leaderboard view: shows records (evidence: `src/com/typingbattle/ui/ScreenManager.java`)
- Story selection → Story stages: reads stages (evidence: `src/com/typingbattle/ui/StoryPanel.java`)
- Character selection → Character profiles: selects fighter (evidence: `src/com/typingbattle/ui/CharacterSelectPanel.java`)
- Match settings → Difficulty and AI: selects settings (evidence: `src/com/typingbattle/ui/DifficultySelectPanel.java`)
- Single-player arena → Combat engine: creates and updates (evidence: `src/com/typingbattle/ui/ArenaPanel.java`)
- Two-player arena → Combat engine: uses (evidence: `src/com/typingbattle/ui/TwoPlayerArenaPanel.java`)
- Single-player arena → Particle effects: creates (evidence: `src/com/typingbattle/ui/ArenaPanel.java`)
- Single-player arena → Sound engine: gets instance (evidence: `src/com/typingbattle/ui/ArenaPanel.java`)
- Combat engine → Word bank: requests prompts (evidence: `src/com/typingbattle/engine/CombatEngine.java`)
- Combat engine → Particle effects: spawns effects (evidence: `src/com/typingbattle/engine/CombatEngine.java`)
- Combat engine → Sound engine: plays effects (evidence: `src/com/typingbattle/engine/CombatEngine.java`)
- Combat engine → Fighter state: updates combatants (evidence: `src/com/typingbattle/engine/CombatEngine.java`)
- Combat engine → Match statistics: records performance (evidence: `src/com/typingbattle/engine/CombatEngine.java`)
- Combat engine → Difficulty and AI: uses parameters (evidence: `src/com/typingbattle/engine/CombatEngine.java`)
- Combat engine → Character profiles: uses fighter profiles (evidence: `src/com/typingbattle/engine/CombatEngine.java`)
- Single-player arena → Fighter rendering: renders fighters (evidence: `src/com/typingbattle/ui/ArenaPanel.java`)
- Single-player arena → Arena backdrop: renders backdrop (evidence: `src/com/typingbattle/ui/ArenaPanel.java`)
- Two-player arena → Fighter rendering: renders fighters (evidence: `src/com/typingbattle/ui/TwoPlayerArenaPanel.java`)
- Two-player arena → Arena backdrop: renders backdrop (evidence: `src/com/typingbattle/ui/TwoPlayerArenaPanel.java`)
- Results and coaching → Combat engine: reads match (evidence: `src/com/typingbattle/ui/ResultPanel.java`)
- Results and coaching → Match statistics: displays analytics (evidence: `src/com/typingbattle/ui/ResultPanel.java`)
- Results and coaching → Local match records: saves records (evidence: `README.md`)
- Leaderboard view → Local match records: reads records (evidence: `README.md`)
