Skip to content
moinsen-devPublic

About

Experimentelles Physikstrategiespiel mit Three.js und Rapier. Öffentliche Entwicklung, Fehlentscheidungen und Lessons Learned.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

KIPPPUNKT

Ein experimentelles Physikstrategiespiel mit Three.js, TypeScript und Rapier. Dieses öffentliche Repository dokumentiert den Solo-Prototyp, seine Entwicklung und die Fehlentscheidungen des ersten Versuchs.

Stand 5. September 2026: technisch spielbar; Gestaltung und Spielreiz verfehlen den Auftrag. Die Qualitätsfreigabe ist offen.

Tatsächlicher RUN001-Prototyp: ein nummeriertes Holzbrett mit eingesetztem Gewicht und Bedienleiste im Hochformat

Tatsächliche Aufnahme des ersten Entwicklungsstands bei 390 × 844 CSS-Pixeln. Eine Aufnahme im Desktop-Browser, kein Test auf einem physischen Smartphone.

Warum dieses Repository öffentlich ist

Der erste Versuch sollte leicht bedienbar, strategisch anspruchsvoll und angenehm zu beobachten sein. Entstanden ist eine funktionierende Physikaufgabe, deren Darstellung als altmodisch und deren eigentlicher Reiz als unklar bewertet wurde. Wir halten die Kritik, die technischen Ergebnisse und die Grenzen unserer Prüfungen gemeinsam fest.

  • Entwicklungsbericht: RUN001 — Auftrag, tatsächlicher Ablauf, Modelle, Ergebnisse und Nutzerfeedback.
  • Lessons Learned — Fehlentscheidungen, Belege und konkrete Änderungen für einen nächsten Versuch.
  • GAME.md — führender Arbeitsstand des Game-Foundry-Laufs mit Auftrag, Entscheidungen, Budgets und Prüfverweisen. Der dortige technische Übergabepunkt entstand vor der anschließenden kreativen Kritik; deren Einordnung steht im Entwicklungsbericht.
  • Unabhängiger Schlussreview und Belegübersicht — einschließlich gescheiterter Qualitätsvergleiche.
  • Frühe Plugin-Spezifikation — historischer Entwurf. Aussagen zum damaligen leeren Projektordner beschreiben den Entwurfszeitpunkt, nicht den heutigen Bestand.

Die erste Veröffentlichung übernimmt den vorhandenen Stand als einen Git-Snapshot. Sie rekonstruiert keine fiktive Commit-Historie der Entwicklungsstunde. Änderungen ab dieser Veröffentlichung werden durch echte Commits nachvollziehbar.

Lokal spielen

Getestet mit Node.js 24.19.0 und npm 12.0.2.

npm ci
npm run dev

Im Browser 127.0.0.1:5179 öffnen. Der Entwicklungsserver bindet nur an localhost. Für Start und Spiel sind weder Codex noch das Game-Foundry-Plugin oder API-Schlüssel erforderlich.

Gewicht auswählen → freies Feld antippen → bestätigen → Ausschwingen abwarten. Alle sechs Gewichte müssen gesetzt werden und gemeinsam die angezeigte Zielpunktzahl erreichen. Überschreitet die Plattform in einem Simulationsschritt das Kipplimit, endet die Runde. Feldpunkte zählen einmal, unabhängig von der Masse. Drei Aufgaben, Ergebnis und Neustart sind implementiert.

Vorhanden und offen

Vorhanden Noch offen
Solo-Runde mit sechs Gewichten und drei geprüften Aufgaben Überzeugender Einstieg, verständlicher Spielreiz und nachgewiesene strategische Vielfalt
Rapier-Physik mit festen 1/120-Sekunden-Schritten und definiertem Ruhezustand Lesbarkeit ohne Brettverdeckung bei 320 × 568
Prozedurale Geometrien, Materialien und Texturen; Reduced Motion Eigenständige Bildkomposition und die geforderte Referenzqualität
Regeltests, Lösungsreplays und begrenzter Browservergleich Zielgruppen-Spieltests und 60-FPS-Messungen auf benannten Mittelklasse-Smartphones
Lokales Aufgabenmenü Bestwertspeicherung, Qualifikation, Duelle, Serverautorität und Wettbewerb bis zum Weltfinale
Stummer Prototyp Vorab erzeugte ElevenLabs-Musik und Soundeffekte sowie kosmetische Varianten

Prüfen und bauen

npm test
npm run verify:seeds
npm run build
npx tsx scripts/probe-strategies.ts

GitHub Actions führt Installation, Regeltests, Lösungsreplays und Produktionsbuild aus. Die CI prüft technische Funktionen; sie trifft keine Aussage über Spielspaß, Gestaltung oder reale Smartphone-Leistung.

npx tsx scripts/generate-challenges.ts wiederholt die begrenzte Offline-Auswahl aus 80 Kandidaten und überschreibt evidence/generator-manifest.json einschließlich Zeitstempel. Wer den historischen Nachweis erhalten möchte, führt das in einem separaten Checkout aus. Das Spiel liefert ausschließlich die drei ausgewählten Aufgaben aus. Lösungsfolgen liegen unter tests/ und werden nicht in den Client importiert.

Die Browserberichte unter evidence/ sind datierte lokale Prüfungen. Sie laufen nicht automatisch in der CI. Historisch wurden eine Gewinnfolge, eine Verlustfolge und Neustarts auf diesem Mac in Chromium und WebKit sowie entsprechende Node-Replays verglichen. Das ist kein plattformübergreifender Determinismusbeweis für alle Geräte und Situationen.

Aufbau

src/core/          Regeln, Aufgaben und gewertete Rapier-Simulation
src/view/          Three.js-Darstellung des Spielzustands
src/main.ts        Eingaben, UI und Akkumulator für feste Physikschritte
tests/             Regelprüfungen und gespeicherte Lösungsfolgen
scripts/           Offline-Auswahl, Strategieproben und Replay-Hilfen
docs/              Entwicklungsbericht und Lessons Learned
evidence/          Datierte Messdaten, Berichte und Quellen
output/playwright/ Eigene Aufnahmen des Prototyps

Versionen und Parameter sind im Code und Lockfile fixiert. Effekte und Reduced Motion dürfen die gewertete Simulation nicht verändern.

Referenzen und Veröffentlichung

Art of Balance diente als Maßstab für physische Lesbarkeit, Monument Valley für Bildkomposition. Quellen, Aufnahmemethode und Vergleichsgrenzen sind dokumentiert. Die fremden Videos, Kontaktbögen und Bildschirmaufnahmen dieser Referenzen bleiben lokal; im Repository stehen ihre URLs und Prüfdaten. Die veröffentlichten Spielaufnahmen zeigen unsere prozedural erzeugte Grafik.

Dieses Repository veröffentlicht Quellcode und Entwicklungsdokumentation. Es betreibt keinen Online-Spielserver und enthält keine Zugangsdaten oder fertigen Audioassets.

About

Experimentelles Physikstrategiespiel mit Three.js und Rapier. Öffentliche Entwicklung, Fehlentscheidungen und Lessons Learned.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages