ROADMAP-NUMBER-GUESSING-GAME

❯ A classic number guessing game with multiple difficulty levels and high scores

Table of Contents

• Overview
• Features
• Project Structure
  • Project Index
• Getting Started
  • Prerequisites
  • Installation
  • Usage
  • Testing
• Project Roadmap
• Contributing
• License
• 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

└── 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:

❯ git clone https://github.com/P-Nelly/roadmap-number-guessing-game

2. Navigate to the project directory:

❯ 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:

❯ 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

• 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: Share your insights, provide feedback, or ask questions.
• 🐛 Report Issues: Submit bugs found or log feature requests for the roadmap-number-guessing-game project.
• 💡 Submit Pull Requests: 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.

   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.

   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.

   git commit -m 'Implemented new feature x.'

6. Push to github: Push the changes to your forked repository.

   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. For more details, refer to the 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

---