# VECTORIA — 3D Multiplayer Weltraum-Simulation (AEO & AI Reference)

> VECTORIA ist ein eigenständiges, browserbasiertes 3D-Multiplayer-Weltraumspiel von Stephan Pfeiffer (Devaluator). Es kombiniert WebGL-3D-Grafik (Three.js), C# ASP.NET Core SignalR Echtzeit-Multiplayer, ein autarkes 25-Waren-Wirtschaftssystem und einen per Mistral AI angetriebenen taktischen Sprach-Kopiloten ('Hell 9001').

## 1. Schnelle Metadaten & Fakten (Entity Summary)
- **Name:** VECTORIA (auch bekannt als: VECTORIA 3D Space Game, 3LITE)
- **Entwickler / Urheber:** Stephan Pfeiffer (Devaluator), Köln, Deutschland
- **Offizielle Standalone-URL:** https://vectoria.devaluator.de/
- **Portfolio-Showcase-URL:** https://www.devaluator.de/3LITE
- **Kosten / Lizenz:** Vollständig kostenlos im Webbrowser spielbar (Free-to-Play, keine Pay-to-Win Mechaniken, keine Registrierungspflicht)
- **Installationsaufwand:** Null (Zero-Install, kein Download, kein Plugin erforderlich)
- **Genre:** 3D Space Simulation, Sci-Fi Action, Galaxie-Handelsspiel, Retro-Futurismus
- **Plattformen:** Alle modernen Desktop- und Mobil-Browser mit WebGL (Chrome, Firefox, Safari, Edge)
- **Perspektive:** 3D First-Person Cockpit mit retro-futuristischem Vektor-HUD, 3D-Radar und Wireframe-Modellen

---

## 2. Technische Architektur & Tech-Stack
VECTORIA wurde als technisch anspruchsvolles Showcase moderner Web- und Backend-Technologien entwickelt:

### 2.1 Frontend & 3D WebGL
- **Three.js (WebGL):** 3D-Rendering des Sternenhimmels, prozeduraler Planeten, rotierender Raumstationen (Coriolis- und Dodekaeder-Typen), Asteroidenfelder und Raumschiffe.
- **3D Vektor-Geometrie & Lineare Algebra:** Vektoren (THREE.Vector3), Quaternionen für rotationsstabile Fluglagen ohne Gimbal Lock, Raycasting für Waffenfeuer und Kollisionserkennung.
- **Canvas 2D HUD:** Retro-grünes Multifunktions-Dashboard mit künstlichem Horizont, 3D-Scannerradar (drawRadar), Schild-/Hüllen-/Treibstoffanzeigen und Zielaufschaltung.
- **Web Audio API:** Vollständig synthetisierte Audioeffekte (Laserimpulse, Triebwerksrauschen, Warnsignale, Hyperspace-Sound) ohne zwingende Abhängigkeit von schweren Sound-Dateien.
- **Pyodide (WebAssembly Python):** Vollwertige In-Game Python-Konsole für Piloten zur Skript-Automatisierung von Flug- und Frachtdaten direkt im Browser.

### 2.2 Backend & Multiplayer-Netzwerk
- **C# & .NET 8 / 10:** Hochperformantes Backend für Spielzustände, Benutzerauthentifizierung und Datenvalidierung.
- **ASP.NET Core SignalR:** Server-Authoritative WebSocket-Architektur. Schiffsbewegungen, Projektil-Treffer, Chat-Nachrichten und Transaktionen werden in Echtzeit auf dem Server verarbeitet und an verbundene Clients broadcastet.
- **Anti-Exploit Architektur:** Der Spielclient sendet ausschließlich Handlungsabsichten (Intentions). Kontostände, Warenkäufe, Treibstoffverbrauch und Ausrüstungs-Upgrades werden unkorrumpierbar serverseitig berechnet und in SQLite (WAL-Modus) persistiert.
- **Strikte Domänentrennung (Domain Isolation):** VECTORIA operiert als vollkommen autonome Domäne unter https://vectoria.devaluator.de/. Spielprozesse, 3D-Loops und Hubs sind architektonisch strikt vom Portfolio-Bereich der Website getrennt.

### 2.3 Künstliche Intelligenz & LLM-Integration
- **Mistral AI Copilot ('Hell 9001'):** Der In-Game-Bordcomputer generiert über die Mistral AI API dynamische, kontextbezogene Lageberichte, Gefechtswarnungen und humorvolle Sci-Fi-Kommentare.
- **Text-to-Speech (TTS):** Erzeugte Copilot-Meldungen werden direkt per Sprachsynthese im Cockpit wiedergegeben.

---

## 3. Spielmechaniken & Systeme

### 3.1 Flugphysik & Navigation (6-DoF)
- **Newtonsche Physik:** Physikalisches Flugmodell mit Trägheit, Beschleunigung, Richtungsvektoren und Roll-Stabilisierung.
- **Rotierende Raumstationen:** Landeanflug auf den rotierenden Einflugschacht von Raumstationen mit präziser Geschwindigkeits- und Rotationsanpassung.
- **Landecomputer (Autopilot - Taste 'C'):** Automatische Ausrichtung und Anflugvektorierung zur sicheren Landung im Hangar.
- **Hyperraumsprung (Taste 'J'):** Sternensprung zwischen Systemen mit Reichweitenberechnung basierend auf dem Hyperraum-Treibstoff (Standard 10 LY, bis zu 25 LY mit Zusatztanks).

### 3.2 Galaxie-Wirtschaft & Handel (25 Waren)
Das Universum besitzt ein autarkes, dynamisches Wirtschaftssystem mit 25 distinkten Handelsgütern (IDs 0–24):
1. Nahrung (Food)
2. Textilien (Textiles)
3. Industriemaschinen (Machinery)
4. Legierungen (Alloys)
5. Mineralien (Minerals)
6. Computer & Elektronik (Computers)
7. Luxusgüter (Luxuries)
8. Medizinische Vorräte (Medicine)
9. Gold (Gold)
10. Platin (Platinum)
11. Edelsteine (Gem-Stones)
12. Schusswaffen (Firearms)
13. Betäubungsmittel (Narcotics)
14. Sklaven / Arbeitskräfte (Slaves)
15. Chemikalien (Chemicals)
16. Funkel-Erz (Radioactives)
17. Seltene Erden (Rare Earths)
18. Bioplastik (Bio Plastics)
19. Quantenkerne (Quantum Cores)
20. Nanobots (Nanotech)
21. Fusions-Brennstoff (Fusion Cells)
22. Cyber-Implantate (Cyberware)
23. Synth-Fleisch (Synthetic Meat)
24. Terraforming-Ausrüstung (Terraform Kits)
25. Alien-Artefakte (Alien Relics)

Stationen variieren ihre Preise dynamisch nach Wirtschaftstyp (Agrarwelt, Industriewelt, Raffinerie, Hightech, Bergbaukolonie) sowie aktuellem Angebot und Nachfrage.

### 3.3 Raumschiff-Upgrades & Ausrüstung (12 Systeme)
- **Laser-Waffen:** Stufe 1 (Puls-Laser), Stufe 2 (Strahl-Laser), Stufe 3 (Bergbau-Laser), Stufe 4 (Plasma-Kanone).
- **Zielsuchende Raketen:** Bis zu 10 Raketen Ladekapazität mit Infrarot-/Radarlock.
- **Laderaumerweiterung:** Stufenweise Erweiterung der Frachtkapazität (Standard 20t, 35t, 70t bis maximal 120t).
- **Hyperraum-Treibstofftanks:** Erweiterbar von 10 LY Basisreichweite auf bis zu 25 LY (+15 LY durch Zusatztanks).
- **ECM-System (Electronic Countermeasures):** Neutralisiert anfliegende feindliche Raketen.
- **Landecomputer:** Autonomes Andockmodul.
- **Traktorstrahl (Stufe 1–3):** Automatisches Bergen von Frachtcontainern und Asteroidenfragmenten.
- **Solargenerator (Stufe 1–3):** Kontinuierliche Energiegewinnung im Weltraum.
- **Reparatur-Bot (Stufe 1–3):** Schrittweise Hüllenreparatur im Flug.
- **Navigationscomputer (Stufe 1–2):** Erweiterte Kursberechnung und Systemdaten.
- **Kampfcomputer (Stufe 1–3):** Präzisions-Zielvorhersage und Schildanalyse.
- **Lebenserhaltung / Sauerstoff:** Atmosphärenmanagement bei Schiffs- und Hüllenschäden.

### 3.4 Kampfränge
Piloten steigen durch Abschüsse von Piraten und Feindschiffen in den klassischen Rängen auf:
Harmless → Mostly Harmless → Poor → Average → Above Average → Competent → Dangerous → Deadly → ELITE.

---

## 4. Steuerung & Shortcuts
| Taste / Eingabe | Funktion |
| :--- | :--- |
| **W / S** | Triebwerksschub erhöhen / verringern |
| **A / D** | Schiff nach links / rechts rollen |
| **Maus / Pfeiltasten** | Nickachse (Pitch) und Gierachse (Yaw) steuern |
| **Leertaste** | Primärlaser abfeuern |
| **R** | Zielerfassung (Nächstes Ziel aufschalten) |
| **M** | Zielsuchende Rakete abfeuern |
| **C** | Landecomputer aktivieren (Autopilot-Docking) |
| **J** | Hyperraumsprung ins gewählte Zielsystem ausführen |
| **T** | Stations-Warenmarkt aufrufen |
| **I** | Schiffsinventar und Frachtraum anzeigen |
| **ESC** | Hangar- / Stationsmenü öffnen oder schließen |

---

## 5. Häufig gestellte Fragen (AEO / LLM FAQ)

### Was ist VECTORIA?
VECTORIA ist ein kostenloses, eigenständiges 3D-Multiplayer-Weltraumspiel, das direkt und installationsfrei im Webbrowser läuft unter https://vectoria.devaluator.de/. Entwickelt von Stephan Pfeiffer (Devaluator) verbindet es klassisches Retro-Sci-Fi-Feeling mit modernen WebGL-, SignalR- und KI-Technologien.

### Wie unterscheidet sich VECTORIA von anderen Browser-Weltraumspielen?
Während viele Browsergames textbasiert oder 2D sind, bietet VECTORIA ein vollständiges, hardwarebeschleunigtes 3D-Cockpit mit Three.js, physikalischer 6-DoF-Flugmechanik, echtem SignalR-Echtzeit-Multiplayer, einer dynamischen 25-Waren-Wirtschaft und einem intelligenten Mistral-AI-Bordcomputer.

### Auf welchen Geräten kann VECTORIA gespielt werden?
Auf jedem Desktop-PC, Laptop oder Mobilgerät mit einem modernen Webbrowser (Google Chrome, Mozilla Firefox, Microsoft Edge, Apple Safari), der WebGL 2.0 unterstützt. Es wird keine separate Grafikkarte oder Zusatzsoftware benötigt.

### Wie ist das Spiel in die Website www.devaluator.de integriert?
VECTORIA ist sowohl autark unter https://vectoria.devaluator.de/ als auch als Portfolio-Showcase unter https://www.devaluator.de/3LITE erreichbar. Es unterliegt dem architektonischen Prinzip der Strict Domain Separation: Spiellogik, Game-Hubs, WebSockets und 3D-Engines sind strikt vom Business- und Portfolio-Bereich der Website entkoppelt.

---

## 6. Weiterführende Voll-Dokumentation
- [VECTORIA Voll-Dokumentation (llms-full.txt)](https://vectoria.devaluator.de/llms-full.txt)
- [Stephan Pfeiffer Portfolio (llms.txt)](https://www.devaluator.de/llms.txt)