# trisciacabello01/oop-arcania-text-based-rpg-using-java architecture

> Architecture diagram of the GitHub repository trisciacabello01/oop-arcania-text-based-rpg-using-java, 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/trisciacabello01/oop-arcania-text-based-rpg-using-java
- Repository: https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java

## Overview

Arcania is a console RPG whose opening academic-grade calculation leads into a fantasy story with quests, battles, and embedded mini-games. Main starts the RPG; the RPG opening runs the grade calculation, and the story controller coordinates quest events and mini-game calls. Shared RPG state tracks lives and damage, while a utility handles console presentation and audio playback. Several quest paths are only partially excerpted, so the graph includes documented capabilities without inferring their internal call sequence.

Main entry points: [`src/RPG.java`](https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/RPG.java) (RPG shell and state), [`src/Isekai.java`](https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/Isekai.java) (Quest story controller), [`src/misc.java`](https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/misc.java) (Audio and console utilities), [`src/Quiz.java`](https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/Quiz.java) (Knowledge quiz)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Game entry"]
  node_main["Application entry<br/>[Main.java]"]
  node_rpg["RPG shell and state<br/>[RPG.java]"]
  node_gwa["GWA calculation<br/>[GWA.java]"]
end

subgraph group_story["Story progression"]
  node_isekai["Quest story controller<br/>[Isekai.java]"]
end

subgraph group_games["Combat and mini-games"]
  node_rps["RPS combat<br/>[RPS.java]"]
  node_quiz["Knowledge quiz<br/>[Quiz.java]"]
  node_mathquiz["Math quiz<br/>[MathQuiz.java]"]
  node_wordguess["Word guessing<br/>[WordGuess.java]"]
  node_hangman["Hangman game<br/>[HangmanGame.java]"]
end

subgraph group_shared["Shared runtime"]
  node_ascii["ASCII artwork<br/>[Ascii.java]"]
  node_misc["Audio and console utilities<br/>[misc.java]"]
  node_soundfx["Sound effects"]
end

node_player(("Player"))

node_player -->|"starts"| node_main
node_main -->|"opens game"| node_rpg
node_rpg -->|"plays music"| node_misc
node_rpg -->|"computes grades"| node_gwa
node_gwa -->|"continues story"| node_rpg
node_rpg -->|"starts transition"| node_isekai
node_isekai -->|"uses game state"| node_rpg
node_isekai -->|"dispatches combat"| node_rps
node_isekai -->|"starts quiz"| node_quiz
node_isekai -->|"uses quiz"| node_mathquiz
node_isekai -->|"uses word game"| node_wordguess
node_isekai -->|"starts hangman"| node_hangman
node_isekai -->|"renders scenes"| node_ascii
node_isekai -->|"controls music"| node_misc
node_rps -->|"plays effects"| node_misc
node_quiz -->|"updates lives"| node_rpg
node_quiz -->|"plays effect"| node_misc
node_mathquiz -->|"updates lives"| node_rpg
node_mathquiz -->|"plays effect"| node_misc
node_wordguess -->|"updates lives"| node_rpg
node_hangman -->|"updates lives"| node_rpg
node_hangman -->|"plays effect"| node_misc

click node_main "https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/Main.java"
click node_rpg "https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/RPG.java"
click node_gwa "https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/GWA.java"
click node_isekai "https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/Isekai.java"
click node_rps "https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/RPS.java"
click node_quiz "https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/Quiz.java"
click node_mathquiz "https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/MathQuiz.java"
click node_wordguess "https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/WordGuess.java"
click node_hangman "https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/HangmanGame.java"
click node_ascii "https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/Ascii.java"
click node_misc "https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/misc.java"
click node_soundfx "https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/tree/main/res/sfx"

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_rpg,node_gwa toneBlue
class node_isekai toneAmber
class node_rps,node_quiz,node_mathquiz,node_wordguess,node_hangman toneMint
class node_ascii,node_misc,node_soundfx toneRose
class node_player toneIndigo
```

## Components

### Game entry

- [Application entry](https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/Main.java): `src/Main.java`
- [RPG shell and state](https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/RPG.java): `src/RPG.java`
- [GWA calculation](https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/GWA.java): `src/GWA.java`

### Story progression

- [Quest story controller](https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/Isekai.java): `src/Isekai.java`

### Combat and mini-games

- [RPS combat](https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/RPS.java): `src/RPS.java`
- [Knowledge quiz](https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/Quiz.java): `src/Quiz.java`
- [Math quiz](https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/MathQuiz.java): `src/MathQuiz.java`
- [Word guessing](https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/WordGuess.java): `src/WordGuess.java`
- [Hangman game](https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/HangmanGame.java): `src/HangmanGame.java`

### Shared runtime

- [ASCII artwork](https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/Ascii.java): `src/Ascii.java`
- [Audio and console utilities](https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/blob/main/src/misc.java): `src/misc.java`
- [Sound effects](https://github.com/trisciacabello01/oop-arcania-text-based-rpg-using-java/tree/main/res/sfx): `res/sfx`

### Other components

- **Player**

## Connections

- Player → Application entry: starts (evidence: `README.md`)
- Application entry → RPG shell and state: opens game (evidence: `src/Main.java`)
- RPG shell and state → Audio and console utilities: plays music (evidence: `src/RPG.java`)
- RPG shell and state → GWA calculation: computes grades (evidence: `src/RPG.java`)
- GWA calculation → RPG shell and state: continues story (evidence: `src/GWA.java`)
- RPG shell and state → Quest story controller: starts transition (evidence: `src/RPG.java`)
- Quest story controller → RPG shell and state: uses game state (evidence: `src/Isekai.java`)
- Quest story controller → RPS combat: dispatches combat (evidence: `src/Isekai.java`)
- Quest story controller → Knowledge quiz: starts quiz (evidence: `src/Isekai.java`)
- Quest story controller → Math quiz: uses quiz (evidence: `src/Isekai.java`)
- Quest story controller → Word guessing: uses word game (evidence: `src/Isekai.java`)
- Quest story controller → Hangman game: starts hangman (evidence: `src/Isekai.java`)
- Quest story controller → ASCII artwork: renders scenes (evidence: `src/Isekai.java`)
- Quest story controller → Audio and console utilities: controls music (evidence: `src/Isekai.java`)
- RPS combat → Audio and console utilities: plays effects (evidence: `src/RPS.java`)
- Knowledge quiz → RPG shell and state: updates lives (evidence: `src/Quiz.java`)
- Knowledge quiz → Audio and console utilities: plays effect (evidence: `src/Quiz.java`)
- Math quiz → RPG shell and state: updates lives (evidence: `src/MathQuiz.java`)
- Math quiz → Audio and console utilities: plays effect (evidence: `src/MathQuiz.java`)
- Word guessing → RPG shell and state: updates lives (evidence: `src/WordGuess.java`)
- Hangman game → RPG shell and state: updates lives (evidence: `src/HangmanGame.java`)
- Hangman game → Audio and console utilities: plays effect (evidence: `src/HangmanGame.java`)
