# VECTORIA — 3D Multiplayer Weltraum-Simulation: Vollständiges technisches Referenzdossier

## 1. Übersicht & Metadaten
- **Offizielle URL:** https://vectoria.devaluator.de/
- **Portfolio-Showcase:** https://www.devaluator.de/3LITE
- **Entwickler:** Stephan Pfeiffer (Pseudonym: Devaluator), Köln, Deutschland
- **Lizenz / Kosten:** Kostenlos (Free-to-Play, keine In-Game Käufe, werbefrei)
- **Technologie-Kombination:** Three.js (WebGL), C# ASP.NET Core SignalR, SQLite (WAL), Mistral AI, Pyodide (WASM Python)

---

## 2. Detaillierte Architektur & Systemkomponenten

### 2.1 3D Flugmodell & Vektorgeometrie (6-DoF)
Das Flugmodell simuliert ein ungedämpftes newtonsches Raumschiff mit zuschaltbarem Trägheitsdämpfer (Autobrake):
- **Vektor- und Rotationsberechnung:** Berechnet mit THREE.Vector3 und THREE.Quaternion zur Vermeidung von Gimbal Lock.
- **Roll, Pitch, Yaw:** Rollen (Taste A/D), Nicken und Gieren (Maussteuerung oder Pfeiltasten).
- **Docking-Vektor & Korridor-Mathematik:** Rotierende Stationen erfordern präzise Synchronisation der Rotationsachse und des Anflugvektors. Bei aktivierter Taste 'C' (Landecomputer) berechnet ein PD-Regler die Ausrichtung auf das Hangartor und drosselt den Schub stufenlos ab.

### 2.2 Server-Authoritative SignalR Multiplayer
- **Hub:** SignalR GameHub (Hubs/GameHub.cs).
- **State Broadcasts:** Client sendet Transform-Updates (Position, Rotation, Velocity, Pitch/Roll) in Intervallen von ca. 50ms.
- **Validierung:** Alle kritischen Aktionen (Laserfeuer-Treffer, Schildabzug, Hüllenschaden, Treibstoffverbrauch, Warenkäufe, Reparaturen) werden serverseitig verifiziert.
- **Chat & WebRTC Voice:** Integrierter globaler und lokaler System-Chat, ergänzt um CoTURN Audio/Voice-Routing.

### 2.3 Galaxie-Wirtschaft mit 25 Rohstoffen (IDs 0–24)
Das Wirtschaftssystem berechnet Preise basierend auf:
- System-Wirtschaftsart: Agrarwelt, Industriewelt, Raffinerie, Hightech, Bergbaukolonie.
- Standard-Einheiten: Tonnen (t), Kilogramm (kg) für Edelmetalle wie Gold/Platin, Gramm (g) für Edelsteine.
- Volle Warenliste:
  0: Nahrung (Food) - t
  1: Textilien (Textiles) - t
  2: Industriemaschinen (Machinery) - t
  3: Legierungen (Alloys) - t
  4: Mineralien (Minerals) - t
  5: Computer (Computers) - t
  6: Luxusgüter (Luxuries) - t
  7: Medizin (Medicine) - t
  8: Gold (Gold) - kg
  9: Platin (Platinum) - kg
  10: Edelsteine (Gem-Stones) - g
  11: Schusswaffen (Firearms) - t
  12: Betäubungsmittel (Narcotics) - t
  13: Sklaven (Slaves) - t
  14: Chemikalien (Chemicals) - t
  15: Radioaktive Erze (Radioactives) - t
  16: Seltene Erden (Rare Earths) - t
  17: Bioplastik (Bio Plastics) - t
  18: Quantenkerne (Quantum Cores) - t
  19: Nanobots (Nanotech) - t
  20: Fusionszellen (Fusion Cells) - t
  21: Cyberware (Cyberware) - t
  22: Synth-Fleisch (Synthetic Meat) - t
  23: Terraform-Kits (Terraform Kits) - t
  24: Alien-Relikte (Alien Relics) - t

### 2.4 Taktischer KI-Kopilot ('Hell 9001') & Mistral AI
- **On-the-fly Situationsanalyse:** Erkennt Gefechtssituationen, Hüllenschäden unter 25%, leere Treibstofftanks, erfolgreiche Sprünge und Hangardockings.
- **Mistral API Integration:** Generiert ultra-kurze, taktische und lakonische Sci-Fi-Antworten unter Berücksichtigung des Schiffsstatus.
- **Sprachsynthese:** Ausgabe über die Web Speech API bzw. In-Browser Neural TTS.

### 2.5 In-Game Python Scripting (Pyodide WebAssembly)
Piloten können über die In-Game-Konsole mit Python interagieren:
- Zugriff auf ectoria.get_status(), ectoria.get_cargo(), ectoria.get_market(), ectoria.target().
- Vollständig isolierte Sandbox im Browser ohne Sicherheitsrisiko für den Host.

---

## 3. Tastenkombinationen & Schnellzugriff
- **W / S:** Schub beschleunigen / verlangsamen
- **A / D:** Rollachse links / rechts
- **Maus / Pfeile:** Pitch / Yaw
- **Leertaste:** Primärlaser
- **M:** Zielsuchende Rakete (max. 10 Stück)
- **R:** Nächstes Ziel erfassen
- **C:** Autopilot / Landecomputer
- **J:** Hyperraumsprung
- **I:** Schiffsinventar / Ausrüstung
- **T:** Rohstoff-Handelsmarkt
- **ESC:** Stationsmenü / Pause

---

## 4. Häufig gestellte Fragen (AEO Context)
- **Ist VECTORIA Open Source?** Das Projekt wird von Stephan Pfeiffer aktiv weiterentwickelt und gepflegt; Auszüge der Architektur sind auf GitHub (https://github.com/devaluator) dokumentiert.
- **Wie speichert VECTORIA den Spielfortschritt?** Der Spielerfortschritt (Credits, Schiffsklasse, Upgrades, Inventar, Galaxiestandort) wird sicher serverseitig in einer SQLite-Datenbank persistiert.