Breakout Arzttarif – Spiel & Quiz

Ein browserbasiertes Breakout‑Spiel, das medizinische Tarif‑Quizfragen integriert. Das Spiel ist vollständig in HTML/CSS/JavaScript umgesetzt – Python wird ausschließlich dazu verwendet, per excel_to_json.py den Fragenkatalog aus der Excel‑Datei zu erzeugen. Die Fragen stammen aus einer Excel‑Datei und werden vor Spielstart in eine JSON‑Datei umgewandelt, die das Spiel dann dynamisch lädt.

---

🕹️ Spielbeschreibung

Halte den Ball mit dem Paddle im Spiel, zerstöre Bricks und beantworte Quizfragen, die sich hinter speziellen „?-Bricks“ verbergen. Richtige Antworten erhöhen deinen Punktestand, falsche machen das Spiel schneller!

---

🎮 Steuerung

Eingabegerät	Aktion
Maus	Paddle horizontal steuern
← / →	Paddle nach links / rechts
↑ / ↓	Im Quiz Antworten wählen
Enter	Antwort bestätigen
Esc	Quiz verlassen bzw. Spiel abbrechen

---

🌟 Features

• Farbige Bricks, dynamische Ballphysik, wechselnde Paddle‑Farben
• Soundeffekte für alle Kollisionen und Spielende
• Zufällig eingestreute Quiz‑Bricks (Fragen aus questions.json)
• Punktesystem & Ergebnis‑Popup
• Vollständig tastatur‑ und mausbedienbar

---

📂 Verzeichnisstruktur

.
├─ assets/
│  ├─ images/background.png
│  └─ sounds/
│     ├─ brick_hit.wav
│     ├─ paddle_hit.wav
│     ├─ wall_hit.wav
│     └─ game_over.wav
├─ excel_to_json.py              # Excel → JSON‑Konverter
├─ Neuer_Arzttarif_Frage_Antwort_Spiel.xlsx  # Quell‑Excel
├─ questions.json                # Generierte Fragen (wird überschrieben)
├─ index.html                    # Einstiegspunkt
├─ game.js                       # Spiellogik (JavaScript)
└─ style.css                     # Layout & Styling

---

⚙️ Voraussetzungen

Zweck	Software
Spiel ausführen	Moderner Browser (Chrome, Firefox ≥ v100, Edge, Safari)
Fragenkatalog erzeugen (optional)	Python 3.9 +   mit Paketen pandas und openpyxl

Pakete installieren (nur für die Konvertierung nötig)

python -m pip install pandas openpyxl

---

🛠️ Excel → JSON konvertieren

1. Lege die Datei Neuer_Arzttarif_Frage_Antwort_Spiel.xlsx im Projektstamm ab.

2. Führe das Skript aus:

   python excel_to_json.py

   Das Skript liest die Spalten Stichwort, Frage, Antwort_1 … 3, Korrekte_Antwort und legt/aktualisiert questions.json.

3. Starte anschließend das Spiel – das JSON wird vom Browser geladen.

Hinweis: Wenn Spalten fehlen oder der Dateiname abweicht, bricht das Skript mit einer Fehlermeldung ab.

---

🚀 Spiel starten

Da der Browser aus Sicherheitsgründen keine lokalen Dateien per fetch() lädt, solltest du einen kleinen Webserver nutzen:

# Im Projektordner
python -m http.server 8000

Danach im Browser http://localhost:8000 aufrufen und auf „Spiel und Quiz beginnen“ klicken oder direkt index.html im Browser öffnen, falls du alle Dateien auf einem Webserver hostest.

---

📝 Lizenz

Dieses Projekt steht unter der MIT‑Lizenz.