Turtle Snake Game Development

Dariush Samari

Completed work

Game Developer

Software Engineer

Python

Gaming

Turtle Snake Game

A classic Snake game implemented in Python using the turtle module. The game features configurable window size and speed, grid‐aligned food, score tracking, and self‐collision/border detection.

Features

Smooth, grid‐based movement

Configurable frame‐rate (speed) and window size

Randomly placed food aligned to grid

Scoreboard with point tracking

Border and self‐collision detection (Game Over)

Modular design (separate Snake class, game controller, utils, and config)

Requirements

Python 3.7+

Standard library only (turtle, argparse, random, time)

Installation

Clone this repository:

git clone https://github.com/binarynectar/turtle-snake-game.git
cd turtle-snake-game

(Optional) Create and activate a virtual environment:

python3 -m venv venv
source venv/bin/activate   # macOS/Linux
venv\Scripts\activate      # Windows

Usage

Run the game via the provided main.py script. You can customize the window size and movement speed:

python main.py [--width WIDTH] [--height HEIGHT] [--speed MS_DELAY]

--width : Window width in pixels (default 600)

--height: Window height in pixels (default 600)

--speed : Movement delay in milliseconds (default 16 for ~60 FPS)

Example, to run at 800×800 pixels and a bit slower (~30 FPS):

python main.py --width 800 --height 800 --speed 33

Game Controls

Arrow keys: Change snake direction (Up, Down, Left, Right)

Close window: Ends game immediately (also triggers Game Over on collision)

Configuration

All game constants live in config.py:

| Constant                          | Description                                  |
| --------------------------------- | -------------------------------------------- |
| `DEFAULT_WINDOW_WIDTH/HEIGHT`     | Initial window size (px)                     |
| `DEFAULT_MOVEMENT_DELAY`          | Delay per move in ms (e.g. 16→60 FPS)        |
| `MOVEMENT_STEP`                   | Pixels moved per step                        |
| `GRID_SQUARE_SIZE`                | Grid cell size (px) for food placement       |
| `FOOD_COLLISION_DISTANCE`         | Distance threshold to eat food (px)          |
| `SELF_COLLISION_DISTANCE`         | Distance threshold for self‐collision (px)   |
| `BACKGROUND_COLOR`, etc.          | Colors and fonts for UI                      |
| `GAME_TITLE`, `GAME_OVER_MESSAGE` | Text strings for window title and end screen |

Feel free to tweak these to change look & feel.

Project Structure

.
├── main.py           # CLI parsing and game launch
├── config.py         # All configurable constants
├── utils.py          # Helper functions (e.g. random_food_position)
├── snake.py          # `Snake` class: head, segments, movement, growth, collision
└── snake_game.py     # `SnakeGame` class: setup, loop, scoring, input, game over