Controller-Fix: Joystick-Objekte wurden nach dem Namens-Auslesen freigegeben, dadurch lieferte SDL keine Events mehr. Jetzt offen halten + Hotplug. Neu: tools/controller_check.py zur Diagnose, Tests fuer Tastenbelegung (62).

MAC-START.md

@@ -153,7 +153,30 @@ Spiel läuft dann mit der Tastatur weiter.
 * **Bluetooth:** Systemeinstellungen → Bluetooth → Controller koppeln. Geht,
   ist am Stand aber störanfälliger (Akku, Reconnects).
 * **Microsofts Xbox-Funk-Dongle** funktioniert auf macOS **nicht**.
-* Der Name des erkannten Controllers steht nach dem Start im Terminal.
+* Der Controller muss vor dem Spielstart verbunden sein. Wird er später
+  verbunden, erkennt das Spiel ihn automatisch und schreibt es ins Terminal
+  (`Controller: Xbox Series X Controller`).
+
+### Wenn der Controller erkannt wird, aber keine Taste reagiert
+
+Diagnose starten:
+
+```bash
+.venv/bin/python tools/controller_check.py
+```
+
+Dann A, X, Y und das D-Pad drücken. Das Fenster zeigt jede Taste, die ankommt:
+
+* **Es erscheinen Zeilen** wie `Taste 0 gedrückt` und `→ Spiel-Aktion: PRIMARY`
+  → die Eingabe kommt an; dann bitte die Ausgabe melden, es liegt dann an der
+  Tastenbelegung.
+* **Es erscheint gar nichts** → macOS reicht die Controller-Eingabe nicht an
+  das Terminal weiter. Prüfen unter *Systemeinstellungen → Datenschutz &
+  Sicherheit → Eingabeüberwachung* (bei älteren macOS-Versionen
+  *Bedienungshilfen*), ob **Terminal** (bzw. iTerm / VS Code) erlaubt ist –
+  danach das Terminal neu starten.
+* Bei Bluetooth zusätzlich: Controller entkoppeln, neu verbinden, oder einfach
+  das USB-Kabel verwenden.
 
 ---