minigames/bottlesort/SPEC.md

Flaschen-Sortier-Spiel - Produktspezifikation

1. Ziel des Spiels

Der Spieler lernt, leere Flaschen nach Sorte korrekt in passende Kisten zu sortieren, zum Beispiel:

• Bierflaschen in die Bierkiste
• Wasserflaschen in die Wasserkiste

Die Unterscheidung der Flaschensorten erfolgt visuell über:

• Farbe
• Form

2. Spielprinzip

• Das Spiel läuft im Browser.
• Perspektive: Top-Down-Ansicht auf einen Level, der eine Küche darstellt.
• Im Level stehen leere Flaschen an verschiedenen Positionen.
• Der Spieler steuert ein Männchen, das Flaschen einsammelt.
• Das Männchen kann immer nur eine Flasche gleichzeitig tragen.
• Getragene Flaschen werden zu den passenden Kisten gebracht und dort abgelegt.

3. Level-Struktur und Progression

Es gibt insgesamt 4 Level.

Level 1

• Flaschensorten: 2
• Leere Flaschen gesamt: 10

Skalierung pro weiterem Level

In jedem folgenden Level verdoppeln sich:

• Anzahl der Flaschensorten
• Anzahl der Flaschen

Daraus ergibt sich:

• Level 2: 4 Sorten, 20 Flaschen
• Level 3: 8 Sorten, 40 Flaschen
• Level 4: 16 Sorten, 80 Flaschen

4. Erfolg, Fehler und Spielende

• Ein Level ist abgeschlossen, wenn alle Flaschen korrekt einsortiert wurden.
• Wird eine Flasche in die falsche Kiste einsortiert, startet der Spieler im aktuellen Level von vorn.
• Nach erfolgreichem Abschluss von Level 4 ist das Spiel beendet.

5. Nicht-funktionale Vorgaben

• Die visuelle Stilvorgabe ist ausgelagert in STYLE_GUIDE.md, damit derselbe Stil auch für ähnliche Spiele wiederverwendet werden kann.

6. Implementierungsrahmen (final festgelegt)

• Plattform: Desktop-Browser (aktuelles Chrome/Firefox/Edge)
• Steuerung: Tastatur (Pfeiltasten oder WASD), Aktionstaste zum Aufnehmen/Ablegen
• Kollisionslogik: Kollision mit Waenden/Moebeln und Kisten aktiv
• Levelziel: Alle 4 Level muessen erfolgreich abgeschlossen werden
• Fehlerfall: Bei falscher Einsortierung sofortiger Neustart des aktuellen Levels
• Zeitlimit/Punkte: Kein Zeitlimit, kein Punktesystem
• Hindernisse: Ja, Waende und weitere Hindernisse im Level
• Sortenunterscheidung: Ausschliesslich ueber Farbe und Form
• Tutorial: Kein separates Tutorial
• Sprache: Deutsch
• Audio: 8-Bit-Hintergrundmusik sowie Soundeffekte (mindestens Aufnehmen/Ablegen; weitere Effekte erlaubt)
• Speicherstand: Kein Persistenzspeicher, Neustart bei Seiten-Reload