Feat: Add spacebar pause, resume, and countdown flow to Snake

Author: AQUA1310

games/Snake-Game/Snake-Game.py

@@ -1,15 +1,31 @@
 import turtle
 import random
 import time
-# ================= SOUND =================
+
+# ================= SOUND SYSTEM =================
+pygame_installed = False
+eat_sound = None
+gameover_sound = None
+
 try:
     import pygame
     pygame.mixer.init()
-    eat_sound = pygame.mixer.Sound("sounds/eat.wav")
-    gameover_sound = pygame.mixer.Sound("sounds/gameover.wav")
-    pygame_installed = True
+    
+    # Try loading default wav files
+    try:
+        eat_sound = pygame.mixer.Sound("sounds/eat.wav")
+        gameover_sound = pygame.mixer.Sound("sounds/gameover.wav")
+        pygame_installed = True
+    except Exception:
+        # Fallback to alternate mp3 file naming schemes
+        try:
+            eat_sound = pygame.mixer.Sound("sounds/Apple_Eating.mp3")
+            gameover_sound = pygame.mixer.Sound("sounds/Game_over.mp3")
+            pygame_installed = True
+        except Exception:
+            print("⚠️ Warning: Sound files not found in 'sounds/' folder. Game will run silently.")
+            pygame_installed = False
 except ImportError:
-    pygame_installed = False
     print("⚠️ Warning: pygame module not found. Game will run without sound effects.")
 
 
@@ -109,12 +125,13 @@ def generate_food():
 
 generate_food()
 
-# ================= SCORE =================
+# ================= STATE VARIABLES =================
 
 score = 0
 high_score = 0
 level = 1
 speed = 0.05
+game_state = "IDLE" 
 
 score_text = turtle.Turtle()
 score_text.hideturtle()
@@ -132,23 +149,7 @@ def update_score():
 
 update_score()
 
-# ================= PAUSE =================
-
-paused = False
-
-def toggle_pause():
-    global paused
-    paused = not paused
-
-    game_text.clear()
-
-    if paused:
-        game_text.write("PAUSED", align="center", font=("Arial", 24, "bold"))
-
-screen.listen()
-screen.onkeypress(toggle_pause, "p")
-
-# ================= COUNTDOWN =================
+# ================= CONTROL INFRASTRUCTURE =================
 
 def countdown():
     for text in ["3", "2", "1", "GO!"]:
@@ -158,32 +159,62 @@ def countdown():
         time.sleep(1)
     game_text.clear()
 
-countdown()
+def handle_spacebar():
+    global game_state, score, level, speed
+    
+    if game_state == "IDLE":
+        countdown()
+        game_state = "PLAYING"
+        
+    elif game_state == "PLAYING":
+        game_state = "PAUSED"
+        game_text.clear()
+        game_text.write("PAUSED", align="center", font=("Arial", 24, "bold"))
+        
+    elif game_state == "PAUSED":
+        game_state = "PLAYING"
+        game_text.clear()
+        
+    elif game_state == "GAME_OVER":
+        head.goto(0, 0)
+        head.direction = "stop"
+        for p in parts:
+            p.goto(1000, 1000)
+        parts.clear()
+        
+        score = 0
+        level = 1
+        speed = 0.05
+        
+        update_score()
+        countdown()
+        game_state = "PLAYING"
 
-# ================= CONTROLS =================
+screen.listen()
+screen.onkeypress(handle_spacebar, "space")
 
 def move_up():
-    if head.direction != "down":
+    if head.direction != "down" and game_state == "PLAYING":
         head.direction = "up"
 
 def move_down():
-    if head.direction != "up":
+    if head.direction != "up" and game_state == "PLAYING":
         head.direction = "down"
 
 def move_left():
-    if head.direction != "right":
+    if head.direction != "right" and game_state == "PLAYING":
         head.direction = "left"
 
 def move_right():
-    if head.direction != "left":
+    if head.direction != "left" and game_state == "PLAYING":
         head.direction = "right"
 
 screen.onkeypress(move_up, "Up")
 screen.onkeypress(move_down, "Down")
 screen.onkeypress(move_left, "Left")
 screen.onkeypress(move_right, "Right")
 
-# ================= MOVE =================
+# ================= MOVE PHYSICS =================
 
 def move():
     if head.direction == "up":
@@ -195,36 +226,15 @@ def move():
     elif head.direction == "right":
         head.setx(head.xcor() + GRID_SIZE)
 
-# ================= RESET =================
-
-def reset_game():
-    global score, level, speed
-
-    if pygame_installed:
-        gameover_sound.play()
-
-    time.sleep(1)
-
-    head.goto(0, 0)
-    head.direction = "stop"
-
-    for p in parts:
-        p.goto(1000, 1000)
-    parts.clear()
-
-    score = 0
-    level = 1
-    speed = 0.05
-
-    update_score()
-
 # ================= MAIN LOOP =================
 
-while True:
+game_text.write("Press SPACEBAR to Start", align="center", font=("Arial", 24, "bold"))
 
+while True:
     screen.update()
 
-    if paused:
+    if game_state in ["IDLE", "PAUSED", "GAME_OVER"]:
+        time.sleep(0.1)
         continue
 
     # Border collision
@@ -234,24 +244,25 @@ def reset_game():
         head.ycor() > BORDER_LIMIT or
         head.ycor() < -BORDER_LIMIT
     ):
-        reset_game()
+        if pygame_installed and gameover_sound:
+            gameover_sound.play()
+        game_text.write("GAME OVER - Press SPACE to Restart", align="center", font=("Arial", 20, "bold"))
+        game_state = "GAME_OVER"
+        continue
 
     # Food collision
     if head.distance(food) < GRID_SIZE:
-
-        if pygame_installed:
+        if pygame_installed and eat_sound:
             eat_sound.play()
 
         score += current_food["points"]
 
         if score > high_score:
             high_score = score
 
-        # LEVEL SYSTEM
         if score % 5 == 0:
             level += 1
             speed -= 0.005
-
             game_text.clear()
             game_text.write(f"LEVEL {level}", align="center", font=("Arial", 24, "bold"))
             screen.update()
@@ -264,9 +275,7 @@ def reset_game():
         new_part.shape("circle")
         new_part.color("#66FF99")
         new_part.penup()
-
         parts.append(new_part)
-
         update_score()
 
     # Move body
@@ -283,6 +292,13 @@ def reset_game():
     # Self collision
     for p in parts:
         if p.distance(head) < 12:
-            reset_game()
+            if pygame_installed and gameover_sound:
+                gameover_sound.play()
+            game_text.write("GAME OVER - Press SPACE to Restart", align="center", font=("Arial", 20, "bold"))
+            game_state = "GAME_OVER"
+            break
+
+    if game_state == "GAME_OVER":
+        continue
 
-    time.sleep(speed)
+    time.sleep(speed)

games/Snake-Game/main.py

@@ -14,8 +14,7 @@
 
 class SnakeGame:
     def __init__(self):
-        # Game state
-        self.paused = False
+        self.game_state = "IDLE"
         self.delay = SLEEP_TIME
         self.level = 1
 
@@ -33,6 +32,13 @@ def __init__(self):
         self.food = Food()
         self.scoreboard = Scoreboard()
 
+        # Dedicated message text engine (matches the working Snake-game.py pattern)
+        self.game_text = turtle.Turtle()
+        self.game_text.hideturtle()
+        self.game_text.color("white")
+        self.game_text.penup()
+        self.game_text.goto(0, 0)
+
         # Sound setup
         self.pygame_installed = pygame_installed
         if self.pygame_installed:
@@ -50,7 +56,7 @@ def __init__(self):
         self.screen.onkeypress(self.snake.move_down, "Down")
         self.screen.onkeypress(self.snake.move_left, "Left")
         self.screen.onkeypress(self.snake.move_right, "Right")
-        self.screen.onkeypress(self.toggle_pause, "p")   # Pause key
+        self.screen.onkeypress(self.handle_spacebar, "space")
 
     def _draw_borders(self):
         box = turtle.Turtle()
@@ -64,62 +70,70 @@ def _draw_borders(self):
             box.forward(600)
             box.right(90)
 
-    # Countdown before game starts
     def countdown(self):
         for text in ["3", "2", "1", "GO!"]:
-            self.scoreboard.show_message(text)
+            self.game_text.clear()
+            self.game_text.write(text, align="center", font=("Arial", 30, "bold"))
             self.screen.update()
             time.sleep(1)
-
-        self.scoreboard.update_display()
-
-    # Pause toggle
-    def toggle_pause(self):
-        self.paused = not self.paused
-
-        if self.paused:
-            self.scoreboard.show_message("PAUSED")
-        else:
-            self.scoreboard.update_display()
+        self.game_text.clear()
+
+    def handle_spacebar(self):
+        if self.game_state == "IDLE":
+            self.countdown()
+            self.game_state = "PLAYING"
+            
+        elif self.game_state == "PLAYING":
+            self.game_state = "PAUSED"
+            self.game_text.clear()
+            self.game_text.write("PAUSED", align="center", font=("Arial", 24, "bold"))
+            
+        elif self.game_state == "PAUSED":
+            self.game_state = "PLAYING"
+            self.game_text.clear()
+            
+        elif self.game_state == "GAME_OVER":
+            self.snake.reset()
+            self.scoreboard.reset()
+            self.delay = SLEEP_TIME
+            self.level = 1
+            self.countdown()
+            self.game_state = "PLAYING"
 
     def run(self):
-        self.countdown()  # Start countdown
+        self.game_text.write("Press SPACEBAR to Start", align="center", font=("Arial", 24, "bold"))
 
         while True:
             self.screen.update()
 
-            # Pause check
-            if self.paused:
+            if self.game_state in ["IDLE", "PAUSED", "GAME_OVER"]:
+                time.sleep(0.1)
                 continue
 
             # Boundary collision
             if self.snake.check_boundary_collision():
                 if self.pygame_installed:
                     self.gameover_sound.play()
-                self.snake.reset()
-                self.scoreboard.reset()
-                self.delay = SLEEP_TIME
-                self.level = 1
+                self.game_text.write("GAME OVER - Press SPACE to Restart", align="center", font=("Arial", 20, "bold"))
+                self.game_state = "GAME_OVER"
+                continue
 
             # Food collision
             if self.snake.head.distance(self.food.item) < COLLISION_DISTANCE:
                 self.food.reposition(self.snake)
                 self.snake.add_part()
-
                 self.scoreboard.increase()
                 if self.pygame_installed:
                     self.eat_sound.play()
 
-                # Level system
                 if self.scoreboard.score % 5 == 0:
                     self.level += 1
                     self.delay -= 0.01
-
-                    # Optional level message
-                    self.scoreboard.show_message(f"LEVEL {self.level}")
+                    self.game_text.clear()
+                    self.game_text.write(f"LEVEL {self.level}", align="center", font=("Arial", 24, "bold"))
                     self.screen.update()
                     time.sleep(0.5)
-                    self.scoreboard.update_display()
+                    self.game_text.clear()
 
             # Move snake
             self.snake.move()
@@ -128,12 +142,10 @@ def run(self):
             if self.snake.check_self_collision():
                 if self.pygame_installed:
                     self.gameover_sound.play()
-                self.snake.reset()
-                self.scoreboard.reset()
-                self.delay = SLEEP_TIME
-                self.level = 1
+                self.game_text.write("GAME OVER - Press SPACE to Restart", align="center", font=("Arial", 20, "bold"))
+                self.game_state = "GAME_OVER"
+                continue
 
-            # Game speed
             time.sleep(self.delay)
 
 
@@ -142,4 +154,4 @@ def run(self):
     try:
         game.run()
     except turtle.Terminator:
-        pass
+        pass