# 🀄 Mahjong Expert

 

Eine moderne, performante Umsetzung des klassischen Mahjong-Solitaire,

optimiert für Windows, macOS und Linux.

 

---

 

## 🎮 Spielbeschreibung

Das Ziel von **Mahjong Expert** ist es, das Spielfeld zu leeren, indem alle

Paare identischer Steine gefunden werden.

 

* **Spielmechanik:** Klicke nacheinander zwei Steine an. Stimmen die Motive überein,

werden sie mit einem Explosionseffekt vom Feld entfernt. Bei Nichtübereinstimmung

werden sie nach kurzer Zeit automatisch wieder verdeckt.

* **Dynamische Inhalte:** Das Spiel lädt bei jedem Start zufällige Bilder aus dem

`bild`-Ordner. So gleicht keine Runde der anderen.

* **Atmosphäre:** Genieße Partikeleffekte, Sound-Feedback und eine spannende

Sieg-Phase mit Blitzen und Musik.

 

---

 

## 🛠 Installation & Start

 

### 🪟 Windows (.exe)

1. Starten Sie die `MahjongExpert.exe` per Doppelklick.

2. Falls der Windows-SmartScreen warnt: Klicken Sie auf

**"Weitere Informationen"** und anschließend auf **"Trotzdem ausführen"**.

 

### 🍎 macOS (.app)

1. Öffnen Sie das DMG-Image und ziehen Sie die App in den Ordner **Programme**.

2. **Sicherheitshinweis (macOS 15 Sequoia):** Da die App privat signiert ist, öffnen

Sie sie das erste Mal per **Rechtsklick -> Öffnen**. Bestätigen Sie den Dialog mit "Öffnen".

3. Das Spiel startet automatisch im Vollbildmodus, um das Dock und die Menüleiste auszublenden.

 

### 🐧 Linux (Binary)

1. Machen Sie die Datei ausführbar: `chmod +x MahjongExpert`.

2. Starten Sie das Spiel per Doppelklick oder über das Terminal.

 

---

 

## ⌨️ Steuerung

 

| Taste | Funktion |

| :--- | :--- |

| **Maus (Links)** | Stein auswählen / Menü-Interaktion |

| **[ + ] / [ - ]** | Lautstärke erhöhen / verringern (Anzeige oben im Spiel) |

| **ESC** | Zurück zum Hauptmenü / Spiel abbrechen |

| **Leertaste** | Nach einem Sieg zurück zum Menü |

 

---

 

## 📈 Schwierigkeitsgrade

 

| Level | Layout | Paare | Besonderheit |

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

| **Einfach** | 4 x 4 | 8 | Schneller Einstieg |

| **Mittel** | 4 x 8 | 16 | Ausgewogene Balance |

| **Schwer** | 5 x 10 | 25 | Hohe Konzentration |

| **EXPERT** | 5 x 16 | 40 | Maximale Herausforderung |

 

---

 

## ⚙️ Fehlerbehebung & Anpassung

 

* **Sound:** Stellen Sie sicher, dass `001.wav` (Effekt) und `002.wav`

(Musik) im Hauptverzeichnis liegen.

* **Eigene Bilder:** Du kannst den Inhalt des Ordners `bild` jederzeit ändern.

Das Spiel unterstützt alle gängigen `.png`-Dateien.

* **Skalierung:** Sollten die Steine auf einem quadratischen Monitor

(z.B. Linux 4:5) abgeschnitten sein, berechnet das Spiel die Kachelgröße

beim nächsten Start automatisch neu.

 

---

*Viel Spaß beim Knobeln!*