# andreamecozzi/mpgc2526_rpg architecture

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

- Interactive diagram: https://gitdiagram.com/andreamecozzi/mpgc2526_rpg
- Repository: https://github.com/andreamecozzi/mpgc2526_rpg

## Overview

CFU Quest is a JavaFX narrative RPG about a student’s university journey: the player starts or resumes a save, reads an event, chooses an option, and advances toward graduation by earning CFU and unlocking exams. The graph separates UI flow, game orchestration, event/player rules, and XML persistence. Source excerpts show the main choice and save path; the README documents the broader event-and-choice game premise, while several secondary screens and domain implementations are represented from the source index and tree.

Main entry points: [`CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/persistence/XMLPersistence.java`](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/persistence/XMLPersistence.java) (XML persistence), [`CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/GameManager.java`](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/GameManager.java) (Game manager), [`CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/view/GameScreen.java`](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/view/GameScreen.java) (Game screen), [`CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/controller/MenuScreenController.java`](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/controller/MenuScreenController.java) (Menu controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["JavaFX screens"]
  node_menu["Main menu<br/>[MenuScreen.java]"]
  node_menu_controller["Menu controller"]
  node_name["Name entry"]
  node_name_controller["Name controller"]
  node_loading["Loading screen<br/>[LoadingScreen.java]"]
  node_game_screen["Game screen<br/>[GameScreen.java]"]
  node_game_controller["Game controller"]
  node_retro_button["Retro buttons<br/>[RetroButton.java]"]
  node_screen_contracts["Screen and music contracts<br/>[Screen.java]"]
end

subgraph group_game["Game orchestration"]
  node_app["JavaFX application<br/>[CFU_Quest.java]"]
  node_state["Game state<br/>[GameState.java]"]
  node_manager["Game manager<br/>[GameManager.java]"]
end

subgraph group_domain["Story and player"]
  node_event["Event rules<br/>[Evento.java]"]
  node_exam_event["Exam events<br/>[EventoEsame.java]"]
  node_story_event["Story events<br/>[EventoStoria.java]"]
  node_option["Choices<br/>[Opzione.java]"]
  node_event_type["Event types<br/>[TipoEvento.java]"]
  node_player_model["Player model<br/>[Player.java]"]
  node_student["Student character<br/>[Studente.java]"]
end

subgraph group_storage["XML persistence"]
  node_persistence_api["Persistence contract<br/>[Persistence.java]"]
  node_xml["XML persistence"]
  node_save_file[("Save file")]
  node_event_data["Event and choice XML<br/>[eventi.xml]"]
  node_option_data["Choice XML<br/>[opzioni.xml]"]
end

node_player(("Player"))

node_player -->|"starts or resumes"| node_menu
node_app -->|"configures"| node_manager
node_app -->|"shows"| node_menu
node_menu -->|"handles actions"| node_menu_controller
node_menu_controller -->|"checks or loads"| node_manager
node_menu_controller -->|"opens"| node_name
node_menu_controller -->|"opens"| node_loading
node_menu_controller -->|"creates"| node_game_screen
node_name -->|"handles actions"| node_name_controller
node_name_controller -->|"starts game"| node_manager
node_name_controller -->|"opens"| node_loading
node_name_controller -->|"creates"| node_game_screen
node_loading -.->|"transitions to"| node_game_screen
node_game_screen -->|"initializes"| node_game_controller
node_game_controller -->|"reads and advances"| node_manager
node_game_controller -->|"returns to"| node_menu
node_game_screen -->|"creates controls"| node_retro_button
node_game_screen -->|"implements"| node_screen_contracts
node_manager -->|"executes choice"| node_event
node_manager -->|"delegates persistence"| node_xml
node_manager -->|"restores from"| node_state
node_manager -->|"tracks"| node_player_model
node_event -->|"offers"| node_option
node_exam_event -->|"specializes"| node_event
node_story_event -->|"specializes"| node_event
node_exam_event -->|"updates"| node_player_model
node_story_event -->|"uses"| node_player_model
node_student -->|"implements"| node_player_model
node_exam_event -->|"uses"| node_event_type
node_story_event -->|"uses"| node_event_type
node_xml -->|"implements"| node_persistence_api
node_xml -->|"reads and writes"| node_save_file
node_xml -->|"loads events"| node_event_data
node_xml -->|"loads choices"| node_option_data
node_xml -->|"returns loaded state"| node_state
node_xml -->|"constructs"| node_exam_event
node_xml -->|"constructs"| node_story_event

click node_app "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/CFU_Quest.java"
click node_state "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/GameState.java"
click node_manager "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/GameManager.java"
click node_menu "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/view/MenuScreen.java"
click node_menu_controller "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/controller/MenuScreenController.java"
click node_name "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/view/InsertNameScreen.java"
click node_name_controller "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/controller/InsertNameScreenController.java"
click node_loading "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/view/LoadingScreen.java"
click node_game_screen "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/view/GameScreen.java"
click node_game_controller "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/controller/GameScreenController.java"
click node_retro_button "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/utils/RetroButton.java"
click node_screen_contracts "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/view/Screen.java"
click node_event "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/eventi/Evento.java"
click node_exam_event "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/eventi/EventoEsame.java"
click node_story_event "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/eventi/EventoStoria.java"
click node_option "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/eventi/Opzione.java"
click node_event_type "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/eventi/TipoEvento.java"
click node_player_model "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/giocatore/Player.java"
click node_student "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/giocatore/Studente.java"
click node_persistence_api "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/persistence/Persistence.java"
click node_xml "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/persistence/XMLPersistence.java"
click node_event_data "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/resources/persistence/eventi.xml"
click node_option_data "https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/resources/persistence/opzioni.xml"

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_menu,node_menu_controller,node_name,node_name_controller,node_loading,node_game_screen,node_game_controller,node_retro_button,node_screen_contracts toneBlue
class node_app,node_state,node_manager toneAmber
class node_event,node_exam_event,node_story_event,node_option,node_event_type,node_player_model,node_student toneMint
class node_persistence_api,node_xml,node_save_file,node_event_data,node_option_data toneRose
class node_player toneIndigo
```

## Components

### JavaFX screens

- [Main menu](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/view/MenuScreen.java): `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/view/MenuScreen.java`
- [Menu controller](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/controller/MenuScreenController.java): `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/controller/MenuScreenController.java`
- [Name entry](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/view/InsertNameScreen.java): `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/view/InsertNameScreen.java`
- [Name controller](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/controller/InsertNameScreenController.java): `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/controller/InsertNameScreenController.java`
- [Loading screen](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/view/LoadingScreen.java): `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/view/LoadingScreen.java`
- [Game screen](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/view/GameScreen.java): `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/view/GameScreen.java`
- [Game controller](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/controller/GameScreenController.java): `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/controller/GameScreenController.java`
- [Retro buttons](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/utils/RetroButton.java): `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/utils/RetroButton.java`
- [Screen and music contracts](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/view/Screen.java): `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/view/Screen.java`

### Game orchestration

- [JavaFX application](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/CFU_Quest.java): `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/CFU_Quest.java`
- [Game state](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/GameState.java): `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/GameState.java`
- [Game manager](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/GameManager.java): `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/GameManager.java`

### Story and player

- [Event rules](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/eventi/Evento.java): `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/eventi/Evento.java`
- [Exam events](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/eventi/EventoEsame.java): `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/eventi/EventoEsame.java`
- [Story events](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/eventi/EventoStoria.java): `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/eventi/EventoStoria.java`
- [Choices](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/eventi/Opzione.java): `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/eventi/Opzione.java`
- [Event types](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/eventi/TipoEvento.java): `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/eventi/TipoEvento.java`
- [Player model](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/giocatore/Player.java): `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/giocatore/Player.java`
- [Student character](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/giocatore/Studente.java): `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/giocatore/Studente.java`

### XML persistence

- [Persistence contract](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/persistence/Persistence.java): `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/persistence/Persistence.java`
- [XML persistence](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/persistence/XMLPersistence.java): `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/persistence/XMLPersistence.java`
- **Save file**
- [Event and choice XML](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/resources/persistence/eventi.xml): `CFU_Quest/src/main/resources/persistence/eventi.xml`
- [Choice XML](https://github.com/andreamecozzi/mpgc2526_rpg/blob/main/CFU_Quest/src/main/resources/persistence/opzioni.xml): `CFU_Quest/src/main/resources/persistence/opzioni.xml`

### Other components

- **Player**

## Connections

- Player → Main menu: starts or resumes
- JavaFX application → Game manager: configures (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/CFU_Quest.java`)
- JavaFX application → Main menu: shows (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/CFU_Quest.java`)
- Main menu → Menu controller: handles actions (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/view/MenuScreen.java`)
- Menu controller → Game manager: checks or loads (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/controller/MenuScreenController.java`)
- Menu controller → Name entry: opens (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/controller/MenuScreenController.java`)
- Menu controller → Loading screen: opens (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/controller/MenuScreenController.java`)
- Menu controller → Game screen: creates (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/controller/MenuScreenController.java`)
- Name entry → Name controller: handles actions (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/view/InsertNameScreen.java`)
- Name controller → Game manager: starts game (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/controller/InsertNameScreenController.java`)
- Name controller → Loading screen: opens (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/controller/InsertNameScreenController.java`)
- Name controller → Game screen: creates (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/controller/InsertNameScreenController.java`)
- Loading screen → Game screen: transitions to
- Game screen → Game controller: initializes (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/view/GameScreen.java`)
- Game controller → Game manager: reads and advances (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/controller/GameScreenController.java`)
- Game controller → Main menu: returns to (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/controller/GameScreenController.java`)
- Game screen → Retro buttons: creates controls (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/view/GameScreen.java`)
- Game screen → Screen and music contracts: implements (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/view/GameScreen.java`)
- Game manager → Event rules: executes choice (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/GameManager.java`)
- Game manager → XML persistence: delegates persistence (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/GameManager.java`)
- Game manager → Game state: restores from (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/GameManager.java`)
- Game manager → Player model: tracks (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/GameManager.java`)
- Event rules → Choices: offers (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/eventi/Evento.java`)
- Exam events → Event rules: specializes (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/eventi/EventoEsame.java`)
- Story events → Event rules: specializes (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/eventi/EventoStoria.java`)
- Exam events → Player model: updates (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/eventi/EventoEsame.java`)
- Story events → Player model: uses (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/eventi/EventoStoria.java`)
- Student character → Player model: implements (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/giocatore/Studente.java`)
- Exam events → Event types: uses (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/eventi/EventoEsame.java`)
- Story events → Event types: uses (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/model/eventi/EventoStoria.java`)
- XML persistence → Persistence contract: implements (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/persistence/XMLPersistence.java`)
- XML persistence → Save file: reads and writes (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/persistence/XMLPersistence.java`)
- XML persistence → Event and choice XML: loads events (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/persistence/XMLPersistence.java`)
- XML persistence → Choice XML: loads choices (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/persistence/XMLPersistence.java`)
- XML persistence → Game state: returns loaded state (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/persistence/XMLPersistence.java`)
- XML persistence → Exam events: constructs (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/persistence/XMLPersistence.java`)
- XML persistence → Story events: constructs (evidence: `CFU_Quest/src/main/java/it/unicam/cs/mpgc/rpg126225/persistence/XMLPersistence.java`)
