# makotokung/courtroom_rl_v2 architecture

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

- Interactive diagram: https://gitdiagram.com/makotokung/courtroom_rl_v2
- Repository: https://github.com/makotokung/courtroom_rl_v2

## Overview

This is a Pygame courtroom-adventure game: players start at a menu, enter a scripted scene, read dialogue and present evidence, or play a courtroom case against AI. The courtroom uses a game environment and Q-tables; separate scenes provide an AI-judge mode, evidence viewing, and a gavel animation. Shared scene, dialogue, animation, UI, and audio modules support these experiences. The README is empty, so capabilities and links below are based on the supplied source excerpts and SOURCE INDEX; unsampled modules are not assumed to call one another.

Main entry points: [`scenes/menu_scene.py`](https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/menu_scene.py) (Main menu), [`main.py`](https://github.com/makotokung/courtroom_rl_v2/blob/main/main.py) (Game application), [`scenes/courtroom_scene.py`](https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/courtroom_scene.py) (Courtroom match), [`scenes/base_dialogue_scene.py`](https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/base_dialogue_scene.py) (Dialogue engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_game_flow["Game flow"]
  node_app["Game application<br/>[main.py]"]
  node_menu["Main menu<br/>[menu_scene.py]"]
  node_cutscene["Cutscene<br/>[exidence_scene.py]"]
  node_evidence_scene["Evidence scene<br/>[evidence_scene.py]"]
  node_gavel_scene["Gavel scene<br/>[grave.py]"]
end

subgraph group_story_evidence["Story and evidence"]
  node_judge_story["Judge story<br/>[judge_scene.py]"]
  node_dialogue["Dialogue engine"]
  node_evidence_menu["Evidence menu<br/>[evidence_menu.py]"]
  node_textbox["Textbox<br/>[textbox.py]"]
  node_evidence_data["Evidence records<br/>[evidence.json]"]
end

subgraph group_courtroom_ai["Courtroom and AI"]
  node_courtroom["Courtroom match<br/>[courtroom_scene.py]"]
  node_ai_judge["AI judge scene<br/>[ai_judge_scene.py]"]
  node_qtable_scene["Q-table viewer<br/>[qtable_scene.py]"]
  node_court_env["Court environment<br/>[train_model.py]"]
  node_model_training["Model training<br/>[train_model.py]"]
  node_game_data["Case and dialogue data<br/>[game_data.json]"]
  node_q_tables["Q-table files<br/>[q_table.json]"]
end

subgraph group_runtime_support["Runtime support"]
  node_base_scene["Scene base<br/>[base_scene.py]"]
  node_animation["Character animation"]
  node_ui["UI controls<br/>[ui.py]"]
  node_sound["Sound manager<br/>[sound.py]"]
  node_config["Display configuration<br/>[config.py]"]
end

node_player(("Player"))

node_player -->|"starts"| node_app
node_app -->|"opens"| node_menu
node_app -->|"uses"| node_config
node_app -->|"uses"| node_ui
node_app -->|"uses"| node_sound
node_app -->|"uses"| node_animation
node_app -->|"loads"| node_model_training
node_player -->|"selects"| node_menu
node_menu -->|"opens"| node_cutscene
node_menu -->|"opens"| node_courtroom
node_menu -->|"opens"| node_ai_judge
node_menu -->|"opens"| node_qtable_scene
node_cutscene -->|"extends"| node_base_scene
node_evidence_scene -->|"extends"| node_base_scene
node_judge_story -->|"extends"| node_dialogue
node_judge_story -->|"uses"| node_animation
node_dialogue -->|"extends"| node_base_scene
node_dialogue -->|"creates"| node_textbox
node_dialogue -->|"creates"| node_evidence_menu
node_dialogue -->|"loads"| node_evidence_data
node_ai_judge -->|"extends"| node_dialogue
node_ai_judge -->|"uses"| node_animation
node_courtroom -->|"creates"| node_court_env
node_courtroom -->|"reads"| node_game_data
node_courtroom -.->|"uses"| node_q_tables
node_courtroom -->|"plays"| node_sound
node_courtroom -->|"controls"| node_animation
node_court_env -->|"reads"| node_game_data
node_model_training -->|"trains"| node_court_env
node_model_training -->|"loads"| node_game_data
node_model_training -.->|"exports"| node_q_tables
node_qtable_scene -->|"extends"| node_base_scene
node_gavel_scene -->|"extends"| node_base_scene
node_gavel_scene -->|"uses"| node_ui
node_gavel_scene -->|"loads"| node_sound
node_menu -->|"extends"| node_base_scene
node_menu -->|"uses"| node_ui
node_evidence_menu -->|"uses"| node_config
node_textbox -->|"uses"| node_config

click node_app "https://github.com/makotokung/courtroom_rl_v2/blob/main/main.py"
click node_menu "https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/menu_scene.py"
click node_cutscene "https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/exidence_scene.py"
click node_evidence_scene "https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/evidence_scene.py"
click node_judge_story "https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/judge_scene.py"
click node_dialogue "https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/base_dialogue_scene.py"
click node_evidence_menu "https://github.com/makotokung/courtroom_rl_v2/blob/main/evidence_menu.py"
click node_textbox "https://github.com/makotokung/courtroom_rl_v2/blob/main/textbox.py"
click node_evidence_data "https://github.com/makotokung/courtroom_rl_v2/blob/main/evidence.json"
click node_courtroom "https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/courtroom_scene.py"
click node_ai_judge "https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/ai_judge_scene.py"
click node_qtable_scene "https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/qtable_scene.py"
click node_court_env "https://github.com/makotokung/courtroom_rl_v2/blob/main/train_model.py"
click node_model_training "https://github.com/makotokung/courtroom_rl_v2/blob/main/train_model.py"
click node_game_data "https://github.com/makotokung/courtroom_rl_v2/blob/main/game_data.json"
click node_q_tables "https://github.com/makotokung/courtroom_rl_v2/blob/main/Model/q_table.json"
click node_gavel_scene "https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/grave.py"
click node_base_scene "https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/base_scene.py"
click node_animation "https://github.com/makotokung/courtroom_rl_v2/blob/main/characteranimation.py"
click node_ui "https://github.com/makotokung/courtroom_rl_v2/blob/main/ui.py"
click node_sound "https://github.com/makotokung/courtroom_rl_v2/blob/main/sound.py"
click node_config "https://github.com/makotokung/courtroom_rl_v2/blob/main/config.py"

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_app,node_menu,node_cutscene,node_evidence_scene,node_gavel_scene toneBlue
class node_judge_story,node_dialogue,node_evidence_menu,node_textbox,node_evidence_data toneAmber
class node_courtroom,node_ai_judge,node_qtable_scene,node_court_env,node_model_training,node_game_data,node_q_tables toneMint
class node_base_scene,node_animation,node_ui,node_sound,node_config toneRose
class node_player toneIndigo
```

## Components

### Game flow

- [Game application](https://github.com/makotokung/courtroom_rl_v2/blob/main/main.py): `main.py`
- [Main menu](https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/menu_scene.py): `scenes/menu_scene.py`
- [Cutscene](https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/exidence_scene.py): `scenes/exidence_scene.py`
- [Evidence scene](https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/evidence_scene.py): `scenes/evidence_scene.py`
- [Gavel scene](https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/grave.py): `scenes/grave.py`

### Story and evidence

- [Judge story](https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/judge_scene.py): `scenes/judge_scene.py`
- [Dialogue engine](https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/base_dialogue_scene.py): `scenes/base_dialogue_scene.py`
- [Evidence menu](https://github.com/makotokung/courtroom_rl_v2/blob/main/evidence_menu.py): `evidence_menu.py`
- [Textbox](https://github.com/makotokung/courtroom_rl_v2/blob/main/textbox.py): `textbox.py`
- [Evidence records](https://github.com/makotokung/courtroom_rl_v2/blob/main/evidence.json): `evidence.json`

### Courtroom and AI

- [Courtroom match](https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/courtroom_scene.py): `scenes/courtroom_scene.py`
- [AI judge scene](https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/ai_judge_scene.py): `scenes/ai_judge_scene.py`
- [Q-table viewer](https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/qtable_scene.py): `scenes/qtable_scene.py`
- [Court environment](https://github.com/makotokung/courtroom_rl_v2/blob/main/train_model.py): `train_model.py`
- [Model training](https://github.com/makotokung/courtroom_rl_v2/blob/main/train_model.py): `train_model.py`
- [Case and dialogue data](https://github.com/makotokung/courtroom_rl_v2/blob/main/game_data.json): `game_data.json`
- [Q-table files](https://github.com/makotokung/courtroom_rl_v2/blob/main/Model/q_table.json): `Model/q_table.json`

### Runtime support

- [Scene base](https://github.com/makotokung/courtroom_rl_v2/blob/main/scenes/base_scene.py): `scenes/base_scene.py`
- [Character animation](https://github.com/makotokung/courtroom_rl_v2/blob/main/characteranimation.py): `characteranimation.py`
- [UI controls](https://github.com/makotokung/courtroom_rl_v2/blob/main/ui.py): `ui.py`
- [Sound manager](https://github.com/makotokung/courtroom_rl_v2/blob/main/sound.py): `sound.py`
- [Display configuration](https://github.com/makotokung/courtroom_rl_v2/blob/main/config.py): `config.py`

### Other components

- **Player**

## Connections

- Player → Game application: starts (evidence: `main.py`)
- Game application → Main menu: opens (evidence: `main.py`)
- Game application → Display configuration: uses (evidence: `main.py`)
- Game application → UI controls: uses (evidence: `main.py`)
- Game application → Sound manager: uses (evidence: `main.py`)
- Game application → Character animation: uses (evidence: `main.py`)
- Game application → Model training: loads (evidence: `main.py`)
- Player → Main menu: selects (evidence: `scenes/menu_scene.py`)
- Main menu → Cutscene: opens (evidence: `scenes/menu_scene.py`)
- Main menu → Courtroom match: opens (evidence: `scenes/menu_scene.py`)
- Main menu → AI judge scene: opens (evidence: `scenes/menu_scene.py`)
- Main menu → Q-table viewer: opens (evidence: `scenes/menu_scene.py`)
- Cutscene → Scene base: extends (evidence: `scenes/exidence_scene.py`)
- Evidence scene → Scene base: extends (evidence: `scenes/evidence_scene.py`)
- Judge story → Dialogue engine: extends (evidence: `scenes/judge_scene.py`)
- Judge story → Character animation: uses (evidence: `scenes/judge_scene.py`)
- Dialogue engine → Scene base: extends (evidence: `scenes/base_dialogue_scene.py`)
- Dialogue engine → Textbox: creates (evidence: `scenes/base_dialogue_scene.py`)
- Dialogue engine → Evidence menu: creates (evidence: `scenes/base_dialogue_scene.py`)
- Dialogue engine → Evidence records: loads (evidence: `scenes/base_dialogue_scene.py`)
- AI judge scene → Dialogue engine: extends (evidence: `scenes/ai_judge_scene.py`)
- AI judge scene → Character animation: uses (evidence: `scenes/ai_judge_scene.py`)
- Courtroom match → Court environment: creates (evidence: `scenes/courtroom_scene.py`)
- Courtroom match → Case and dialogue data: reads (evidence: `scenes/courtroom_scene.py`)
- Courtroom match → Q-table files: uses
- Courtroom match → Sound manager: plays (evidence: `scenes/courtroom_scene.py`)
- Courtroom match → Character animation: controls (evidence: `scenes/courtroom_scene.py`)
- Court environment → Case and dialogue data: reads (evidence: `train_model.py`)
- Model training → Court environment: trains (evidence: `train_model.py`)
- Model training → Case and dialogue data: loads (evidence: `train_model.py`)
- Model training → Q-table files: exports
- Q-table viewer → Scene base: extends (evidence: `scenes/qtable_scene.py`)
- Gavel scene → Scene base: extends (evidence: `scenes/grave.py`)
- Gavel scene → UI controls: uses (evidence: `scenes/grave.py`)
- Gavel scene → Sound manager: loads (evidence: `scenes/grave.py`)
- Main menu → Scene base: extends (evidence: `scenes/menu_scene.py`)
- Main menu → UI controls: uses (evidence: `scenes/menu_scene.py`)
- Evidence menu → Display configuration: uses (evidence: `evidence_menu.py`)
- Textbox → Display configuration: uses (evidence: `textbox.py`)
