Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
93 changes: 91 additions & 2 deletions SinglePlayer - Games/Guess The Number/README.md
Original file line number Diff line number Diff line change
@@ -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 <repository-url>

# 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**