diff --git a/SinglePlayer - Games/Guess The Number/README.md b/SinglePlayer - Games/Guess The Number/README.md index ccb364c2..0a5335ef 100644 --- a/SinglePlayer - Games/Guess The Number/README.md +++ b/SinglePlayer - Games/Guess The Number/README.md @@ -1,3 +1,92 @@ -# guess-the-number-game -In this Game Computer will guess the number between 1 to 100. And your task is to find that number in 10 Chance. +# 🔢 Guess The Number Game +A fun and interactive number guessing game where the computer selects a random number between **1 and 100**, and your goal is to guess it within **10 chances**! + +## 🎮 How to Play + +1. The computer will randomly select a number between **1 to 100**. +2. Enter your guess in the input field provided. +3. The game will give you hints: + - **"Too High"** - Your guess is higher than the target number. + - **"Too Low"** - Your guess is lower than the target number. +4. Keep guessing until you find the correct number or run out of **10 chances**. +5. Try to guess the number in as few attempts as possible! + +## ✨ Features + +- 🎯 **Random Number Generation** - Every game is unique with a fresh random number. +- 💡 **Smart Hints** - Get "Too High" or "Too Low" feedback after each guess. +- 🎨 **Beautiful UI** - Clean and modern design with smooth animations. +- 📱 **Responsive Design** - Play on any device - desktop, tablet, or mobile. +- ⚡ **Instant Feedback** - Real-time response after each guess. +- 🏆 **Win/Lose Tracking** - See your game results instantly. + +## 🛠️ Tech Stack + +- **HTML5** - Semantic markup and structure. +- **CSS3** - Modern styling with animations and responsive design. +- **JavaScript (Vanilla)** - Core game logic and DOM manipulation. + +## 📸 Screenshots + +### Game Start +![Game Start](assets/game-start.png) +*The game starts with a fresh random number between 1-100.* + +### Playing the Game +![Gameplay](assets/gameplay.png) +*Enter your guess and receive instant feedback.* + +### Winning Screen +![Win Screen](assets/win-screen.png) +*Congratulations! You guessed the correct number!* + +## 🚀 Getting Started + +### Option 1: Direct Play +Simply open `index.html` in your web browser - no installation required! + +### Option 2: Local Development +```bash +# Clone the repository +git clone + +# Navigate to the game directory +cd "SinglePlayer - Games/Guess The Number" + +# Open in browser +open index.html # macOS +# OR +start index.html # Windows +# OR +xdg-open index.html # Linux +``` + +## 📂 File Structure + +``` +Guess The Number/ +├── index.html # Main HTML structure +├── style.css # Styling and animations +├── main.js # Game logic and interactivity +├── README.md # Documentation +└── assets/ # Game assets and screenshots +``` + +## 🤝 Contributing + +Contributions are welcome! If you have ideas for improvements: + +1. Fork the repository. +2. Create your feature branch (`git checkout -b feature/amazing-feature`). +3. Commit your changes (`git commit -m 'Add amazing feature'`). +4. Push to the branch (`git push origin feature/amazing-feature`). +5. Open a Pull Request. + +## 📝 License + +This project is part of the GameSphere collection. See the main repository for licensing details. + +--- + +**Made with ❤️ for GameSphere | GSSoC 2026**