https://github.com/p-nelly/roadmap-number-guessing-game
A Python-based number guessing game featuring multiple difficulty levels, high score tracking, and real-time hints. Perfect for learning Python basics through interactive gameplay. Built with pure Python, no external dependencies required.
https://github.com/p-nelly/roadmap-number-guessing-game
beginner-friendly cli-app command-line educational game-development high-score interactive-game learning-to-code number-guessing programming-exercises python python-learning terminal-game
Last synced: 3 months ago
JSON representation
A Python-based number guessing game featuring multiple difficulty levels, high score tracking, and real-time hints. Perfect for learning Python basics through interactive gameplay. Built with pure Python, no external dependencies required.
- Host: GitHub
- URL: https://github.com/p-nelly/roadmap-number-guessing-game
- Owner: P-Nelly
- License: mit
- Created: 2024-12-24T23:03:25.000Z (5 months ago)
- Default Branch: master
- Last Pushed: 2024-12-24T23:19:13.000Z (5 months ago)
- Last Synced: 2025-01-10T03:03:28.794Z (4 months ago)
- Topics: beginner-friendly, cli-app, command-line, educational, game-development, high-score, interactive-game, learning-to-code, number-guessing, programming-exercises, python, python-learning, terminal-game
- Language: Python
- Homepage:
- Size: 8.79 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
ROADMAP-NUMBER-GUESSING-GAME
❯ A classic number guessing game with multiple difficulty levels and high scores
## Table of Contents
- [ Overview](#overview)
- [ Features](#features)
- [ Project Structure](#project-structure)
- [ Project Index](#project-index)
- [ Getting Started](#getting-started)
- [ Prerequisites](#prerequisites)
- [ Installation](#installation)
- [ Usage](#usage)
- [ Testing](#testing)
- [ Project Roadmap](#project-roadmap)
- [ Contributing](#contributing)
- [ License](#license)
- [ Acknowledgments](#acknowledgments)
---
## Overview
A classic number guessing game implemented in Python where players try to guess a randomly generated number between 1 and 100. The game features multiple difficulty levels, hints, and a high score system.
---
## Features
- Three difficulty levels: Easy (10 attempts), Medium (5 attempts), and Hard (3 attempts)
- Dynamic feedback on each guess (higher/lower hints)
- High score tracking for each difficulty level
- Time tracking for each game round
- Input validation and error handling
- User-friendly command-line interface
---
## Project Structure
```sh
└── roadmap-number-guessing-game/
├── LICENSE
├── README.md
└── main.py
```
### Project Index
ROADMAP-NUMBER-GUESSING-GAME/
__root__
main.py
Main game implementation containing the NumberGuessingGame class and game logic
README.md
Project documentation and setup instructions
---
## Getting Started
### Prerequisites
Before getting started with roadmap-number-guessing-game, ensure your runtime environment meets the following requirements:
- **Programming Language:** Python
### Installation
Install roadmap-number-guessing-game using one of the following methods:
**Build from source:**
1. Clone the roadmap-number-guessing-game repository:
```sh
❯ git clone https://github.com/P-Nelly/roadmap-number-guessing-game
```
2. Navigate to the project directory:
```sh
❯ cd roadmap-number-guessing-game
```
3. No additional dependencies required! The game uses only Python standard library.
### Usage
Run the game using the following command:
```sh
❯ python main.py
```
### Testing
No formal testing suite is implemented yet. Manual testing can be performed by running the game and trying different inputs.
---
## Project Roadmap
- [X] **`Task 1`**: Implement basic number guessing game functionality
- [ ] **`Task 2`**: Add persistent high scores using file storage
- [ ] **`Task 3`**: Implement a graphical user interface
- [ ] **`Task 4`**: Add additional game modes and features
- [ ] **`Task 5`**: Create a multiplayer mode
---
## Contributing
- **💬 [Join the Discussions](https://github.com/P-Nelly/roadmap-number-guessing-game/discussions)**: Share your insights, provide feedback, or ask questions.
- **🐛 [Report Issues](https://github.com/P-Nelly/roadmap-number-guessing-game/issues)**: Submit bugs found or log feature requests for the `roadmap-number-guessing-game` project.
- **💡 [Submit Pull Requests](https://github.com/P-Nelly/roadmap-number-guessing-game/blob/main/CONTRIBUTING.md)**: Review open PRs, and submit your own PRs.
Contributing Guidelines
1. **Fork the Repository**: Start by forking the project repository to your github account.
2. **Clone Locally**: Clone the forked repository to your local machine using a git client.
```sh
git clone https://github.com/P-Nelly/roadmap-number-guessing-game
```
3. **Create a New Branch**: Always work on a new branch, giving it a descriptive name.
```sh
git checkout -b new-feature-x
```
4. **Make Your Changes**: Develop and test your changes locally.
5. **Commit Your Changes**: Commit with a clear message describing your updates.
```sh
git commit -m 'Implemented new feature x.'
```
6. **Push to github**: Push the changes to your forked repository.
```sh
git push origin new-feature-x
```
7. **Submit a Pull Request**: Create a PR against the original project repository. Clearly describe the changes and their motivations.
8. **Review**: Once your PR is reviewed and approved, it will be merged into the main branch. Congratulations on your contribution!
Contributor Graph
---
## License
This project is protected under the [MIT License](https://choosealicense.com/licenses/mit/). For more details, refer to the [LICENSE](LICENSE) file.
---
## Acknowledgments
- Built as part of the Python learning roadmap: https://roadmap.sh/projects/number-guessing-game
- Inspired by classic number guessing games
- Uses Python's random and time modules from the standard library
---