Habegger Trailer Load

Kofferlager-Spiel für Messe-/Eventbetrieb: Koffer laufen von rechts ein und müssen im Auflieger möglichst dicht gestapelt werden. Angezeigt wird am Ende die Stufe und die erreichte Beladung in Prozent.

Neu aufgesetzt für macOS (Apple Silicon) mit Controller-Unterstützung. Die Analyse des Altstands und die Liste der behobenen Fehler stehen in docs/ANALYSE.md.

Voraussetzungen

• Python 3.10 oder neuer (getestet: 3.12)
• macOS oder Linux – sonst nichts. pygame bringt SDL2 selbst mit, Kamera-, Brew- oder Systembibliotheken werden nicht gebraucht.

Start

./run.sh                 # Fenster
./run.sh --fullscreen    # Vollbild (Eventbetrieb)

run.sh legt beim ersten Start .venv/ an und installiert requirements.txt automatisch. Ändert sich requirements.txt, wird neu installiert.

Auf macOS lässt sich das Spiel auch per Doppelklick auf run.command starten (beim ersten Mal ggf. Rechtsklick → Öffnen wegen Gatekeeper).

Option	Bedeutung
--fullscreen	Vollbild starten (F11 schaltet jederzeit um)
--seed 42	feste Zufallsfolge, reproduzierbare Koffer-Sequenzen
--smoke 10	Selbsttest: spielt 10 s ohne Eingaben und beendet sich

Ablauf

1. Tutorialbild (nur beim Programmstart) – weiter mit A / Space
2. Stufenauswahl: Easy / Normal / Hard (Hard = Tempo des Altstands)
3. Ampel-Start (rot/gelb/grün + Reissverschluss), dann läuft die Runde
4. Ergebnis: Stufe und Beladung in Prozent, „Nochmals?" → A startet neu bei der Stufenauswahl

Beendet wird ausschliesslich mit Esc (Controller: B).

Steuerung

Aktion	Tastatur	Controller (Xbox-Layout)
Stufe wählen	← / →	D-Pad links/rechts
Bestätigen / Einrasten an der Barriere	Space / Enter	A
Koffer drehen (wenn er passt)	←	X / D-Pad links
Auf einen Koffer obendrauf setzen	↑	Y / D-Pad hoch
Beenden	Esc	B
Vollbild umschalten	F11	–

Ein gedrehter Koffer behält seine Grafik – er wird nur um 90° gedreht gezeichnet, nie durch eine andere Textur ersetzt.

Projektstruktur

main.py                 Einstiegspunkt (Phasen: Intro → Menü → Runde)
run.sh / run.command    Start inkl. venv + Installation
requirements.txt        pygame
case_sequences.txt      Koffersequenzen (Datenbestand)
loader_game/
  config.py             Masse, Farben, Texte, Pfade
  difficulty.py         Stufen Easy/Normal/Hard (Tempo)
  assets.py             Bilder/Sounds/Fonts laden und cachen
  sequences.py          Einlesen und Validieren der Sequenzdatei
  case.py               Koffer: Geometrie, Textur, Bewegung
  trailer.py            Stapelregeln im Auflieger (reine Logik)
  input_map.py          Tastatur/Controller → Action
  scene.py              Zeichnen
  menu.py               Stufenauswahl
  intro.py              Tutorialbild, Ampel, Reissverschluss
  game.py               Zustandsmaschine einer Runde
tests/test_logic.py     48 Tests (ohne Fenster)
docs/ANALYSE.md         Analyse Altstand + Fehlerliste
old_version/            eingefrorener Altstand (nicht versioniert)

Konfiguration

Alle Werte stehen in loader_game/config.py (Layout, Farben, Texte, Tempo der Animationen) und loader_game/difficulty.py (Einlaufgeschwindigkeit der drei Stufen). Gezeichnet wird immer in der virtuellen Auflösung 1920×1080; pygame.SCALED skaliert automatisch auf die tatsächliche Fenstergrösse (Retina, 1440×900, 4K …).

Sequenzdatei

case_sequences.txt: Sequenzen durch Leerzeilen getrennt, pro Zeile ein Koffer als breite,höhe,rotiert in Einheiten von 100×100 Pixeln. rotiert=True dreht den Koffer beim Einlaufen um 90°.

3,1,False
1,2,True     # effektiv 2 Einheiten breit, 1 hoch

Ungültige Zeilen werden beim Start mit Meldung übersprungen.

Tests

.venv/bin/python -m unittest discover -s tests -v

Getestet werden Sequenz-Parsing, Layout-Invarianten, Kofferbewegung (inkl. Stufen-Tempo), Stapelregeln, Menü-Navigation, komplette Spieldurchläufe bis zum Ergebnis sowie das Rendern von Intro, Menü, Spiel und Ergebnis. Kein Fenster, kein Ton nötig.

Eingefrorener Altstand

old_version/ enthält die Dateien vor dem Umbau – in .gitignore, also nicht versioniert. Details: old_version/FROZEN.md.

Nächste Schritte

1. Namenseingabe direkt am Controller (Buchstabe für Buchstabe, alternativ Tastatur) – falls wieder eine Personalisierung gewünscht ist.
2. Entscheiden, ob und wohin Ergebnisse gesendet werden (Punkteliste ist derzeit bewusst nicht vorhanden).