https://github.com/zhuagenborn/minesweeper-cheat

💣 A game cheat for Microsoft Minesweeper. It will change the window title to "Mlnesweeper" if the current block has a mine.
https://github.com/zhuagenborn/minesweeper-cheat

game game-cheating hook minesweeper reverse-engineering

Last synced: about 15 hours ago
JSON representation

💣 A game cheat for Microsoft Minesweeper. It will change the window title to "Mlnesweeper" if the current block has a mine.

• Host: GitHub
• URL: https://github.com/zhuagenborn/minesweeper-cheat
• Owner: Zhuagenborn
• License: mit
• Created: 2021-07-23T22:01:55.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-07-16T03:57:30.000Z (6 months ago)
• Last Synced: 2024-11-08T23:39:52.677Z (about 2 months ago)
• Topics: game, game-cheating, hook, minesweeper, reverse-engineering
• Language: Assembly
• Homepage:
• Size: 267 KB
• Stars: 7
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Citation: CITATION.cff

Awesome Lists containing this project

README

        
# *Minesweeper* Cheat

![MASM](docs/badges/MASM.svg)

[![Windows](docs/badges/Microsoft-Windows.svg)](https://www.microsoft.com/en-ie/windows)

![License](docs/badges/License-MIT.svg)

## Introduction

![Cover](Cover.jpg)

A game cheat for *Microsoft Minesweeper*. It will change the window title to "*Mlnesweeper*" if the current block has a mine.

## Getting Started

### Prerequisites

- Install [*MASM32*](http://www.masm32.com).

- Set the `PATH` environment variable.

### Building

Run the `build.ps1` file directly:

```console

PS> .\build.ps1

```

The `cheat.dll` will be generated in the `bin` folder.

### Usage

> The project has been only tested with the provided game version.

>

> The *MD5* of `Minesweeper.exe` is `9C45D38B74634C9DED60BEC640C5C3CA`.

The `cheat.dll` must be injected into the game to activate its function. You can directly use this simple injection tool: [*Dll-Injector*](https://github.com/Zhuagenborn/Windows-DLL-Injector).

```console

Dll-Injector Minesweeper cheat.dll

```

The window title will become "*Mlnesweeper*" if the current block has a mine.

![cheat](docs/images/cheat.png)

## Reverse Engineering

### Graphic

*Microsoft Minesweeper* uses the `BitBlt` function to draw its mine area.

![loop-bitblt](docs/images/loop-bitblt.png)

`0x01005334` and `0x01005338` are the addresses of the mine area's width and height. When the game executes at `0x01002700` for the first time, the mine area is empty.

![empty-area](docs/images/empty-area.png)

The stack is shown as below:

![bitblt](docs/images/bitblt.png)

According to the declaration of `BitBlt`, the pixel coordinate of the *top-left* corner of the mine area is *(12, 55)*. And the side length of a block is *16*.

```c

BOOL BitBlt(HDC hdc, int x, int y, int cx, int cy, HDC hdcSrc, int x1, int y1, DWORD rop);

```

### Mine Data

At `0x01002669`, the game reads mine data from `0x01005340`.

![read-mine-area](docs/images/read-mine-area.png)

For the following mine area:

![game-end](docs/images/game-end.png)

The data around `0x01005340` are organized as:

![mine-data](docs/images/mine-data.png)

It is clear that each `0x8A` means a mine and `0xCC` is the activated mine.

## License

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