# bfur64/tetrue-lite architecture

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

- Interactive diagram: https://gitdiagram.com/bfur64/tetrue-lite
- Repository: https://github.com/bfur64/tetrue-lite

## Overview

Tetrue Lite is a terminal Tetris game. A user enters through the menu, configures controls and gameplay options, starts a game, then moves, rotates, drops, and holds falling pieces until placement, line clearing, scoring, or game over. The game loop and GameManager coordinate systems around shared world state; events and queries support system communication. The README documents the system architecture and feature set, but most runtime files were not excerpted, so unverified subsystem links are dashed.

Main entry points: [`app/src/main/java/io/github/bfur64/tetrue/game/GameManager.java`](https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/GameManager.java) (Game Manager), [`app/src/main/java/io/github/bfur64/tetrue/game/GameLoop.java`](https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/GameLoop.java) (Game Loop), [`app/src/main/java/io/github/bfur64/tetrue/game/EventBus.java`](https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/EventBus.java) (Event Bus), [`app/src/main/java/io/github/bfur64/tetrue/App.java`](https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/App.java) (Menu and Options)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App and Loop"]
  node_app["Menu and Options<br/>[App.java]"]
  node_config["Game Settings<br/>[Config.java]"]
  node_loop["Game Loop<br/>[GameLoop.java]"]
  node_renderer["Game Renderer<br/>[GameRenderer.java]"]
end

subgraph group_core["Game Core"]
  node_manager["Game Manager<br/>[GameManager.java]"]
  node_world[("Entity World<br/>[World.java]")]
  node_components["Block Components<br/>[Position.java]"]
end

subgraph group_blocks["Blocks and Grid"]
  node_blockfactory["Block Factory<br/>[BlockFactory.java]"]
  node_blockdefs["Piece Definitions<br/>[BlockTemplate.java]"]
  node_grid[("Board Grid<br/>[GridData.java]")]
  node_gridreader["Grid Reader<br/>[GridReader.java]"]
  node_gridwriter["Grid Writer<br/>[GridWriter.java]"]
end

subgraph group_systems["Gameplay Systems"]
  node_lifecycle["Piece Lifecycle"]
  node_movement["Movement and Collision"]
  node_timing["Gravity and Lock"]
  node_lineclear["Line Clearing"]
  node_scoring["Scoring and Game Over"]
  node_presentation["Ghost and Sound"]
end

subgraph group_support["Communication and Rules"]
  node_eventbus["Event Bus<br/>[EventBus.java]"]
  node_queries["Game Queries"]
  node_rotation["SRS Rotation Data<br/>[SrsData.java]"]
end

node_player(("Player"))
node_terminal["Terminal"]

node_player -->|"chooses options"| node_app
node_app -.->|"configures"| node_config
node_app -->|"starts game"| node_loop
node_terminal -.->|"provides interface"| node_app
node_loop -->|"updates"| node_manager
node_loop -->|"updates"| node_renderer
node_loop -->|"creates"| node_eventbus
node_loop -->|"creates"| node_world
node_manager -->|"uses"| node_world
node_manager -->|"uses"| node_eventbus
node_manager -->|"initializes"| node_lifecycle
node_manager -->|"initializes"| node_movement
node_manager -->|"initializes"| node_timing
node_manager -->|"initializes"| node_lineclear
node_manager -->|"initializes"| node_scoring
node_manager -->|"initializes"| node_presentation
node_lifecycle -.->|"creates pieces"| node_blockfactory
node_blockfactory -->|"stores components"| node_world
node_components -->|"stored in"| node_world
node_movement -.->|"dispatches queries"| node_queries
node_movement -->|"checks board"| node_gridreader
node_gridreader -->|"reads cells"| node_grid
node_lifecycle -->|"writes placed pieces"| node_gridwriter
node_gridwriter -->|"updates cells"| node_grid
node_timing -->|"publishes events"| node_eventbus
node_lineclear -.->|"publishes events"| node_eventbus
node_eventbus -.->|"notifies listeners"| node_presentation
node_lineclear -.->|"updates score"| node_scoring
node_rotation -.->|"supplies SRS kicks"| node_movement
node_blockdefs -->|"defines piece shapes"| node_blockfactory
node_grid -.->|"renders board"| node_renderer

click node_app "https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/App.java"
click node_config "https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/Config.java"
click node_loop "https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/GameLoop.java"
click node_renderer "https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/GameRenderer.java"
click node_manager "https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/GameManager.java"
click node_world "https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/World.java"
click node_components "https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/component/Position.java"
click node_blockfactory "https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/block/BlockFactory.java"
click node_blockdefs "https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/block/BlockTemplate.java"
click node_grid "https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/grid/GridData.java"
click node_gridreader "https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/grid/GridReader.java"
click node_gridwriter "https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/grid/GridWriter.java"
click node_lifecycle "https://github.com/bfur64/tetrue-lite/tree/main/app/src/main/java/io/github/bfur64/tetrue/game/system/lifecycle"
click node_movement "https://github.com/bfur64/tetrue-lite/tree/main/app/src/main/java/io/github/bfur64/tetrue/game/system/movement"
click node_timing "https://github.com/bfur64/tetrue-lite/tree/main/app/src/main/java/io/github/bfur64/tetrue/game/system/timing"
click node_lineclear "https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/system/gameplay/LineClearSystem.java"
click node_scoring "https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/system/gameplay/ScoreTrackerSystem.java"
click node_presentation "https://github.com/bfur64/tetrue-lite/tree/main/app/src/main/java/io/github/bfur64/tetrue/game/system/presentation"
click node_eventbus "https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/EventBus.java"
click node_queries "https://github.com/bfur64/tetrue-lite/tree/main/app/src/main/java/io/github/bfur64/tetrue/game/query"
click node_rotation "https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/utils/SrsData.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_app,node_config,node_loop,node_renderer toneBlue
class node_manager,node_world,node_components toneAmber
class node_blockfactory,node_blockdefs,node_grid,node_gridreader,node_gridwriter toneMint
class node_lifecycle,node_movement,node_timing,node_lineclear,node_scoring,node_presentation toneRose
class node_eventbus,node_queries,node_rotation,node_player,node_terminal toneIndigo
```

## Components

### App and Loop

- [Menu and Options](https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/App.java): `app/src/main/java/io/github/bfur64/tetrue/App.java`
- [Game Settings](https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/Config.java): `app/src/main/java/io/github/bfur64/tetrue/Config.java`
- [Game Loop](https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/GameLoop.java): `app/src/main/java/io/github/bfur64/tetrue/game/GameLoop.java`
- [Game Renderer](https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/GameRenderer.java): `app/src/main/java/io/github/bfur64/tetrue/game/GameRenderer.java`

### Game Core

- [Game Manager](https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/GameManager.java): `app/src/main/java/io/github/bfur64/tetrue/game/GameManager.java`
- [Entity World](https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/World.java): `app/src/main/java/io/github/bfur64/tetrue/game/World.java`
- [Block Components](https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/component/Position.java): `app/src/main/java/io/github/bfur64/tetrue/game/component/Position.java`

### Blocks and Grid

- [Block Factory](https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/block/BlockFactory.java): `app/src/main/java/io/github/bfur64/tetrue/game/block/BlockFactory.java`
- [Piece Definitions](https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/block/BlockTemplate.java): `app/src/main/java/io/github/bfur64/tetrue/game/block/BlockTemplate.java`
- [Board Grid](https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/grid/GridData.java): `app/src/main/java/io/github/bfur64/tetrue/game/grid/GridData.java`
- [Grid Reader](https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/grid/GridReader.java): `app/src/main/java/io/github/bfur64/tetrue/game/grid/GridReader.java`
- [Grid Writer](https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/grid/GridWriter.java): `app/src/main/java/io/github/bfur64/tetrue/game/grid/GridWriter.java`

### Gameplay Systems

- [Piece Lifecycle](https://github.com/bfur64/tetrue-lite/tree/main/app/src/main/java/io/github/bfur64/tetrue/game/system/lifecycle): `app/src/main/java/io/github/bfur64/tetrue/game/system/lifecycle`
- [Movement and Collision](https://github.com/bfur64/tetrue-lite/tree/main/app/src/main/java/io/github/bfur64/tetrue/game/system/movement): `app/src/main/java/io/github/bfur64/tetrue/game/system/movement`
- [Gravity and Lock](https://github.com/bfur64/tetrue-lite/tree/main/app/src/main/java/io/github/bfur64/tetrue/game/system/timing): `app/src/main/java/io/github/bfur64/tetrue/game/system/timing`
- [Line Clearing](https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/system/gameplay/LineClearSystem.java): `app/src/main/java/io/github/bfur64/tetrue/game/system/gameplay/LineClearSystem.java`
- [Scoring and Game Over](https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/system/gameplay/ScoreTrackerSystem.java): `app/src/main/java/io/github/bfur64/tetrue/game/system/gameplay/ScoreTrackerSystem.java`
- [Ghost and Sound](https://github.com/bfur64/tetrue-lite/tree/main/app/src/main/java/io/github/bfur64/tetrue/game/system/presentation): `app/src/main/java/io/github/bfur64/tetrue/game/system/presentation`

### Communication and Rules

- [Event Bus](https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/EventBus.java): `app/src/main/java/io/github/bfur64/tetrue/game/EventBus.java`
- [Game Queries](https://github.com/bfur64/tetrue-lite/tree/main/app/src/main/java/io/github/bfur64/tetrue/game/query): `app/src/main/java/io/github/bfur64/tetrue/game/query`
- [SRS Rotation Data](https://github.com/bfur64/tetrue-lite/blob/main/app/src/main/java/io/github/bfur64/tetrue/game/utils/SrsData.java): `app/src/main/java/io/github/bfur64/tetrue/game/utils/SrsData.java`

### Other components

- **Player**
- **Terminal**

## Connections

- Player → Menu and Options: chooses options
- Menu and Options → Game Settings: configures (evidence: `app/src/main/java/io/github/bfur64/tetrue/App.java`)
- Menu and Options → Game Loop: starts game (evidence: `app/src/main/java/io/github/bfur64/tetrue/App.java`)
- Terminal → Menu and Options: provides interface
- Game Loop → Game Manager: updates
- Game Loop → Game Renderer: updates
- Game Loop → Event Bus: creates
- Game Loop → Entity World: creates
- Game Manager → Entity World: uses (evidence: `app/src/main/java/io/github/bfur64/tetrue/game/GameManager.java`)
- Game Manager → Event Bus: uses (evidence: `app/src/main/java/io/github/bfur64/tetrue/game/GameManager.java`)
- Game Manager → Piece Lifecycle: initializes (evidence: `app/src/main/java/io/github/bfur64/tetrue/game/GameManager.java`)
- Game Manager → Movement and Collision: initializes (evidence: `app/src/main/java/io/github/bfur64/tetrue/game/GameManager.java`)
- Game Manager → Gravity and Lock: initializes (evidence: `app/src/main/java/io/github/bfur64/tetrue/game/GameManager.java`)
- Game Manager → Line Clearing: initializes (evidence: `app/src/main/java/io/github/bfur64/tetrue/game/GameManager.java`)
- Game Manager → Scoring and Game Over: initializes (evidence: `app/src/main/java/io/github/bfur64/tetrue/game/GameManager.java`)
- Game Manager → Ghost and Sound: initializes (evidence: `app/src/main/java/io/github/bfur64/tetrue/game/GameManager.java`)
- Piece Lifecycle → Block Factory: creates pieces
- Block Factory → Entity World: stores components (evidence: `app/src/main/java/io/github/bfur64/tetrue/game/block/BlockFactory.java`)
- Block Components → Entity World: stored in (evidence: `app/src/main/java/io/github/bfur64/tetrue/game/World.java`)
- Movement and Collision → Game Queries: dispatches queries (evidence: `app/src/main/java/io/github/bfur64/tetrue/game/system/movement/CollisionSystem.java`)
- Movement and Collision → Grid Reader: checks board (evidence: `app/src/main/java/io/github/bfur64/tetrue/game/system/movement/CollisionSystem.java`)
- Grid Reader → Board Grid: reads cells (evidence: `app/src/main/java/io/github/bfur64/tetrue/game/grid/GridData.java`)
- Piece Lifecycle → Grid Writer: writes placed pieces (evidence: `app/src/main/java/io/github/bfur64/tetrue/game/system/lifecycle/BlockPlaceSystem.java`)
- Grid Writer → Board Grid: updates cells (evidence: `app/src/main/java/io/github/bfur64/tetrue/game/grid/GridData.java`)
- Gravity and Lock → Event Bus: publishes events (evidence: `app/src/main/java/io/github/bfur64/tetrue/game/system/timing/GravityTimerSystem.java`)
- Line Clearing → Event Bus: publishes events (evidence: `app/src/main/java/io/github/bfur64/tetrue/game/system/gameplay/LineClearSystem.java`)
- Event Bus → Ghost and Sound: notifies listeners (evidence: `app/src/main/java/io/github/bfur64/tetrue/game/system/presentation/GhostBlockSystem.java`)
- Line Clearing → Scoring and Game Over: updates score
- SRS Rotation Data → Movement and Collision: supplies SRS kicks (evidence: `app/src/main/java/io/github/bfur64/tetrue/game/system/movement/CollisionSystem.java`)
- Piece Definitions → Block Factory: defines piece shapes
- Board Grid → Game Renderer: renders board
