https://github.com/teditae/us-states-guessing-game
A Python game built with Turtle and Pandas where the player guesses the names of U.S. states and sees them appear on a U.S. map. A fun way to learn geography while coding!
https://github.com/teditae/us-states-guessing-game
data-visualization geography-game pandas python turtle
Last synced: 2 months ago
JSON representation
A Python game built with Turtle and Pandas where the player guesses the names of U.S. states and sees them appear on a U.S. map. A fun way to learn geography while coding!
- Host: GitHub
- URL: https://github.com/teditae/us-states-guessing-game
- Owner: TediTae
- Created: 2025-06-16T17:06:11.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-19T16:39:15.000Z (about 1 year ago)
- Last Synced: 2025-06-19T17:42:50.548Z (about 1 year ago)
- Topics: data-visualization, geography-game, pandas, python, turtle
- Language: Python
- Homepage:
- Size: 7.81 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# U.S. States Guessing Game 🗺️
## Description
This is an interactive game built with Python's Turtle graphics and Pandas, where the goal is to correctly guess all 50 U.S. states.
Each correct guess displays the state name on a blank U.S. map.
The game continues until all states are guessed or the player exits.
## Features
- Graphical interface using Turtle
- Text input dialog for guesses
- Dynamically displays correct guesses on the map
- Saves missing states to a `.csv` file for learning
- Case-insensitive guessing with `.title()` formatting
## How It Works
1. A blank U.S. map is loaded using a `.gif` image.
2. User is prompted to guess a state name.
3. If the guess is correct, the state name is shown on the map.
4. The game ends when all 50 states are guessed or the user types `Exit`.
5. When exited early, the game saves a list of missing states to `states_to_learn.csv`.
## Requirements
- Python 3.x
- `pandas` library
- `turtle` (built-in with Python)
- A `50_states.csv` file containing columns: `state`, `x`, `y`
- A `blank_states_img.gif` image file
## Installation
1. Clone this repository
2. Make sure you have the following files in the project directory:
- blank_states_img.gif
- 50_states.csv
3. Run the Python script:
- main.py
## Technologies Used
- Python 3
- Turtle Graphics
- Pandas
- CSV File Handling
## License
- This project is open source and available under the MIT License.
## Contact
- tolgayilmaz1377@gmail.com