Project

General

Profile

Actions

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: true und roundPixels: true in 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