https://github.com/sumitst05/mysterynum
MysteryNum is an engaging and challenging web-based number guessing game where you clash against an intelligent AI opponent (or so I like to call it) to make strategic and logical guesses.
https://github.com/sumitst05/mysterynum
Last synced: 3 months ago
JSON representation
MysteryNum is an engaging and challenging web-based number guessing game where you clash against an intelligent AI opponent (or so I like to call it) to make strategic and logical guesses.
- Host: GitHub
- URL: https://github.com/sumitst05/mysterynum
- Owner: sumitst05
- License: gpl-3.0
- Created: 2023-06-09T14:35:33.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2023-08-30T09:39:49.000Z (almost 3 years ago)
- Last Synced: 2025-01-17T20:34:57.293Z (over 1 year ago)
- Language: CSS
- Homepage: https://sumitst05.github.io/MysteryNum/
- Size: 5.25 MB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ✨ MysteryNum ✨
MysteryNum is a number guessing game built using vanilla JavaScript, HTML and CSS.
- Guess the randomly generated secret number.
- The objective is to find the correct number before the computer finds it.
The guesses made by the computer are `not random` but sound and smart.
## 🚀 Getting Started
To play the game, you need a web browser with JavaScript support.
1. Clone the repository or download the source code.
2. Open a terminal or command prompt and navigate to the project directory.
3. Install the dependencies by running the following command:
```bash
npm install
```
4. Start the server:
```bash
npm run devstart
```
5. Open a web browser and visit `http://localhost:3000` to play the game.
Alternatively, you can play the game online by visiting the [MysteryNum Game Website](https://sumitst05.github.io/MysteryNum/).
## 🗂️ File Structure
The project has the following file structure:
```
/
├── public/
│ ├── index.html
│ ├── MysteryNum.js
│ └── style.css
├── assets/
│ ├── background.jpg
│ ├── computer.png
│ └── human.png
├── server.js
└── package.json
```
## 🎮 How to Play
- When you start the game, a secret number between a specified range will be generated.
- Enter your guess in the input field provided and click the "Guess" button.
- The game will provide feedback whether your guess is too high or too low.
- Keep guessing until you find the correct number or run out of attempts.
- The game will end and display the result (win or lose) along with the secret number.
## ⚙️ Features
- Responsive UI: The game interface is designed to work well on both desktop and mobile devices.
## 🤝 Contributing
Contributions to the MysteryNum game are welcome. If you find any bugs, have suggestions, or want to add new features, please open an issue or submit a pull request on the GitHub repository.
## 📘 License
This project is licensed under the GNU General Public License. See the [LICENSE](LICENSE) file for more details.