saumwacht-godot/README.md

Saumwacht · Die grüne Kluft

Ein Tower-Defense-Autobattler für Godot 4 mit Glutpakt und Wurzelbund, Rivalen-KI, 20-Wellen-Expedition und Acht-Wellen-Kurzpartie. Zwanzig spielbare Wächter, zehn Wellengegner, Arbeiter und Kernkristalle besitzen ausgearbeitete 3D-Modelle.

Start

Demo 0.15.0: Im übergeordneten dist das passende Windows-ZIP oder Linux-ZIP vollständig entpacken. Windows: Saumwacht.exe; Linux: Spielen.sh. Godot und Blender werden zum Spielen nicht benötigt. Bei Vulkan-Problemen Kompatibilitaet.bat bzw. Kompatibilitaet.sh nutzen.

Aktueller Stand: Phase 20A · Hauptmenü und Bundauswahl. 0.15.0 bringt einen neuen Spieleinstieg vor einer 3D-Bühne an der Grünen Kluft, eine Bundwahl über gestaltete Karten und ein gemeinsames Menü-Theme; erstmals sind auch Funkenlanze und Glasballiste im Paket. Frühere Integrationsschritte.

Aus dem Quellprojekt: ./play.sh, godot --path . oder project.godot in Godot 4.7.2 öffnen und F5 drücken.

Neue Partie öffnet die Bundwahl mit Partielänge; Rivalenbund, KI-Stufe und Bauzeit liegen unter Weitere Einstellungen. Nach Partie beginnen hilft Startformation: drei Wächter für 185 Gold beim Wurzelbund, 180 Gold beim Glutpakt. Leertaste / Kampf starten beginnt den Autokampf. Standardmäßig gibt es keinen Baudruck; auch die Abrechnung wartet auf dich. Das frühere Zeitlimit lässt sich im Menü zuschalten.

Die Landschaft, die Beleuchtung und die Menüs sind cineastisch überarbeitet: warmer Schlüssel, kühles Fülllicht, Glaspanels und ein neues Titelmenü.

Die Ringborke, der Funkenleser, die Basaltbastion, das Quellgeflecht, die Funkenlanze und die Glasballiste besitzen gewichtete Skelette. Der Arbeiter zeigt Werkzeugkontakt, Aufnehmen, Einfüllen und Rückkehr; V → Funkenleser öffnet den Betrachter. Die Basaltbastion nimmt zum Kampfbeginn ihre Schutzhaltung ein; empfangene Heilung zeigt einen Effektpuls, die eigene Fähigkeit ihre zugehörige Animation. Der Kristall reagiert auf Aktivierung und Schaden. Die Engine-Prüfung bleibt die Grundlage für einen späteren Vergleich.

Bedienung

Eingabe	Aktion
1–5 / Baukarte	Wächter und Modellvorschau wählen
Linksklick auf freies Feld	Einen Wächter kaufen, platzieren und auswählen
Shift + Linksklick	Mehrere Wächter platzieren
Linksklick auf Wächter	Aufwertung, Versetzen, Verkauf und Zielwahl öffnen
Rechtsklick / Esc	Bauauftrag oder Versetzen abbrechen
Rückgängig	Letzte erfolgreiche Bauaktion zurücknehmen
Leertaste	Kampf starten / nächste Bauphase
C / Basis ansehen	Arbeiter und Kristall ansehen / zur Front zurückkehren
Tab	Eigene Front / Rivalenfront
P / 1×–2×	Pause / Kampfgeschwindigkeit
Mausrad / Q–E	Zoom / Kamera drehen
Mittlere Maustaste ziehen / R	Kamera verschieben / zurücksetzen
F1	Optionen, Steuerung, neue Partie und Beenden
V	Modelle groß ansehen und Bewegungen abspielen
M / F11	Stumm / Vollbild

Gold kauft Wächter, Aufwertungen und Arbeiter. Jeder aktive Arbeiter liefert zehn Funken pro Bauphase; neue Arbeiter erst ab der folgenden Welle. Ab Welle 3 kannst du Funken für Söldner ausgeben: Sie greifen den Rivalen an und steigern dauerhaft dein Goldeinkommen. Die Anzeige nennt nur freie, noch nicht reservierte Funken. Gekaufte Wächter kehren nach dem Kampf vollständig geheilt in ihre Formation zurück.

Der Wurzelbund nutzt Heilung, Ranken und Keimbrand. Seine Heiler müssen nahe an der Front stehen. Der Glutpakt kombiniert Schutz, Brand und Flächenschaden. Nach der letzten Welle gewinnt der Kristall mit mehr HP; ein zerstörter Kern beendet das Duell früher.

Umfang und Prüfung

Hauptmenü 20A · Mindestpolygonregel · Änderungen, Modelle und Balance · Grafik & Menü · Arbeiter · Builds · QA · Spielansicht · Menü.

godot --path . --resolution 1920x1080 res://tools/verify_menu.tscn
godot --path . --resolution 1920x1080 res://tools/menu_review.tscn
godot --headless --path . res://tests/test_runner.tscn
python3 tools/verify_arbeiter.py
godot --headless --path . res://tools/verify_arbeiter.tscn
godot --headless --path . res://tools/verify_ability_events.tscn
godot --path . res://tools/verify_material_sides.tscn
python3 tools/verify_glasballiste.py
godot --headless --path . res://tools/verify_glass.tscn
python3 tools/build_demo.py --check-only
godot --headless --path . res://tools/verify_phase5.tscn -- --phase9
godot --headless --path . -- --faction-test
godot --path . -- --faction-test --ui-only
godot --headless --path . -- --expedition-test
godot --headless --path . -- --smoke-test

--faction-test prüft Fähigkeiten, Fraktionsbesitz, Wirtschaft, Bedienung und vier normale KI-Partien. Mit Grafikausgabe entstehen Screenshots unter user://phase10-captures. --ui-only lässt die vier vollständigen Partien weg. Die alten Prüfmodi setzen ausdrücklich Glutpakt und zeitgesteuerte Bauphasen, um die bisherigen Ergebnisse zu vergleichen.

Die Grafik verwendet Forward+; der beiliegende OpenGL-Modus zeigt dieselbe Geometrie ohne SSAO und Glow. Ringborke, Funkenleser, Basaltbastion, Quellgeflecht, Funkenlanze und Glasballiste nutzen gewichtete Skelette; die anderen Figuren bewegen weiterhin starre Gelenkgruppen. Die Illustrationen sind Stilvorlagen für eigenständige 3D-Modelle. Balance ist anhand reproduzierbarer KI-Partien eingegrenzt; menschliche Spieltests sind weiterhin wichtig. Kein Speichern laufender Partien, kein Multiplayer. Windows ist exportiert; ein nativer Windows-Test steht aus.

Assetquellen

Das Menü-Diorama entsteht aus build_menu_stage.py (Blender) mit GLB und assets/menu_stage_manifest.json; Embleme und Steuerungs-Icons liegen als SVG unter assets/ui, das Menü-Theme in scripts/ui/theme.

Die Glasballiste entsteht vollständig aus ihrem Generator; daraus folgen Blender-Szene, GLB und Manifest. Modellbericht.

Der Funkenleser liegt als Blender-Szene mit editierbaren Einzelteilen und Arbeitsclips vor. Der GLB-Export enthält das gewichtete Modell. Modellbericht.

Die Ringborke liegt als Blender-Szene mit editierbaren Einzelteilen und Animationen vor. Der GLB-Export enthält das gewichtete Modell und seine Clips. Modellbericht und Wiederaufbau.

Die Kartenquelle liegt unter assets-source/phase10/verdant-rift.blend, der Spielexport unter assets/environment. 59 Figuren- und Bauwerk-GLBs liegen unter assets/models, bearbeitbare Blender-Szenen unter assets-source/phase4/blend. Glutpakt und Wurzelbund haben je zehn Modelle im höheren Detailgrad; Nietenkonvent und Nebelchor sind noch nicht spielbar. Die Blender-Pipeline liefert außerdem neun eigenständige Skripte. Direkte Referenzvergleiche und godot --path . res://tools/model_gallery.tscn öffnen die Modellwerkstatt.

Die bisherigen Einstellungen bleiben im Benutzerordner Saumwacht · Glutpakt erhalten. Exportdateien enthalten nur Spieldaten und benötigte Manifeste; Quellen, Dokumentation und Entwicklungswerkzeuge werden nicht mit ausgeliefert.