Actions
Architektur und Code-Struktur¶
- Table of contents
- Architektur und Code-Struktur
Stand: 05.11.2026, Branch main. Diese Seite beschreibt den Aufbau des Prototyps „Küstenfahrt“ und wird mit dem Projekt fortgeschrieben.
Überblick¶
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.
index.html
└─ src/main.tsx ── App.tsx (React)
├─ PhaserGame.tsx ── startet Phaser (src/game/main.ts)
│ └─ Szene Voyage (Seefahrt)
├─ Minimap.tsx ── zeigt Landformen und Spielerposition
└─ VoyageControls.tsx ── Entwicklermenü: Tempo, Schiff, Wind, Schaden
▲ │
└──────────── EventBus ◄────────────┘
Szenen¶
| Szene | Datei | Aufgabe |
|---|---|---|
| Voyage | src/game/scenes/Voyage.ts |
Aktive Kartenszene: Schiffssteuerung, Kamera, NPC-Schiffe, Wasser, Terrain, Kollision |
| Game | src/game/scenes/Game.ts |
Ursprüngliche Testszene; bleibt erhalten, wird beim Start nicht aufgerufen |
Geplant laut Spielkonzept: eigene Szenen für Hafen bzw. Landgang, Kampf und Entern sowie Menü.
Module¶
| Modul | Aufgabe |
|---|---|
sailingWorld.ts |
Geometrie der Welt (Inseln, Felsen), Häfen, Landmarken, Referenzroute und Fahrphysik; Weltgröße 18.000 × 10.000 Einheiten |
terrain.ts |
Rendert das Land in Kacheln; dieselben Landpixel dienen der Darstellung und der Kollision (inkl. Stege und Pfosten) |
water.ts und shaders/water.frag |
Animierter Wasser-Shader mit Flachwasser und Brandung; Wellen ziehen mit dem Wind |
npcRoutes.ts |
Acht NPC-Schiffe mit Typ, Geschwindigkeit und geschlossenen Kurvenrouten; Fahrt mit konstantem Tempo nach Bogenlänge |
piratePatrol.ts |
Patrouillenroute eines Piratenschiffs entlang der acht Sprite-Richtungen |
shipCatalog.ts und .json |
Die sechs Schiffstypen, ihre Größen, Rollen (Spieler, NPC, Händler, Marine, Pirat) und Schadensstufen |
shipSprite.ts, shipAppearance.ts |
Wählt das passende Bild nach Richtung, Wind, Segel und Schaden |
shipAnimation*.ts |
Laden, Vorhersage und Zwischenspeicher der Animationsatlanten (begrenzt nach Speicherbedarf) |
shipFootprints.ts |
Pixelgenaue Kollision über die sichtbaren Schiffspixel statt eines pauschalen Radius |
sceneCleanup.ts, textureUploadGuard.ts |
Ressourcen beim Beenden der Szene freigeben; Textur-Uploads absichern |
voyageControls.ts |
Ereignisse zwischen Entwicklermenü (React) und Szene |
Wichtige technische Entscheidungen¶
- 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.
- Kachelweises Terrain mit Cache: Leere Wasserkacheln erzeugen keine Ressourcen; Kacheln und Schiffsmasken werden begrenzt zwischengespeichert.
- Animationsatlanten statt Einzelbilder: Die 34.560 Einzelbilder der Schiffe werden in Atlanten geladen und nach Bedarf wieder freigegeben.
- Pixel-Art-Darstellung:
pixelArt: trueundroundPixels: truein der Phaser-Konfiguration; die Spielfläche passt sich der Fenstergröße an. - 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.
Befehle¶
| Befehl | Zweck |
|---|---|
npm run dev |
Entwicklungsserver auf http://localhost:8080 |
npm run build |
Typprüfung und Produktions-Build nach dist/ |
npm run typecheck |
TypeScript prüfen |
npm run lint |
ESLint ohne Warnungen |
Einrichtung siehe Setup und Starten.
Updated by Daniel Noah Hildebrandt 14 days ago · 1 revisions