Skip to content

Navigation Menu

Sign in
Sign up

Latest commit

History

21 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

🎯 Guess Number Game

A modern and interactive number guessing game built with Python and CustomTkinter.
This game challenges the player to guess a random number between 1 and 100 with limited attempts based on the selected difficulty.

Guess Number Game Project Preview

πŸš€ Features

  • βœ”οΈ Modern GUI with CustomTkinter
  • βœ”οΈ Difficulty levels: Easy / Normal / Hard
  • βœ”οΈ Random number generation
  • βœ”οΈ Hint system (Higher / Lower)
  • βœ”οΈ Light & Dark mode
  • βœ”οΈ Restart / New Game system
  • βœ”οΈ Clean and simple UI

πŸ› οΈ Installation & Running

1️⃣ Clone the repository

git clone https://github.com/MonkeyxDev/GuessNumberGame.git

2️⃣ Install dependencies

pip install -r requirements.txt

3️⃣ Run the game

python src/game.py

πŸ“¦ Requirements

  • Python 3.13
  • customtkinter

πŸ”§ Difficulty System

Difficulty Attempts
Easy 20
Normal 15
Hard 7

🧩 How the Game Works

  • The program randomly selects a number between 1 and 100.
  • The player must guess the secret number using the input field.
  • Based on the selected difficulty, the player has a limited number of attempts.
  • After each guess, the game provides a hint:
    • Higher β†’ The secret number is greater than your guess.
    • Lower β†’ The secret number is smaller than your guess.
  • If the player guesses the number, they win the game.
  • If attempts reach zero, the game ends with a loss message.
  • A new game can be started anytime by clicking New Game.

πŸ“œ License

This project is licensed under the MIT License.
Feel free to use, modify, or distribute the source code.

⭐ Support

If you enjoyed this project, consider giving it a ⭐ star on GitHub β€” it really helps and motivates further development!

About

A modern GUI-based number guessing game built with Python and CustomTkinter. Players try to guess a random number within a selected difficulty range. The game includes a clean interface, dynamic feedback, restart option, and customizable settings.

Topics

Resources

Stars

4 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /