saumwacht-godot/docs/luneraria/ANLEITUNG.md

Installation, Start, Steuerung und Export

Start aus dem Quellprojekt (Fedora 44)

cd saumwacht-godot
godot --path .                 # Champions of Luneraria (Hauptszene scenes/luneraria.tscn)
godot --path . -- --legacy     # archivierter Saumwacht-Modus (scenes/main.tscn)

Voraussetzung ist Godot 4.7.2. Blender wird nur zum Neuerzeugen von Assets gebraucht, nicht zum Spielen.

Eine Partie

1. Neue Partie → Bund (Glutpakt oder Wurzelbund) und deine Lane (Top, Mid, Bottom) wählen → Partie beginnen. Du spielst in Team Blau (Südwest) mit zwei Bot-Verbündeten gegen drei Bots in Team Rot.
2. Planung: Truppen kaufen (Knöpfe oder 1–5), mit T/M/B einer Lane zuweisen, mit ↑ aufwerten, mit × zurückgeben. Käufe aus derselben Planung werden voll erstattet, ältere mit 75 %. Startaufstellung kauft Front, Nahkampf und Fernkampf. Bereit (Leertaste) übernimmt alle Befehle verbindlich.
3. Kampf: Er läuft automatisch. Deine Truppen rücken mit der eigenen Monsterwelle über ihre Lane vor. Leertaste oder P pausiert, Tempo 1×/2×/4×.
4. Abrechnung: Getötete Monster und Gebäude bringen Gold, dazu kommt das Rundeneinkommen. Deine Truppen kehren geheilt zurück. Türme und Kerne behalten ihren Schaden.
5. Die Partie endet erst, wenn ein Ancient fällt. Es gibt kein Rundenlimit.

Steuerung

Eingabe	Wirkung
1–5	Truppe kaufen (Planung)
Leertaste	Bereit / im Kampf Pause
P	Pause
WASD, Pfeiltasten, mittlere Maustaste ziehen	Kamera verschieben
Mausrad	Zoom
Tab / Lane-Knöpfe links	Kamera auf die nächste Lane
O	Kartenübersicht
Minimap klicken/ziehen	Kamera springt dorthin
F1	Optionen und Steuerung
M / F11	Ton / Vollbild

Prüfungen

godot --headless --path . res://tests/luneraria/test_lune_core.tscn        # Regeln M1 (91, inkl. Spiegeltest)
godot --headless --path . res://tests/luneraria/test_lune_m2.tscn          # Regeln M2 (73)
godot --path . --resolution 1280x720  res://tools/luneraria/verify_m1.tscn # echte Bedienung, volle Partie (38)
godot --path . --resolution 1920x1080 res://tools/luneraria/verify_m2.tscn # Helden, Items, Grotte, Boss (15)
godot --headless --path . res://tools/luneraria/sim_match.tscn -- --seeds=1,2,3 --limit=80
godot --headless --path . res://tools/luneraria/balance_run.tscn -- --compositions=20 --limit=60 --out=res://docs/luneraria/logs/m3/balance.json
godot --headless --path . res://tools/luneraria/balance_run.tscn -- --matchups --limit=60 --out=res://docs/luneraria/logs/m3/matchups.json
python3 tools/luneraria/analyze_balance.py docs/luneraria/logs/m3/balance.json
godot --headless --path . res://tools/luneraria/stress_run.tscn            # Wellen bis 10^6, Langlauf
godot --path . res://tools/luneraria/people_lineup.tscn -- --out=res://docs/luneraria/screenshots
godot --path . --resolution 1920x1080 res://tools/luneraria/lune_benchmark.tscn
godot --path . --resolution 1920x1080 res://tools/luneraria/lune_review.tscn # Aufnahmen
# Legacy (Saumwacht) unverändert:
godot --headless --path . res://tests/test_runner.tscn
godot --headless --path . -- --smoke-test
godot --headless --path . -- --faction-test
godot --headless --path . -- --expedition-test

verify_m1 und verify_m2 brauchen ein Fenster (echte Maus-/Tastaturereignisse), nicht --headless.

Assets neu erzeugen

ALSOFT_DRIVERS=null blender -b --python-exit-code 1 --python assets-source/luneraria/build_tower.py
ALSOFT_DRIVERS=null blender -b --python-exit-code 1 --python assets-source/luneraria/build_grotto.py
ALSOFT_DRIVERS=null blender -b --python-exit-code 1 --python assets-source/luneraria/build_map_props.py
ALSOFT_DRIVERS=null blender -b --python-exit-code 1 --python assets-source/luneraria/build_peoples.py
python3 tools/luneraria/build_asset_matrix.py
godot --headless --editor --import --path .

Export

Die Pakete für Champions of Luneraria kommen mit M4. Bis dahin baut tools/build_demo.py weiterhin die Saumwacht-Demo 0.15.0.

Benutzereinstellungen

Der neue Projektname legt einen neuen Benutzerordner an (~/.local/share/godot/app_userdata/Champions of Luneraria). Beim ersten Start übernimmt Preferences einmalig die preferences.cfg aus „Saumwacht · Glutpakt“. Die alte Datei bleibt unverändert; fehlt sie, gelten die Standardwerte.