Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/iambotcoder/india-states-game
Guess the States of India!
https://github.com/iambotcoder/india-states-game
Last synced: 6 days ago
JSON representation
Guess the States of India!
- Host: GitHub
- URL: https://github.com/iambotcoder/india-states-game
- Owner: iambotcoder
- Created: 2025-01-09T07:25:22.000Z (about 1 month ago)
- Default Branch: master
- Last Pushed: 2025-01-09T08:03:11.000Z (about 1 month ago)
- Last Synced: 2025-01-09T08:41:57.977Z (about 1 month ago)
- Language: Python
- Size: 10 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🇮🇳 India States Game
## 🎯 Overview
The India States Game is an interactive Python-based application where users guess the names of Indian states. Each correct guess places the state name on a graphical map of India at its corresponding location. It’s a fun and educational game to learn about India’s geography!
---
## 🛠️ Features
- **Interactive Gameplay:** Guess the state names, and see them appear on the map.
- **Real-Time Feedback:** Tracks how many states you’ve guessed correctly.
- **Exit Anytime:** Exit the game at any point to view the states you missed.
- **Educational Purpose:** Learn the geographical locations of all 29 Indian states.
---
## 🚀 Getting Started
### Prerequisites
- Python 3.7 or higher installed on your system.
- The following Python library:
- `pandas`
- Files required for the game:
- `india_map_.gif` (Graphical map of India)
- `states_coords.csv` (List of states with their coordinates)
### Installation Steps
1. **Clone the Repository**:
```bash
git clone https://github.com/yourusername/IndiaStatesGame.git
```
2. **Navigate to the Project Directory**:
```bash
cd IndiaStatesGame
```
3. **Install Dependencies**:
```bash
pip install pandas
```
4. **Run the Game**
```bash
python main.py
```
## 📝 Game Instructions
- When you start the game, a graphical map of India appears.
- You will be prompted to guess the name of an Indian state.
- Type your answer in the input box (e.g., "Maharashtra").
- If your answer is correct, the state name will be displayed on the map at its proper location.
- The game ends when:
- You’ve guessed all 29 states, or
- You type `exit` to quit early.
- States you didn’t guess will be saved in a CSV file for review.
## 📂 Project Files
- **`main.py`**: The main Python script for the game.
- **`states_coords.csv`**: Contains the names and coordinates of Indian states.
- **`india_map_.gif`**: A graphical representation of India used for the game.
- **`.gitignore`**: To exclude unnecessary files from the repository.
- **`README.md`**: Documentation for the project.
---
## 🖼️ Preview
Here’s how the game looks in action:
*(Add a screenshot or link here)*
---
## 🤝 Contributing
Contributions are welcome! Feel free to:
- Report bugs.
- Suggest new features.
- Fork the repository and create pull requests.
---
## 🛡️ License
This project is open-source and available under the **MIT License**.
---
## 📧 Contact
For any questions or feedback, feel free to reach out:
- **Name**: Subodh Sonawane
- **Email**: [email protected]
- **GitHub**: [yourusername](https://github.com/yourusername)
---
## 💡 Acknowledgments
Special thanks to the creators of:
- Python's `turtle` library for graphical support.
- `pandas` for data management.
- The inspiration to create this educational game about Indian geography.