Skip to content

Latest commit

 

History

History
87 lines (59 loc) · 2.5 KB

README.md

File metadata and controls

87 lines (59 loc) · 2.5 KB

Minesweeper Game

A classic Minesweeper game built with JavaScript, HTML, and CSS.

Table of Contents

About the Project

This is a web-based implementation of the classic Minesweeper game. It was developed as a practice project to improve skills in JavaScript, HTML, and CSS.

Game Features

  • Three difficulty levels: Beginner, Intermediate, and Expert.
  • Implemented using plain JavaScript for game logic.
  • Sound effects for game interactions.
  • Displays remaining lives as heart icons.
  • Timer to track the time taken to complete the game.
  • Hints for uncovering cells temporarily.
  • Real-time updates and dynamic gameplay.

Getting Started

Prerequisites

  • A modern web browser (e.g., Chrome, Firefox, Edge).
  • Basic knowledge of HTML, CSS, and JavaScript (optional for contributors).

Installation

  1. Clone the repository to your local machine:

    git clone https://github.com/natiapa/minesweeper.git

  2. Open the project directory:

    cd minesweeper

  3. Open index.html in your web browser to start the game.

Usage

  • Choose the difficulty level (Beginner, Intermediate, Expert).
  • Click on cells to reveal them.
  • Right-click to place flags on suspected mines.
  • Use hints if needed.
  • The game ends when all non-mine cells are revealed or when a mine is clicked.

Game Rules

  • The goal is to clear a board containing hidden mines without detonating any of them.
  • Each number in a revealed cell represents how many mines are adjacent to it.
  • Use logic and reasoning to avoid mines and clear the board.

Contributing

Contributions are what make the open-source community such an amazing place to learn and create. Any contributions you make are greatly appreciated.

  1. Fork the Project.
  2. Create your Feature Branch (git checkout -b feature/YourFeature).
  3. Commit your changes (git commit -m 'Add some YourFeature').
  4. Push to the Branch (git push origin feature/YourFeature).
  5. Open a Pull Request.

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Natia Cohen - natiapa

Project Link: https://natiapa.github.io/minesweeper/