Project

General

Profile

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]].