How abinjoyal/snake-game works
This is a Pygame Snake game. Players choose a mode and map, play a solo, local-versus, or AI match, then reach game-over, submit scores, and review achievements or rankings. The runtime centers on the main loop and GameState, with distinct snake/AI, food, collision, and map-building stages. The README documents several capabilities whose implementation was not sampled; these are represented without guessing their internal call paths. Edges reflect shown calls or source-index references; unsampled feature wiring is omitted.
Main entry points: game_state.py Game state · main.py Game loop · menu.py Mode menu · settings_screen.py Settings screen
Components 20
Game runtime
- Game loop
main.py - Game settings
settings.py - Game state
game/game_state.py
Gameplay systems
- Snake
game/snake.py - AI opponent
game/ai_snake.py - Food variants
game/food.py - Collision checks
game/collision.py
Screens and controls
- Mode menu
ui/menu.py - UI components
ui/components.py - Settings screen
ui/settings_screen.py - Map builder
ui/map_builder_screen.py - Skin gallery
ui/skins_screen.py - Game over
ui/game_over.py - Leaderboard screen
ui/leaderboard_screen.py - Achievement gallery
ui/achievements_screen.py
Progress and feedback
- Score manager
game/leaderboard.py - Achievement manager
game/achievements.py - Sound manager
game/sound_manager.py - Particles and shake
game/particle.py
Other components
- Player
Connections 28
- Player → Game loop: starts game
README.md - Game loop → Mode menu: updates screen
main.py - Mode menu → Game state: starts match
ui/menu.py - Game loop → Game state: dispatches input
main.py - Game loop → Collision checks: checks collisions
main.py - Game state → Snake: manages
game/game_state.py - Game state → AI opponent: manages
game/game_state.py - Game state → Food variants: manages
game/game_state.py - Game state → Sound manager: initializes
game/game_state.py - Game state → Score manager: initializes
game/game_state.py - Game state → Particles and shake: initializes
game/game_state.py - Game state → Achievement manager: initializes
game/game_state.py - Game over → Score manager: saves score
ui/game_over.py - Skin gallery → Game state: sets skin
ui/skins_screen.py - Settings screen → Game state: changes options
ui/settings_screen.py - Map builder → Game settings: uses map path
ui/map_builder_screen.py - Achievement gallery → Achievement manager: reads achievements
ui/achievements_screen.py - Leaderboard screen → Score manager: shows rankings
ui/leaderboard_screen.py - Game loop → Game over: routes screen
main.py - Game loop → Settings screen: routes screen
main.py - Game loop → Skin gallery: routes screen
main.py - Game loop → Leaderboard screen: routes screen
main.py - Game loop → Achievement gallery: routes screen
main.py - Game loop → Map builder: routes screen
main.py - Mode menu → UI components: uses widgets
ui/menu.py - Game over → UI components: uses widgets
ui/game_over.py - Settings screen → Sound manager: toggles audio
ui/settings_screen.py - Game state → Game settings: uses configuration
game/game_state.py