How bfur64/tetrue-lite works
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: GameManager.java Game Manager · GameLoop.java Game Loop · EventBus.java Event Bus · App.java Menu and Options
Components 23
App and Loop
- Menu and Options
app/src/main/java/io/github/bfur64/tetrue/App.java - Game Settings
app/src/main/java/io/github/bfur64/tetrue/Config.java - Game Loop
app/src/main/java/io/github/bfur64/tetrue/game/GameLoop.java - Game Renderer
app/src/main/java/io/github/bfur64/tetrue/game/GameRenderer.java
Game Core
- Game Manager
app/src/main/java/io/github/bfur64/tetrue/game/GameManager.java - Entity World
app/src/main/java/io/github/bfur64/tetrue/game/World.java - Block Components
app/src/main/java/io/github/bfur64/tetrue/game/component/Position.java
Blocks and Grid
- Block Factory
app/src/main/java/io/github/bfur64/tetrue/game/block/BlockFactory.java - Piece Definitions
app/src/main/java/io/github/bfur64/tetrue/game/block/BlockTemplate.java - Board Grid
app/src/main/java/io/github/bfur64/tetrue/game/grid/GridData.java - Grid Reader
app/src/main/java/io/github/bfur64/tetrue/game/grid/GridReader.java - Grid Writer
app/src/main/java/io/github/bfur64/tetrue/game/grid/GridWriter.java
Gameplay Systems
- Piece Lifecycle
app/src/main/java/io/github/bfur64/tetrue/game/system/lifecycle - Movement and Collision
app/src/main/java/io/github/bfur64/tetrue/game/system/movement - Gravity and Lock
app/src/main/java/io/github/bfur64/tetrue/game/system/timing - Line Clearing
app/src/main/java/io/github/bfur64/tetrue/game/system/gameplay/LineClearSystem.java - Scoring and Game Over
app/src/main/java/io/github/bfur64/tetrue/game/system/gameplay/ScoreTrackerSystem.java - Ghost and Sound
app/src/main/java/io/github/bfur64/tetrue/game/system/presentation
Communication and Rules
- Event Bus
app/src/main/java/io/github/bfur64/tetrue/game/EventBus.java - Game Queries
app/src/main/java/io/github/bfur64/tetrue/game/query - SRS Rotation Data
app/src/main/java/io/github/bfur64/tetrue/game/utils/SrsData.java
Other components
- Player
- Terminal
Connections 31
- Player → Menu and Options: chooses options
- Menu and Options → Game Settings: configures
app/src/main/java/io/github/bfur64/tetrue/App.java - Menu and Options → Game Loop: starts game
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
app/src/main/java/io/github/bfur64/tetrue/game/GameManager.java - Game Manager → Event Bus: uses
app/src/main/java/io/github/bfur64/tetrue/game/GameManager.java - Game Manager → Piece Lifecycle: initializes
app/src/main/java/io/github/bfur64/tetrue/game/GameManager.java - Game Manager → Movement and Collision: initializes
app/src/main/java/io/github/bfur64/tetrue/game/GameManager.java - Game Manager → Gravity and Lock: initializes
app/src/main/java/io/github/bfur64/tetrue/game/GameManager.java - Game Manager → Line Clearing: initializes
app/src/main/java/io/github/bfur64/tetrue/game/GameManager.java - Game Manager → Scoring and Game Over: initializes
app/src/main/java/io/github/bfur64/tetrue/game/GameManager.java - Game Manager → Ghost and Sound: initializes
app/src/main/java/io/github/bfur64/tetrue/game/GameManager.java - Piece Lifecycle → Block Factory: creates pieces
- Block Factory → Entity World: stores components
app/src/main/java/io/github/bfur64/tetrue/game/block/BlockFactory.java - Block Components → Entity World: stored in
app/src/main/java/io/github/bfur64/tetrue/game/World.java - Movement and Collision → Game Queries: dispatches queries
app/src/main/java/io/github/bfur64/tetrue/game/system/movement/CollisionSystem.java - Movement and Collision → Grid Reader: checks board
app/src/main/java/io/github/bfur64/tetrue/game/system/movement/CollisionSystem.java - Grid Reader → Board Grid: reads cells
app/src/main/java/io/github/bfur64/tetrue/game/grid/GridData.java - Piece Lifecycle → Grid Writer: writes placed pieces
app/src/main/java/io/github/bfur64/tetrue/game/system/lifecycle/BlockPlaceSystem.java - Grid Writer → Board Grid: updates cells
app/src/main/java/io/github/bfur64/tetrue/game/grid/GridData.java - Gravity and Lock → Event Bus: publishes events
app/src/main/java/io/github/bfur64/tetrue/game/system/timing/GravityTimerSystem.java - Line Clearing → Event Bus: publishes events
app/src/main/java/io/github/bfur64/tetrue/game/system/gameplay/LineClearSystem.java - Event Bus → Ghost and Sound: notifies listeners
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
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