https://github.com/corzed/minesweeper
Simple Classic MindSweeper game made in python using pygame
https://github.com/corzed/minesweeper
Last synced: 2 months ago
JSON representation
Simple Classic MindSweeper game made in python using pygame
- Host: GitHub
- URL: https://github.com/corzed/minesweeper
- Owner: Corzed
- Created: 2024-04-19T00:43:55.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2024-04-19T01:21:49.000Z (about 1 year ago)
- Last Synced: 2025-02-09T10:41:56.598Z (4 months ago)
- Language: Python
- Size: 8.79 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Pygame Minesweeper :bomb:
Welcome to the GitHub repository for a classic Minesweeper game implemented in Python using the Pygame library. Designed to run on a 10x10 board with 15 hidden mines, this project is perfect for those looking to brush up on their puzzle-solving skills or delve into game development with Pygame.
## :sparkles: Features
- **Customizable Board Size**: Easily modify the board size and number of mines by changing the constants.
- **Colorful UI**: The game features a simple yet attractive user interface with distinct colors for each cell state.
- **Interactive Gameplay**: Players can open cells, flag mines, and use chords to reveal areas of the board, increasing interaction and complexity.
## :hammer_and_wrench: Installation
To get started with this Minesweeper game, follow these steps:
1. Ensure that Python and Pygame are installed on your machine. If not, you can download Python from [python.org](https://www.python.org/) and install Pygame via pip:
```bash
pip install pygame
```
2. Clone this repository:
```bash
git clone https://github.com//Corzed/MineSweeper.git
```
3. Navigate to the cloned repository:
```bash
cd pygame-minesweeper
```
4. Run the game:
```bash
python minesweeper.py
```
## :video_game: How to Play
- **Left Click** on a cell to open it.
- **Right Click** on a cell to flag it or unflag it.
- **Middle Click** on an opened cell to use the chord action, which opens adjacent cells if the number of flags around it matches the number of adjacent mines.
The game ends when all non-mine cells are opened or a mine is triggered.
## :open_file_folder: Project Structure
The project files are structured as follows:
- `minesweeper.py`: Contains the main game logic, Pygame window setup, and event handling.
## :handshake: Contributing
Contributions to the Minesweeper project are welcome! Here are some ways you can contribute:
- Submit bugs and feature requests.
- Review code and improve code quality.
- Add new features or enhancements.
Before contributing, please review the CONTRIBUTING.md file for guidelines on how to make a pull request and propose feature changes.