https://github.com/thunder-engine/sample-match3

Crystal Matcher - A Match-3 Game Project
https://github.com/thunder-engine/sample-match3

2d-game sample-code thunder-engine

Last synced: 3 months ago
JSON representation

Crystal Matcher - A Match-3 Game Project

• Host: GitHub
• URL: https://github.com/thunder-engine/sample-match3
• Owner: thunder-engine
• License: mit
• Created: 2025-10-24T05:36:23.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2025-10-24T07:04:18.000Z (5 months ago)
• Last Synced: 2025-10-24T07:27:19.863Z (5 months ago)
• Topics: 2d-game, sample-code, thunder-engine
• Language: C++
• Homepage:
• Size: 539 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Crystal Matcher - A Match-3 Game Project

A colorful and engaging **Match-3 puzzle game** built with **Thunde Engine** where players swap adjacent crystals to create matches of three or more identical gems.

![Screenshot](https://raw.githubusercontent.com/thunder-engine/sample-match3/main/screen.png)

## Features

*   **Intuitive Controls:** Click and swap adjacent crystals using mouse controls

*   **Match Detection:** Automatic detection of horizontal and vertical matches of 3 or more identical crystals

*   **Score System:** Earn points for every successful match with combo potential

*   **Visual Feedback:** Clear visual indicators for selected crystals and valid moves

*   **Chain Reactions:** Cascading matches when crystals fall and create new combinations

## Getting Started

### Prerequisites

*   Ensure you have the **Thunde Engine** installed and properly set up on your system

*   A C++ compiler with C++17 support or higher

## How to Play

1.  **Select a Crystal:** Click on any crystal to select it

2.  **Swap with Neighbor:** Click on an adjacent (up, down, left, right) crystal to swap positions

3.  **Create Matches:** Form lines of 3 or more identical crystals

4.  **Score Points:** Each match awards points - longer matches and combos yield higher scores

5.  **Watch for Cascades:** Matched crystals disappear, allowing new crystals to fall and potentially create chain reactions

## Controls

| Action | Control |

| :--- | :--- |

| Select Crystal | `Left Click` |

| Swap Crystals | `Left Click` on adjacent crystal |

## Game Rules

*   Only adjacent crystals can be swapped

*   Matches must contain at least 3 identical crystals

*   Matches can be horizontal or vertical

*   Swaps that don't create matches are automatically reverted

*   Score is calculated based on match length and combo multipliers

## Technology

This project is built as a learning exercise using the **Thunde Engine**, demonstrating 2D game development, grid-based logic, and puzzle game mechanics.

## License

This project is created for educational purposes and is distributed under the [MIT License](LICENSE).

## Content

The content provided by https://free-game-assets.itch.io/