Complexweeper

A cross-platform Minesweeper game written in Rust, featuring Classic, Complex and Hyperbolic Complex modes, with sound effects.

Features

Classic Mode

• Standard Minesweeper gameplay with one mine type
• Numbered clues (1-8) in classic colors
• Right-click to flag / unflag
• Chord (middle-click or both buttons) to reveal neighbors
• First-click safety guarantee

Complex Mode

• Four mine types: +Real, -Real, +Imaginary, -Imaginary (+1, -1, +i, -i)
• Clues show the squared magnitude of the complex sum of adjacent mines
• 24 possible display values (integers and simplest radicals)
• Four flag types, cycled with right-click
• Chord criterion: flag count matches mine count, and real/imaginary ratio matches (or is swapped)

Hyperbolic Complex Mode

• Four mine types: +Real, -Real, +Hyperbolic, -Hyperbolic (+1, -1, +j, -j, where j² = +1)
• Clues show the hyperbolic form magnitude D = a² − b²
• 39 possible display values; negative values render as "radical + i unit" (e.g. −4 → 2i, −7 → √7i)
• Because D hides only the signs of a and b, the chord criterion requires flag count to match mine count and |a|, |b| to each match (any of the four sign combinations is accepted; a real/hyperbolic swap is not)
• The imaginary-unit LED on the mine counters shows a red j instead of i

All Modes

• Three difficulty presets: Beginner (9x9, 10), Intermediate (16x16, 40), Expert (30x16, 99)
• Custom board dimensions and per-type mine counts
• Zoom levels: 100%, 200%, 300%
• Best time tracking per mode and difficulty (stored locally)
• Sound effects with an on/off toggle (persisted): a blast sound per mine type, a win fanfare, and a one-second tick while the timer runs
• End-of-game review: after a win or loss the board marks every correctly flagged mine, wrongly flagged mine, and flag placed on an empty cell
• F2 to start a new game
• Classic Windows 95-style visual design

Building

Requires Rust 1.70+ (with cargo).

cargo build --release

The binary will be at target/release/complexweeper.

Running

cargo run --release

Controls

Action	Input
Reveal cell	Left click
Flag / cycle flag	Right click
Chord (expand neighbors)	Middle click or Left+Right click
Switch mode	Game → Mode: Classic / Complex / Hyperbolic Complex
Toggle sound	Game → Sound: On / Off
New game	Click the smiley face or press F2
Menu	Use the menu bar at the top

How to Play

Classic

• Numbers show how many mines are adjacent to that cell.
• Reveal all non-mine cells to win.
• Flag cells you suspect contain mines.

Complex

• There are four types of mines: +Real, -Real, +Imag, -Imag.
• Each number shows |sum of adjacent mines|² — the squared magnitude of the complex sum.
• Positive and negative mines of the same type can cancel each other out.
• A "0" means all adjacent mines form canceling pairs; a blank cell means no adjacent mines at all.
• Right-click cycles through the four flag types.
• Chord when the flag count matches and the real/imaginary ratio is correct (or swapped).

Hyperbolic Complex

• There are four types of mines: +Real, -Real, +j, -j, with j² = +1.
• Each number shows D = a² − b², the hyperbolic form magnitude of the adjacent-mine sum.
• Negative D values display with an i unit (e.g. 2i, √7i), which lets you tell real and hyperbolic mines apart directly.
• Right-click cycles through the four flag types.
• Chord when the flag count matches and |a| and |b| each match — any sign combination is acceptable.

Project Structure

src/
  main.rs        — Entry point and game loop
  app.rs         — Application state, rendering, input, menus, dialogs
  game.rs        — Core game logic (platform-independent)
  assets.rs      — PNG atlas loading and sprite management
  sounds.rs      — Embedded sound effects (load + play)
  game_tests.rs  — Unit tests for game logic
assets/
  atlas.png      — Sprite atlas (includes hyperbolic and review tiles)
  atlas.json     — Sprite slot definitions
  sounds/        — WAV clips (mine blasts, win fanfare, tick)
tools/
  merge_atlas.py — Regenerates the atlas from the original Zig assets

Technology

• macroquad — Cross-platform windowing, 2D rendering and audio
• image — PNG decoding
• serde / serde_json — JSON parsing
• directories — Cross-platform config paths

License

Code licensed under GPL-3.0. Original Minesweeper image assets are property of Microsoft and are not covered by the GPL-3.0 license. New image assets by Qingyue Xiao, licensed under GPL-3.0. Sound effects are from the original Zig version of Complexweeper.

This program is an independent remake and is not affiliated with Microsoft.