# Arsenal und Skins

## Ziel
Zehn unterschiedlich spielbare Waffen, Mündungsursprung, Frontschild und individuell gestaltbare Waffen ohne Backend. Bestehende Waffenmodelle bleiben die Basis; fünf Varianten erhalten eigene Anbauteile und Handlingprofile.

## Dateien und Klassen
- `scripts/weapons.gd` / Arsenal: Werte, Primärwaffenauswahl und Magazine.
- `scripts/weapon_variants.gd` / WeaponVariants: zusätzliche Modellgeometrie.
- `scripts/weapon_models.gd`, `weapon_geometry.gd`, `weapon_handling.gd`, `weapon_view.gd`: vollständige Modell-, Material- und Animationsimplementierung.
- `scripts/shot_origin.gd`, `combat.gd`, `rifle_projectile.gd`: Mündungsursprung und Treffer.
- `scripts/energy_shield.gd` / EnergyShield: Frontprüfung, Strahlblockade und Shader.
- `scripts/weapon_skins.gd` / WeaponSkins: acht Materialgruppen, Farben, beidseitige Beschriftung, Bereinigung und begrenzte LAN-Daten.
- `scripts/player_settings.gd`: lokale Designs in `user://settings.cfg`.
- `scripts/weapon_showcase.gd`, `ui.gd`: drehbare Vorschau, Skin-Editor und Account-Platzhalter.
- `scripts/fighter.gd`, `game.gd`: aktive Skins, Registrierung und Zustandssynchronisierung.

Der vollständige Code liegt direkt in diesen Projektdateien; zusätzliche Assets oder Pakete sind nicht nötig.

## Einbau und Bedienung
Projekt mit Godot 4.5 importieren oder im Git-Arbeitsordner `Start-Game.cmd` starten. LOADOUT öffnen, Waffe wählen oder WEAPON LAB aufrufen. Bauteil auswählen, Farbe ändern, optional Text eingeben und speichern. Primärwaffe im Loadout separat bestätigen. R lädt nach, B aktiviert das Schild. Ein gespeichertes Design gilt lokal sofort; andere LAN-Spieler erhalten es beim nächsten Beitritt.

## Tests
`tests/Run-Tests.ps1` führt auch `arsenal_shield.gd` und `skins.gd` aus. Diese prüfen Waffenwerte, Einzelschuss, Mündungs-/Wandprüfung, Schildrichtung, Dauer, Respawn und Snapshot sowie Instanzisolation, Textbegrenzung, Farben und Speicher-Roundtrip. Der Zwei-Prozess-Test `network_peer.gd` prüft zusätzlich die Übertragung eines AS12-Designs mit Beschriftung. `arsenal_visual.gd` erzeugt Screenshots von neuen Waffen, Editor, Titel und Schild; mit `--rendering-method gl_compatibility` ausführbar.

Manuell: jede Waffe schießen/nachladen/ADS testen, Schild von vorne und hinten beschießen, Design speichern und Spiel neu starten; mit zweitem LAN-PC die fremde Waffe ansehen. Physische LAN- und längere Performance-Tests stehen aus.

## Typische Fehler / Grenzen
- Vor Waffenwechsel im Editor speichern, sonst geht der Entwurf verloren.
- Schreibgeschützte Benutzerdaten verhindern dauerhafte Speicherung; der Editor meldet dies.
- Der Shop und die Anmeldung sind absichtlich deaktiviert. Es gibt noch keine Kontodaten oder Währung.
- Beschriftung sitzt fest am Gehäuse, wird für lange Texte verkleinert und ist kein frei verschiebbarer Aufkleber.
- Varianten sind eigene prozedurale Modelle auf gemeinsamen Waffenfamilien, keine fotorealistischen Scan-Assets.
- Beide LAN-PCs benötigen dieselbe Projektversion wegen der erweiterten Registrierung.

## Prüfstand 09.09.2026
Gesamte `Run-Tests.ps1`-Suite bestanden, inklusive separater Host-/Clientprozesse (Skins, Schild, Bewegung, Killcam und Seilaufzüge). Arsenal/Schild: 54/54; Skins: 47/47. Grafischer Durchlauf mit Compatibility-Renderer bestanden; Editor, Account-Platzhalter und neue Modelle anhand der erzeugten Bilder geprüft. Godot meldet in der eingeschränkten Testumgebung Zertifikats-/Shadercache-Schreibwarnungen, jedoch keine Skriptfehler im abschließenden Durchlauf.