BIGBEN-02/nigeria-states-game
Domain:
educationCreator:
BIG
Host:
A Python Turtle-based interactive game for learning Nigerian states.
Nigeria States Guessing Game (Python Turtle)
An interactive educational game built with Python Turtle Graphics, where users guess the 36 states of Nigeria (plus the FCT). Each correct answer places a colored marker on the map and labels the state directly on screen.
This project demonstrates skills in Python, Turtle graphics, CSV data handling, coordinate mapping, and basic game logic.
🎮 How the Game Works
A GIF map of Nigeria loads onto the screen using turtle.addshape()
The player is prompted to type the name of a Nigerian state
If correct:
A green circular highlight appears on the state’s coordinates
The state name is written directly on the map
If the user types Exit, a Missing_states.csv file is generated showing the states not yet guessed
Game ends when all states have been correctly identified or exit is typed
✨ Core Features
🗺️ Custom GIF map of Nigeria rendered with Turtle
📍 Automatic circle markers for each correct guess
🏷️ Labels added at exact X/Y coordinates per state
📑 CSV data loading (36 states + FCT)
📝 Auto-generated list of missing states
🧠 Case-handling using .title() for user input
🎯 User-friendly prompts and progress counter
🛠️ Tech Stack
Python 3
Turtle Graphics (for map, shapes, drawing)
Pandas (CSV reading + exporting)
CSV dataset (state name + X/Y pixel coordinates)
📂 Project Structure
Nigeria-Turtle-State-Game/
│── main.py # your main game script
│── nigeria_map.gif # the map used as turtle shape
│── 36_states.csv # state name + coordinates
│── Missing_states.csv # auto-created when quitting early
└── README.md # documentation (this file)
🚀 How to Run
Install Python 3
Install pandas:
pip install pandas
Place the files in the same folder:
main.py
nigeria_map.gif
36_states.csv
Run:
python main.py
The map will appear — start guessing states!
🧩 Gameplay Demo (Explanation)
User sees a Nigeria map
A popup asks: "0/36 Guess a state"
Type: Lagos → gre …