Architektur und Code-Struktur » History » Version 1
Daniel Noah Hildebrandt, 11/05/2026 12:46 PM
Seite angelegt
| 1 | 1 | Daniel Noah Hildebrandt | h1. Architektur und Code-Struktur |
|---|---|---|---|
| 2 | |||
| 3 | {{>toc}} |
||
| 4 | |||
| 5 | _Stand: 05.11.2026, Branch @main@. Diese Seite beschreibt den Aufbau des Prototyps „Küstenfahrt“ und wird mit dem Projekt fortgeschrieben._ |
||
| 6 | |||
| 7 | h2. Überblick |
||
| 8 | |||
| 9 | Das Spiel ist eine Web-Anwendung: *React* stellt die Oberfläche um das Spielfeld bereit (Minimap, Bedienelemente), *Phaser 4* rendert die Spielwelt. Beide kommunizieren über einen gemeinsamen *EventBus*. |
||
| 10 | |||
| 11 | <pre> |
||
| 12 | index.html |
||
| 13 | └─ src/main.tsx ── App.tsx (React) |
||
| 14 | ├─ PhaserGame.tsx ── startet Phaser (src/game/main.ts) |
||
| 15 | │ └─ Szene Voyage (Seefahrt) |
||
| 16 | ├─ Minimap.tsx ── zeigt Landformen und Spielerposition |
||
| 17 | └─ VoyageControls.tsx ── Entwicklermenü: Tempo, Schiff, Wind, Schaden |
||
| 18 | ▲ │ |
||
| 19 | └──────────── EventBus ◄────────────┘ |
||
| 20 | </pre> |
||
| 21 | |||
| 22 | h2. Szenen |
||
| 23 | |||
| 24 | |_. Szene |_. Datei |_. Aufgabe | |
||
| 25 | | Voyage | @src/game/scenes/Voyage.ts@ | Aktive Kartenszene: Schiffssteuerung, Kamera, NPC-Schiffe, Wasser, Terrain, Kollision | |
||
| 26 | | Game | @src/game/scenes/Game.ts@ | Ursprüngliche Testszene; bleibt erhalten, wird beim Start nicht aufgerufen | |
||
| 27 | |||
| 28 | _Geplant laut Spielkonzept: eigene Szenen für Hafen bzw. Landgang, Kampf und Entern sowie Menü._ |
||
| 29 | |||
| 30 | h2. Module |
||
| 31 | |||
| 32 | |_. Modul |_. Aufgabe | |
||
| 33 | | @sailingWorld.ts@ | Geometrie der Welt (Inseln, Felsen), Häfen, Landmarken, Referenzroute und Fahrphysik; Weltgröße 18.000 × 10.000 Einheiten | |
||
| 34 | | @terrain.ts@ | Rendert das Land in Kacheln; dieselben Landpixel dienen der Darstellung und der Kollision (inkl. Stege und Pfosten) | |
||
| 35 | | @water.ts@ und @shaders/water.frag@ | Animierter Wasser-Shader mit Flachwasser und Brandung; Wellen ziehen mit dem Wind | |
||
| 36 | | @npcRoutes.ts@ | Acht NPC-Schiffe mit Typ, Geschwindigkeit und geschlossenen Kurvenrouten; Fahrt mit konstantem Tempo nach Bogenlänge | |
||
| 37 | | @piratePatrol.ts@ | Patrouillenroute eines Piratenschiffs entlang der acht Sprite-Richtungen | |
||
| 38 | | @shipCatalog.ts@ und @.json@ | Die sechs Schiffstypen, ihre Größen, Rollen (Spieler, NPC, Händler, Marine, Pirat) und Schadensstufen | |
||
| 39 | | @shipSprite.ts@, @shipAppearance.ts@ | Wählt das passende Bild nach Richtung, Wind, Segel und Schaden | |
||
| 40 | | @shipAnimation*.ts@ | Laden, Vorhersage und Zwischenspeicher der Animationsatlanten (begrenzt nach Speicherbedarf) | |
||
| 41 | | @shipFootprints.ts@ | Pixelgenaue Kollision über die sichtbaren Schiffspixel statt eines pauschalen Radius | |
||
| 42 | | @sceneCleanup.ts@, @textureUploadGuard.ts@ | Ressourcen beim Beenden der Szene freigeben; Textur-Uploads absichern | |
||
| 43 | | @voyageControls.ts@ | Ereignisse zwischen Entwicklermenü (React) und Szene | |
||
| 44 | |||
| 45 | h2. Wichtige technische Entscheidungen |
||
| 46 | |||
| 47 | * *Pixelgenaue Kollision:* Land und Schiffe kollidieren auf Basis der tatsächlich sichtbaren Pixel. Passt eine neue Animationspose nicht ins Wasser, bleibt die letzte passende Pose stehen. |
||
| 48 | * *Kachelweises Terrain mit Cache:* Leere Wasserkacheln erzeugen keine Ressourcen; Kacheln und Schiffsmasken werden begrenzt zwischengespeichert. |
||
| 49 | * *Animationsatlanten statt Einzelbilder:* Die 34.560 Einzelbilder der Schiffe werden in Atlanten geladen und nach Bedarf wieder freigegeben. |
||
| 50 | * *Pixel-Art-Darstellung:* @pixelArt: true@ und @roundPixels: true@ in der Phaser-Konfiguration; die Spielfläche passt sich der Fenstergröße an. |
||
| 51 | * *Optimierung (29.10.2026):* Ressourcen-Lecks beim Neustart behoben, leere Kacheln ohne Texturen, Speicherbudget für Caches, weniger doppelte Berechnungen. Dokumentiert in @docs/superpowers/plans/@ im Repository. |
||
| 52 | |||
| 53 | h2. Befehle |
||
| 54 | |||
| 55 | |_. Befehl |_. Zweck | |
||
| 56 | | @npm run dev@ | Entwicklungsserver auf http://localhost:8080 | |
||
| 57 | | @npm run build@ | Typprüfung und Produktions-Build nach @dist/@ | |
||
| 58 | | @npm run typecheck@ | TypeScript prüfen | |
||
| 59 | | @npm run lint@ | ESLint ohne Warnungen | |
||
| 60 | |||
| 61 | Einrichtung siehe [[Setup und Starten]]. |