# jo-mag07/bahay-ni-kuya-murder-mystery architecture

> Architecture diagram of the GitHub repository jo-mag07/bahay-ni-kuya-murder-mystery, 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/jo-mag07/bahay-ni-kuya-murder-mystery
- Repository: https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery

## Overview

This repository contains a Java Swing murder-mystery game, with two standalone implementations: an earlier `BahayNiKuyaV3` and a later `BahayNiKuya`. The player progresses from the living-room hub through rooms, gathers keys and clues, solves riddles, enters a garden passcode, and reaches the final discovery. The sampled code shows the later version’s startup and menu dispatch, and excerpts from both versions show room investigation and progression state. The implementations are monolithic; the graph separates their meaningful responsibilities without implying separate runtime modules. No README was provided, so relationships not visible in excerpts are omitted.

Main entry points: [`game_final/main/BahayNiKuya.java`](https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/game_final/main/BahayNiKuya.java) (Room Investigation), [`BahayNiKuyaV3.java`](https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/BahayNiKuyaV3.java) (Earlier Game)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_play["Player Interaction"]
  node_game["Game Startup<br/>[BahayNiKuya.java]"]
  node_hub["Living Room Hub<br/>[BahayNiKuya.java]"]
  node_navigation["Room Navigation<br/>[BahayNiKuya.java]"]
end

subgraph group_investigation["Investigation Progression"]
  node_room["Room Investigation<br/>[BahayNiKuya.java]"]
  node_riddles["Riddle Answers<br/>[BahayNiKuya.java]"]
  node_inventory["Clue Inventory<br/>[BahayNiKuya.java]"]
  node_locks["Keys and Locks<br/>[BahayNiKuya.java]"]
  node_finale["Final Discovery<br/>[BahayNiKuya.java]"]
end

subgraph group_legacy["Earlier Version"]
  node_legacygame["Earlier Game<br/>[BahayNiKuyaV3.java]"]
  node_legacyrooms["Earlier Room Investigation<br/>[BahayNiKuyaV3.java]"]
  node_legacyprogress["Earlier Progression State<br/>[BahayNiKuyaV3.java]"]
end

node_player(("Player"))

node_player -->|"starts"| node_game
node_game -->|"opens menu"| node_hub
node_hub -->|"opens locations"| node_navigation
node_player -->|"chooses options"| node_hub
node_player -->|"investigates"| node_room
node_room -->|"checks answers"| node_riddles
node_room -->|"adds clues"| node_inventory
node_room -->|"updates access"| node_locks
node_locks -->|"unlocks entrance"| node_finale
node_player -->|"starts earlier version"| node_legacygame
node_legacygame -->|"dispatches investigation"| node_legacyrooms
node_legacyrooms -->|"updates state"| node_legacyprogress

click node_game "https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/game_final/main/BahayNiKuya.java"
click node_hub "https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/game_final/main/BahayNiKuya.java"
click node_navigation "https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/game_final/main/BahayNiKuya.java"
click node_room "https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/game_final/main/BahayNiKuya.java"
click node_riddles "https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/game_final/main/BahayNiKuya.java"
click node_inventory "https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/game_final/main/BahayNiKuya.java"
click node_locks "https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/game_final/main/BahayNiKuya.java"
click node_finale "https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/game_final/main/BahayNiKuya.java"
click node_legacygame "https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/BahayNiKuyaV3.java"
click node_legacyrooms "https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/BahayNiKuyaV3.java"
click node_legacyprogress "https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/BahayNiKuyaV3.java"

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_game,node_hub,node_navigation toneBlue
class node_room,node_riddles,node_inventory,node_locks,node_finale toneAmber
class node_legacygame,node_legacyrooms,node_legacyprogress toneMint
class node_player toneIndigo
```

## Components

### Player Interaction

- [Game Startup](https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/game_final/main/BahayNiKuya.java): `game_final/main/BahayNiKuya.java`
- [Living Room Hub](https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/game_final/main/BahayNiKuya.java): `game_final/main/BahayNiKuya.java`
- [Room Navigation](https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/game_final/main/BahayNiKuya.java): `game_final/main/BahayNiKuya.java`

### Investigation Progression

- [Room Investigation](https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/game_final/main/BahayNiKuya.java): `game_final/main/BahayNiKuya.java`
- [Riddle Answers](https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/game_final/main/BahayNiKuya.java): `game_final/main/BahayNiKuya.java`
- [Clue Inventory](https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/game_final/main/BahayNiKuya.java): `game_final/main/BahayNiKuya.java`
- [Keys and Locks](https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/game_final/main/BahayNiKuya.java): `game_final/main/BahayNiKuya.java`
- [Final Discovery](https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/game_final/main/BahayNiKuya.java): `game_final/main/BahayNiKuya.java`

### Earlier Version

- [Earlier Game](https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/BahayNiKuyaV3.java): `BahayNiKuyaV3.java`
- [Earlier Room Investigation](https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/BahayNiKuyaV3.java): `BahayNiKuyaV3.java`
- [Earlier Progression State](https://github.com/jo-mag07/bahay-ni-kuya-murder-mystery/blob/main/BahayNiKuyaV3.java): `BahayNiKuyaV3.java`

### Other components

- **Player**

## Connections

- Player → Game Startup: starts
- Game Startup → Living Room Hub: opens menu (evidence: `game_final/main/BahayNiKuya.java`)
- Living Room Hub → Room Navigation: opens locations (evidence: `game_final/main/BahayNiKuya.java`)
- Player → Living Room Hub: chooses options
- Player → Room Investigation: investigates
- Room Investigation → Riddle Answers: checks answers (evidence: `game_final/main/BahayNiKuya.java`)
- Room Investigation → Clue Inventory: adds clues (evidence: `game_final/main/BahayNiKuya.java`)
- Room Investigation → Keys and Locks: updates access (evidence: `game_final/main/BahayNiKuya.java`)
- Keys and Locks → Final Discovery: unlocks entrance (evidence: `game_final/main/BahayNiKuya.java`)
- Player → Earlier Game: starts earlier version
- Earlier Game → Earlier Room Investigation: dispatches investigation (evidence: `BahayNiKuyaV3.java`)
- Earlier Room Investigation → Earlier Progression State: updates state (evidence: `BahayNiKuyaV3.java`)
