# giovanni-deleon/bit-bandits architecture

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

- Interactive diagram: https://gitdiagram.com/giovanni-deleon/bit-bandits
- Repository: https://github.com/giovanni-deleon/bit-bandits

## Overview

Bit Bandits Hack is a JavaFX vault-heist game. The player rotates the safe dial to enter its combination, picks the lock by dragging the pick across three targets, then navigates a laser room; the laser controller handles movement, collision, lives, and win/loss overlays. The sampled controllers show the first two scene transitions and the laser-game behavior. The README provides no further capability details, and the laser scene resource is not present in the supplied tree, so that view link is not asserted.

Main entry points: [`src/main/java/vault/crack/bit_bandits_hack/LaserHeistController.java`](https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/java/vault/crack/bit_bandits_hack/LaserHeistController.java) (Laser heist), [`src/main/java/vault/crack/bit_bandits_hack/LockPickController.java`](https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/java/vault/crack/bit_bandits_hack/LockPickController.java) (Lock picking), [`src/main/java/vault/crack/bit_bandits_hack/GameController.java`](https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/java/vault/crack/bit_bandits_hack/GameController.java) (Safe dial), [`src/main/java/vault/crack/bit_bandits_hack/Launcher.java`](https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/java/vault/crack/bit_bandits_hack/Launcher.java) (Launcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Application startup"]
  node_launcher["Launcher<br/>[Launcher.java]"]
  node_application["Application startup"]
end

subgraph group_vault["Vault entry"]
  node_safe["Safe dial"]
  node_lockpick["Lock picking"]
end

subgraph group_heist["Heist gameplay"]
  node_laser["Laser heist"]
end

subgraph group_views["JavaFX views"]
  node_welcome["Welcome demo"]
  node_first_view["Safe view<br/>[first-level.fxml]"]
  node_lock_view["Lock view<br/>[lock-pick.fxml]"]
  node_second_view["Second-level view<br/>[second-level.fxml]"]
  node_win_view["Win screen<br/>[win-screen.fxml]"]
  node_lose_view["Loss screen<br/>[lose-screen.fxml]"]
  node_hello_view["Welcome view<br/>[hello-view.fxml]"]
end

node_player(("Player"))

node_player -->|"starts"| node_launcher
node_launcher -->|"launches"| node_application
node_application -->|"loads"| node_first_view
node_first_view -.->|"binds controller"| node_safe
node_safe -->|"loads"| node_lock_view
node_lock_view -.->|"binds controller"| node_lockpick
node_lockpick -->|"loads scene"| node_laser
node_lockpick -->|"accepts drag input"| node_player
node_player -->|"rotates dial"| node_safe
node_player -->|"drags pick"| node_lockpick
node_laser -->|"moves and checks hits"| node_player
node_laser -.->|"shows win overlay"| node_win_view
node_laser -.->|"shows loss overlay"| node_lose_view
node_hello_view -.->|"binds controller"| node_welcome
node_second_view -.->|"possible game view"| node_laser

click node_launcher "https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/java/vault/crack/bit_bandits_hack/Launcher.java"
click node_application "https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/java/vault/crack/bit_bandits_hack/HelloApplication.java"
click node_safe "https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/java/vault/crack/bit_bandits_hack/GameController.java"
click node_lockpick "https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/java/vault/crack/bit_bandits_hack/LockPickController.java"
click node_laser "https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/java/vault/crack/bit_bandits_hack/LaserHeistController.java"
click node_welcome "https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/java/vault/crack/bit_bandits_hack/HelloController.java"
click node_first_view "https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/resources/view/first-level.fxml"
click node_lock_view "https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/resources/view/lock-pick.fxml"
click node_second_view "https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/resources/view/second-level.fxml"
click node_win_view "https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/resources/view/win-screen.fxml"
click node_lose_view "https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/resources/view/lose-screen.fxml"
click node_hello_view "https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/resources/vault/crack/bit_bandits_hack/hello-view.fxml"

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_launcher,node_application toneBlue
class node_safe,node_lockpick toneAmber
class node_laser toneMint
class node_welcome,node_first_view,node_lock_view,node_second_view,node_win_view,node_lose_view,node_hello_view toneRose
class node_player toneIndigo
```

## Components

### Application startup

- [Launcher](https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/java/vault/crack/bit_bandits_hack/Launcher.java): `src/main/java/vault/crack/bit_bandits_hack/Launcher.java`
- [Application startup](https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/java/vault/crack/bit_bandits_hack/HelloApplication.java): `src/main/java/vault/crack/bit_bandits_hack/HelloApplication.java`

### Vault entry

- [Safe dial](https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/java/vault/crack/bit_bandits_hack/GameController.java): `src/main/java/vault/crack/bit_bandits_hack/GameController.java`
- [Lock picking](https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/java/vault/crack/bit_bandits_hack/LockPickController.java): `src/main/java/vault/crack/bit_bandits_hack/LockPickController.java`

### Heist gameplay

- [Laser heist](https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/java/vault/crack/bit_bandits_hack/LaserHeistController.java): `src/main/java/vault/crack/bit_bandits_hack/LaserHeistController.java`

### JavaFX views

- [Welcome demo](https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/java/vault/crack/bit_bandits_hack/HelloController.java): `src/main/java/vault/crack/bit_bandits_hack/HelloController.java`
- [Safe view](https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/resources/view/first-level.fxml): `src/main/resources/view/first-level.fxml`
- [Lock view](https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/resources/view/lock-pick.fxml): `src/main/resources/view/lock-pick.fxml`
- [Second-level view](https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/resources/view/second-level.fxml): `src/main/resources/view/second-level.fxml`
- [Win screen](https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/resources/view/win-screen.fxml): `src/main/resources/view/win-screen.fxml`
- [Loss screen](https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/resources/view/lose-screen.fxml): `src/main/resources/view/lose-screen.fxml`
- [Welcome view](https://github.com/giovanni-deleon/bit-bandits/blob/main/src/main/resources/vault/crack/bit_bandits_hack/hello-view.fxml): `src/main/resources/vault/crack/bit_bandits_hack/hello-view.fxml`

### Other components

- **Player**

## Connections

- Player → Launcher: starts (evidence: `src/main/java/vault/crack/bit_bandits_hack/Launcher.java`)
- Launcher → Application startup: launches (evidence: `src/main/java/vault/crack/bit_bandits_hack/Launcher.java`)
- Application startup → Safe view: loads (evidence: `src/main/java/vault/crack/bit_bandits_hack/HelloApplication.java`)
- Safe view → Safe dial: binds controller
- Safe dial → Lock view: loads (evidence: `src/main/java/vault/crack/bit_bandits_hack/GameController.java`)
- Lock view → Lock picking: binds controller
- Lock picking → Laser heist: loads scene (evidence: `src/main/java/vault/crack/bit_bandits_hack/LockPickController.java`)
- Lock picking → Player: accepts drag input (evidence: `src/main/java/vault/crack/bit_bandits_hack/LockPickController.java`)
- Player → Safe dial: rotates dial (evidence: `src/main/java/vault/crack/bit_bandits_hack/GameController.java`)
- Player → Lock picking: drags pick (evidence: `src/main/java/vault/crack/bit_bandits_hack/LockPickController.java`)
- Laser heist → Player: moves and checks hits (evidence: `src/main/java/vault/crack/bit_bandits_hack/LaserHeistController.java`)
- Laser heist → Win screen: shows win overlay
- Laser heist → Loss screen: shows loss overlay
- Welcome view → Welcome demo: binds controller
- Second-level view → Laser heist: possible game view
