How itsvqt/liars-dice works
This is a terminal Liar’s Dice game for one human and configurable AI opponents. The main workflow is setup, dice rolls, rotating bids and challenges, rule-based resolution, player elimination, and winner display. The graph preserves the distinct game, turn-order, rules, player/AI, and terminal-UI responsibilities. Relationships are based on excerpts, the SOURCE INDEX, and README; unsampled implementation details are not inferred.
Main entry points: game.py Game loop · player.py Player state · terminal.py Terminal UI · player_circle.py Turn circle
Components 14
Game entry
- Game launcher
source/main.py
Game orchestration
- Game loop
source/engine/game.py - Game rules
source/engine/rules.py - Turn circle
source/engine/player_circle.py - Game settings
source/utility/constants.py - Input parsing
source/utility/type_parsing.py
Players and turns
- Player state
source/models/player/base/player.py - Human player
source/models/player/human_player.py - Bot strategy
source/models/player/ai_player.py
Terminal interface
- UI contract
source/ui/base/ui.py - Terminal UI
source/ui/terminal.py
Other components
- Human player
Connections 22
- Game launcher → Terminal UI: creates
source/main.py - Game launcher → Game loop: starts
source/main.py - Game loop → UI contract: requests and reports
source/engine/game.py - Terminal UI → UI contract: implements
source/ui/terminal.py - Human player → Terminal UI: provides choices
source/ui/terminal.py - Game loop → Game settings: reads settings
source/engine/game.py - Game loop → Turn circle: manages turns
source/engine/game.py - Game loop → Game rules: checks outcomes
source/engine/game.py - Game loop → Bot strategy: creates and queries
source/engine/game.py - Game loop → Human player: creates
source/engine/game.py - Game loop → Bid model: validates bids
source/engine/game.py - Bot strategy → Bid model: constructs bids
source/models/player/ai_player.py - Game rules → Bid model: compares bids
source/engine/rules.py - Game rules → Turn circle: checks game end
source/engine/rules.py - Turn circle → Player state: rotates players
source/engine/player_circle.py - Turn circle → Game settings: checks player limits
source/engine/player_circle.py - Player state → Die model: rolls dice
source/models/player/base/player.py - Player state → Game settings: sets hand size
source/models/player/base/player.py - Human player → Player state: inherits state
source/models/player/human_player.py - Bot strategy → Player state: uses player state
source/models/player/ai_player.py - Terminal UI → Bid model: displays bids
source/ui/terminal.py - Terminal UI → Player state: displays player state
source/ui/terminal.py