# 🀄 Mahjong Expert

 

Современная и производительная реализация классического пасьянса Маджонг,

оптимизированная для Windows, macOS и Linux.

 

---

 

## 🎮 Описание игры

Цель **Mahjong Expert** — полностью очистить игровое поле, находя пары одинаковых костей.

 

* **Игровая механика:** Нажимайте поочередно на две кости. Если изображения совпадают,

они исчезают с эффектом взрыва. Если изображения разные, кости автоматически закрываются через короткое время.

* **Динамический контент:** При каждом запуске игра выбирает случайные изображения из папки `bild`.

 Благодаря этому каждая партия уникальна.

* **Атмосфера:** Наслаждайтесь эффектами частиц, звуковым сопровождением и захватывающим финалом

с молниями и музыкой при победе.

 

---

 

## 🛠 Установка и запуск

 

### 🪟 Windows (.exe)

1. Запустите файл `MahjongExpert.exe` двойным кликом.

2. Если появится предупреждение Windows SmartScreen: нажмите **"Подробнее"**,

а затем — **"Выполнить в любом случае"**.

 

### 🍎 macOS (.app)

1. Откройте образ DMG и перетащите приложение в папку **Applications** (Программы).

2. **Важно для macOS 15 Sequoia:** Так как приложение создано частным разработчиком,

в первый раз запустите его через **правый клик -> Открыть**. Затем подтвердите действие,

нажав "Открыть" в диалоговом окне.

3. Игра автоматически запускается в полноэкранном режиме, чтобы скрыть панель Dock и строку меню.

 

### 🐧 Linux (Binary)

1. Сделайте файл исполняемым: `chmod +x MahjongExpert`.

2. Запустите игру двойным кликом или через терминал.

 

---

 

## ⌨️ Управление

 

| Клавиша | Функция |

| :--- | :--- |

| **Мышь (Левая кнопка)** | Выбор кости / Взаимодействие с меню |

| **[ + ] / [ - ]** | Увеличить / Уменьшить громкость (индикатор отображается сверху) |

| **ESC** | Вернуться в главное меню / Прервать игру |

| **Пробел (Space)** | Вернуться в меню после победы |

 

---

 

## 📈 Уровни сложности

 

| Уровень | Сетка | Пар | Особенности |

| :--- | :--- | :--- | :--- |

| **Легкий (Einfach)** | 4 x 4 | 8 | Быстрая разминка |

| **Средний (Mittel)** | 4 x 8 | 16 | Сбалансированная игра |

| **Сложный (Schwer)** | 5 x 10 | 25 | Требует концентрации |

| **ЭКСПЕРТ (EXPERT)** | 5 x 16 | 40 | Максимальная сложность |

 

---

 

## ⚙️ Устранение неполадок и настройки

 

* **Звук:** Убедитесь, что файлы `001.wav` (эффект) и `002.wav` (музыка)

находятся в корневой директории игры.

* **Свои картинки:** Вы можете в любое время изменить содержимое папки `bild`.

Игра поддерживает любые файлы в формате `.png`.

* **Масштабирование:** Если на квадратном мониторе (например, Linux 4:5) края обрезаются,

игра автоматически пересчитает размер плиток при следующем запуске.

 

---

*Желаем удачи в поиске всех пар!*