# mcgarity99/reversi-game architecture

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

- Interactive diagram: https://gitdiagram.com/mcgarity99/reversi-game
- Repository: https://github.com/mcgarity99/reversi-game

## Overview

Reversi is a JavaFX Othello game. A player uses the game interface to play a two-player match or, optionally, against random-select AI; the game also supports changing piece colors and showing or hiding potential moves. The sampled code places the interface and game behavior in one large class, so those responsibilities share a source path. The excerpts show color configuration and move-related logic, but not enough call sites to map the complete move-to-score workflow; relationships between those internal stages are therefore omitted.

Main entry points: [`Reversi/src/ReversiGame/Reversi.java`](https://github.com/mcgarity99/reversi-game/blob/master/Reversi/src/ReversiGame/Reversi.java) (Game interface and rules), [`Reversi/src/ReversiGame/ColorPackage.java`](https://github.com/mcgarity99/reversi-game/blob/master/Reversi/src/ReversiGame/ColorPackage.java) (Color mapping), [`Reversi/src/ReversiGame/ReversiDriver.java`](https://github.com/mcgarity99/reversi-game/blob/master/Reversi/src/ReversiGame/ReversiDriver.java) (Game launcher), [`Reversi/src/ReversiGame/PieceColor.java`](https://github.com/mcgarity99/reversi-game/blob/master/Reversi/src/ReversiGame/PieceColor.java) (Piece color options)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gameplay["Gameplay"]
  node_driver["Game launcher<br/>[ReversiDriver.java]"]
  node_game["Game interface and rules<br/>[Reversi.java]"]
  node_ai["Random-select AI<br/>[Reversi.java]"]
  node_move_hints["Potential move hints<br/>[Reversi.java]"]
  node_player_id["Player identifiers<br/>[PlayerID.java]"]
end

subgraph group_presentation["Presentation"]
  node_color_ui["Color customization<br/>[Reversi.java]"]
  node_color_package["Color mapping<br/>[ColorPackage.java]"]
  node_piece_color["Piece color options<br/>[PieceColor.java]"]
end

node_player(("Player"))

node_driver -->|"creates"| node_game
node_game -->|"uses"| node_color_package
node_color_package -->|"maps"| node_piece_color

click node_driver "https://github.com/mcgarity99/reversi-game/blob/master/Reversi/src/ReversiGame/ReversiDriver.java"
click node_game "https://github.com/mcgarity99/reversi-game/blob/master/Reversi/src/ReversiGame/Reversi.java"
click node_ai "https://github.com/mcgarity99/reversi-game/blob/master/Reversi/src/ReversiGame/Reversi.java"
click node_move_hints "https://github.com/mcgarity99/reversi-game/blob/master/Reversi/src/ReversiGame/Reversi.java"
click node_color_ui "https://github.com/mcgarity99/reversi-game/blob/master/Reversi/src/ReversiGame/Reversi.java"
click node_color_package "https://github.com/mcgarity99/reversi-game/blob/master/Reversi/src/ReversiGame/ColorPackage.java"
click node_piece_color "https://github.com/mcgarity99/reversi-game/blob/master/Reversi/src/ReversiGame/PieceColor.java"
click node_player_id "https://github.com/mcgarity99/reversi-game/blob/master/Reversi/src/ReversiGame/PlayerID.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_driver,node_game,node_ai,node_move_hints,node_player_id toneBlue
class node_color_ui,node_color_package,node_piece_color toneAmber
class node_player toneIndigo
```

## Components

### Gameplay

- [Game launcher](https://github.com/mcgarity99/reversi-game/blob/master/Reversi/src/ReversiGame/ReversiDriver.java): `Reversi/src/ReversiGame/ReversiDriver.java`
- [Game interface and rules](https://github.com/mcgarity99/reversi-game/blob/master/Reversi/src/ReversiGame/Reversi.java): `Reversi/src/ReversiGame/Reversi.java`
- [Random-select AI](https://github.com/mcgarity99/reversi-game/blob/master/Reversi/src/ReversiGame/Reversi.java): `Reversi/src/ReversiGame/Reversi.java`
- [Potential move hints](https://github.com/mcgarity99/reversi-game/blob/master/Reversi/src/ReversiGame/Reversi.java): `Reversi/src/ReversiGame/Reversi.java`
- [Player identifiers](https://github.com/mcgarity99/reversi-game/blob/master/Reversi/src/ReversiGame/PlayerID.java): `Reversi/src/ReversiGame/PlayerID.java`

### Presentation

- [Color customization](https://github.com/mcgarity99/reversi-game/blob/master/Reversi/src/ReversiGame/Reversi.java): `Reversi/src/ReversiGame/Reversi.java`
- [Color mapping](https://github.com/mcgarity99/reversi-game/blob/master/Reversi/src/ReversiGame/ColorPackage.java): `Reversi/src/ReversiGame/ColorPackage.java`
- [Piece color options](https://github.com/mcgarity99/reversi-game/blob/master/Reversi/src/ReversiGame/PieceColor.java): `Reversi/src/ReversiGame/PieceColor.java`

### Other components

- **Player**

## Connections

- Game launcher → Game interface and rules: creates (evidence: `Reversi/src/ReversiGame/ReversiDriver.java`)
- Game interface and rules → Color mapping: uses (evidence: `Reversi/src/ReversiGame/Reversi.java`)
- Color mapping → Piece color options: maps (evidence: `Reversi/src/ReversiGame/ColorPackage.java`)
