Project

General

Profile

Feature #449 » Lastenheft v0.1.md

Munguntsetseg Gankhuyag, 11/08/2026 07:03 PM

 

Lastenheft v0.1

Projektname: Drinkerbell (Arbeitstitel)

Dokumenttyp: Lastenheft

Das Lastenheft beschreibt, was der Auftraggeber vom Spiel „Drinkerbell“ erwartet. Es legt keine technische Umsetzung fest; diese folgt im Pflichtenheft. Auftraggeber ist hier das Projektteam in der Rolle der späteren Spielenden und der betreuenden Lehrenden.

Freigabe des Dokuments: inhaltlicher Check gegen die Aufgabenstellung, Quellen-Check, Gegenlesen durch eine Person, die nicht Autorin oder Autor ist, und Zustimmung von mindestens 3 Teammitgliedern.


Version Datum Änderung Verantwortlich
v0.1 07.11.2026 Erfassung, abgeleitet aus der Anforderungsanalyse v2.0 Munguntsetseg Gankhuyag

Priorisierung nach MoSCoW: M = Must (muss), S = Should (soll), K = Could (kann). Won’t (nicht Bestandteil)

1. Einleitung

1.1 Ziel

Ziel des Projekts ist ein einzeln spielbares 2D-Fantasy-Adventure in Top-Down-Perspektive mit dem Arbeitstitel „Drinkerbell“. Die Spielenden führen die Fee Drinkerbell durch mehrere unterscheidbare Level. In jedem Level suchen sie eine Kneipe als Zielort. Nur die Kneipe des letzten Levels ist betretbar und beendet das Spiel erfolgreich. Alle anderen Kneipen sind geschlossen, sodass die Suche im nächsten Level weitergeht.

Technische Umgebung

Das Spiel läuft direkt im Webbrowser auf Windows und macOS und ist mit den gängigen aktuellen Browsern (Chrome, Firefox, Edge, Safari) kompatibel. Eine Installation ist nicht nötig. Der Spielstand bleibt auf dem Gerät der spielenden Person.

Grafische Darstellung

Das Spiel hat eine Pixel-Art-Optik im Stil der 16-/32-Bit-Konsolenära. Jedes Level hat eine begrenzte, eigene Farbpalette und ist dadurch optisch unterscheidbar. Zustandsanzeigen sind klar lesbar und nicht allein über Farbe codiert.

Ethische und moralische Botschaft

Das Spiel stellt die Alkoholabhängigkeit der Hauptfigur innerhalb der Fantasiehandlung dar und arbeitet sie am Ende kritisch auf. Der Abschlussbildschirm enthält eine Aufklärung über Alkoholkonsum im Sinne der Prävention. Die Therapiesitzung und das Quellwasser-Fläschchen zeigen Alternativen zum Alkohol. Der Alkohol wird nicht verherrlicht, und die Spieltexte enthalten keine diskriminierenden Zuschreibungen.

Humor- und Genrekonzept

Das Spiel bricht bewusst mit bekannten Fantasy-Tropen. Die Fee ist keine zarte, hilfsbereite Begleiterin, sondern eine kräftige Hauptfigur mit Sucht. Die Queste führt nicht zu Drachen oder Schatz, sondern zur Kneipe. Der Humor ist dunkel und richtet sich an Spielende, die das akzeptieren.

Besondere Mechanik: Zustand statt Zauberkraft

Der mentale Zustand der Fee sinkt ohne Feenschnaps. Dadurch verändern sich Bewegung und Gesundheit der Figur, und der Spielverlauf bekommt Zeitdruck. Besiegte Gegner und Feenschnaps stellen den Zustand wieder her. Ein Rausch durch zu viel Konsum ist als Nachteil vorgesehen. Ein versteckter zweiter Zielort, die Therapiesitzung, hebt im Folgelevel die Beeinträchtigung der Bewegung auf.

Bewegungs- und Kampfmechanik

Die Fee fliegt, und die Spielenden flattern im Rhythmus der Musik. Nur bei vollem mentalem Zustand und Flattern im Takt bewegt sie sich ohne Schwanken. Je niedriger der Zustand, desto stärker ist das Schwanken. Im Nahkampf sind Gegner durch Treffer besiegbar, Kontakt kostet Lebenspunkte. Ergänzend sind Quick-Time-Events (z. B. Ausweichen, Fangen) und zufällige Gegenstandsfunde vorgesehen.

1.2 Scope

1.2.1 In-Scope

  • Entwicklung eines einzeln spielbaren 2D-Fantasy-Adventures in Top-Down-Perspektive.
  • Umsetzung in einer Pixel-Art-Optik.
  • Steuerung der Fee „Drinkerbell“ durch mehrere aufeinanderfolgende Level.
  • Jedes Level enthält eine Kneipe als Zielort. Eine Ausnahme bildet ein spezielles Level, das zwei Zielorte umfasst: eine Kneipe und eine Therapiesitzung.
  • Nur die Kneipe im letzten Level ist betretbar und löst den Spielabschluss aus.
  • Der körperliche und mentale Zustand der Spielfigur beeinflusst den Spielverlauf.
  • Integration einer abschließenden Aufklärung über Alkoholkonsum zur Suchtprävention.
  • Plattformen: Windows und macOS.
  • Technische Umgebung: Gängige, aktuelle Webbrowsern.
  • Spielsprache: Deutsch.

1.2.2 Out-of-Scope

  • Kein Mehrspielermodus und keine Netzwerkfunktionen.
  • Keine mobilen Zielplattformen; Ausführung nur unter Windows und macOS im Browser.
  • Keine Benutzerkonten und keine Cloud-Speicherung von Spielständen.
  • Keine prozedural generierten Level; Level werden von Hand entworfen.
  • Keine weitere Sprachversion neben Deutsch.

1.3 Begriffsdefinitionen

Begriff Bedeutung
Feenschnaps Getränk im Spiel, das den mentalen Zustand erhöht
Mentaler Zustand (MZ.) Dynamischer Statuswert der Hauptfigur – sinkt er zu weit ab, drohen Lebenspunktverluste. (Um Verwechslungen mit M aus MoSCoW-Priorisierung zu vermeiden, wird die Priorität hier als MZ geschrieben, im Anforderungsanalyse v2.0 als M )
HUD Während des Spielens eingeblendete Anzeige relevanter Spielinformationen.
Quick-Time-Event (QTE) Ereignis, bei dem innerhalb eines vorgegebenen Ablaufs eine bestimmte Eingabe erforderlich ist; die konkrete Umsetzung ist noch offen.
Therapiesitzung Versteckter zweiter Zielort eines Levels, der die Figur nüchtern macht
MVP Kleinster sinnvoll nutzbarer Funktionsumfang, der für das Projekt noch festzulegen ist.
Core Loop Wiederkehrender grundlegender Spielablauf aus Erkundung, Erreichen eines Zielorts und Übergang zum nächsten Level.
GitLab Werkzeug zur Versionsverwaltung und Nachverfolgung von Änderungen am Quellcode.
Redmine Werkzeug zur Dokumentation und Verwaltung von Projektaufgaben und Nachweisen.

2.Produktübersicht

2.1 Spielidee

Im Mittelpunkt des Spiels steht die Figur „Drinkerbell“, eine körperlich kräftige Fee, deren Alkoholabhängigkeit einen wesentlichen Bestandteil der Spielmechanik darstellt. Bleibt der Konsum des im Spiel als „Feenschnaps“ bezeichneten Getränks über längere Zeit aus, verschlechtert sich der körperliche Zustand der Figur. Dies wird insbesondere durch Beeinträchtigungen ihrer Fortbewegung sichtbar. Zusätzlich verändert sich ihr mentaler Zustand, was sich auf Lebenspunkte auswirkt.

Die Spielidee verbindet die Erkundung einer Fantasiewelt mit einem zustandsabhängigen Bewegungssystem und Kampfelementen. Die Abhängigkeit der Hauptfigur wird innerhalb der fiktiven Handlung und des Spielsystems dargestellt und behandelt, denn am Ende des Spieles, soll es eine Aufklärung, über dieses “schlechte” Verhalten geben, eine Art Prävention für den Konsum von Alkohol.

Wiederkehrender Spielablauf (Core Loop)

Die Spielenden bewegen die Hauptfigur durch ein Level, suchen die darin enthaltene Kneipe und erreichen durch die dort vorgesehene Interaktion den Übergang zum nächsten Level. Während der Erkundung verändert sich der Zustand der Spielfigur. Dadurch werden die Dauer der Leveldurchquerung und der Umgang mit den vorhandenen Spielmechaniken relevant.

Zustandsabhängige Fortbewegung

Mit zunehmender Zeit ohne Feenschnaps wird die Bewegung der Hauptfigur erschwert. Zusätzlich ist vorgesehen, dass der Bewegungsrhythmus die erreichbare Bewegungsgeschwindigkeit beeinflusst. Die genaue Funktionsweise dieses Zusammenhangs ist bislang nicht bestimmt.

Mentaler Zustand und Kampf

Der mentale Zustand der Hauptfigur nimmt im Verlauf des Spiels ab. Bei Unterschreitung eines noch festzulegenden Zustandswerts soll die Figur Lebenspunkte verlieren. Das Besiegen von Gegnern verbessert ihren mentalen Zustand. Verliert die Hauptfigur sämtliche Lebenspunkte, tritt der Zustand „Game Over“ ein.

Quick-Time-Event (QTE)- Kann

Das Spiel kann Quick-Time-Events bereitstellen. Ein QTE wird durch definierte Ereignisse ausgelöst (Vorschlag: schwerer Angriff eines großen Gegners, herabfallendes Hindernis, herabfallende Feenschnaps-Flasche). Während des QTEs wird eine Eingabeaufforderung mit Symbolen der vorhandenen Tasten angezeigt; die geforderte Eingabe ist innerhalb eines Zeitfensters zu leisten (Vorschlag: schließender Ring, 2 Sekunden, Toleranz ±0,2 Sekunden). Bei Erfolg wird der Schaden vermieden bzw. eine Belohnung ausgelöst; bei Fehlschlag tritt eine begrenzte Folge ein (Vorschlag: −halbes Herz oder −15 %-Punkte M), ohne dass der Durchlauf sofort endet. Während eines QTEs gilt die Pausenfunktion (FA-13) weiter; QTEs und Rhythmusbewegung treten nicht gleichzeitig auf.

QTE Typ Auslöser Eingabe Erfolg Fehlschlag
1. Ausweichen Timing (Ring) Großer Gegner holt zum Hieb aus Leertaste im richtigen Moment Kein Schaden, Gegner 2 s betäubt (Gegenangriff möglich) − halbes Herz
2. Fangen Timing (Ring) Feenschnaps-Flasche fällt vom Handwagen E im richtigen Moment Flasche erhalten (+25 % K) Flasche zersplittert, nichts
3. Reaktion Sequenz Herabfallender Ast/Zapfen, Dornenranken 3 Pfeilsymbole nacheinander, je 1,5 s Unbeschadet vorbei −halbes Herz, 2 s verlangsamt
4. Dialog unter Druck Auswahl + Countdown Aggressiver Kneipengast stellt Frage 1 von 3 Optionen innerhalb 5 s Konflikt entschärft (M +20) M −15 oder

Spielabschluss

Ein Durchlauf gilt als erfolgreich abgeschlossen, wenn die Spielfigur die Kneipe des letzten Levels erreicht, ohne zuvor sämtliche Lebenspunkte verloren zu haben.

2.2 Spielablauf

  1. Die spielende Person startet ein neues Spiel oder lädt einen Spielstand.
  2. Sie erkundet ein Level, bekämpft Gegner und sammelt Gegenstände.
  3. Sie erreicht eine Kneipe. Ist diese geschlossen, erscheint ein Kurzdialog mit dem Grund, und das nächste Level beginnt.
  4. Im letzten Level beendet die betretbare Kneipe das Spiel erfolgreich.
  5. In einem Level gibt es einen versteckten Ort mit Therapiesitzung, der im Folgelevel die zustandsabhängige Steuerung aufhebt.

2.3 Umfang

Geplant sind 5 Level zu je 2 bis 5 Minuten Spielzeit, davon 4 mit geschlossener und 1 mit betretbarer Kneipe. Die Gegneranzahl steigt von Level zu Level.

Für das MVP genügen 3 Level.

2.4 Zielgruppe und Nutzung

Drinkerbell richtet sich primär an junge Erwachsene, die 2D-Adventure-Spiele mögen und mit gängigen Fantasy-Tropes vertraut sind, sodass sie die humorvolle Brechung bekannter Fantasy-Klischees wertschätzen können. Aufgrund der dargestellten Themen ist das Spiel nicht für Kinder unter 13 Jahren vorgesehen.

Die geschlechtsunabhängige Ansprache bezieht sich auf die Zielgruppe, nicht auf die Figurenbesetzung. Die Hauptfigur bleibt als weibliche Figur festgelegt, da Spielmechanik und Präventionsbotschaft an sie gebunden sind. Das Geschlecht ist kein Einflussfaktor auf Spielmechanik oder Werte. Diversität kann über Nebenfiguren dargestellt werden; Spieltexte sollen keine diskriminierenden Zuschreibungen enthalten.

2.5 Weitere Stakeholder

Lehrende

Die betreuenden Lehrenden sind Stakeholder des Hochschulprojekts. Für die Bewertung werden ein funktionsfähiger Projektstand, eine nachvollziehbare gestalterische Umsetzung sowie die Dokumentation des Entwicklungsprozesses benötigt. Die Arbeitsergebnisse sollen den beteiligten Teammitgliedern zugeordnet werden können. Die verbindlichen Bewertungskriterien sind die Ticketerstellung auf Redmine, die Zeiterfassung und das am Ende funktionierende Spiel.

Entwicklungsteam

Das Entwicklungsteam benötigt eine nachvollziehbare Dokumentation der Komponenten und ihrer Schnittstellen. Einzelne Funktionen sollen so strukturiert sein, dass sie unabhängig von anderen Bestandteilen verändert, ausgetauscht oder bei Bedarf entfernt werden können. Daraus ergibt sich insbesondere eine Anforderung an die Modularität der Softwarearchitektur.

3.Funktionale Anforderung

Hinweis zur Gliederung der funktionalen Anforderungen

Die funktionalen Anforderungen sind in diesem Lastenheft nicht nach ihrer Nummer, sondern nach Themen gruppiert, damit zusammengehörige Anforderungen beieinander stehen und das Kapitel für den Auftraggeber leichter lesbar ist. Die Nummern (FA-01 bis FA-26) stimmen unverändert mit der Anforderungsanalyse v2.0 überein; es wurden keine Anforderungen umbenannt, hinzugefügt oder gestrichen. Dadurch bleiben alle Verweise aus Abnahmekriterien, Use Cases, User Stories und Redmine-Tickets gültig. Die Reihenfolge innerhalb der Themen richtet sich nach dem Spielablauf, nicht nach der ID, weshalb die Nummern nicht fortlaufend erscheinen.

Thema Anforderungen
3.1 Spielwelt und Spielablauf FA-01, FA-02, FA-03, FA-22, FA-24, FA-25, FA-26
3.2 Steuerung und Bewegung FA-04, FA-05, FA-06, FA-21
3.3 Zustände und Kampf FA-07, FA-08, FA-09, FA-10, FA-11, FA-18, FA-19, FA-20
3.4 Oberfläche, Pause und Ton FA-12, FA-13, FA-23
3.5 Speichern FA-14, FA-15, FA-16, FA-17

3.1 Spielwelt und Spielverlauf

ID Anforderung Priorität
FA-01 Das Spiel muss mehrere voneinander unterscheidbare Level bereitstellen. M
FA-02 Jedes Level muss eine Kneipe als zu erreichenden Zielort enthalten. M
FA-03 Nach Erreichen und Ausführen der vorgesehenen Interaktion am Zielort muss der Übergang in das nächste Level möglich sein. Interaktion per Taste an der Kneipentür. Geschlossene Kneipen zeigen einen Kurzdialog mit dem Grund (z. B. Ruhetag, Renovierung, abwesender Wirt) und lösen danach den Übergang zum nächsten Level aus M
FA-22 Das Erreichen des Zielorts im letzten Level muss den erfolgreichen Abschluss des Spiels auslösen. Die Interaktion an der Zielkneipe des letzten Levels beendet das Spiel erfolgreich. M
FA-24 Ein Level enthält einen versteckten zweiten Zielort (Therapiesitzung), um dem Spielenden eine Abwechslung im Spielablauf zu ermöglichen S
FA-25 Nach der Therapiesitzung ist das nächste Level spielbar, ohne zustandsabhängige Bewegungssteuerung. Die Wartezeit beträgt höchstens 10 Sekunden. S
FA-26 Das System muss die benötigte Spielzeit erfassen, einen Highscore berechnen und die Spielergebnisse entsprechend der erreichten Zeit speichern und anzeigen. S

3.2 Steuerung und Bewegung

ID Anforderung Priorität
FA-04 Das Spiel muss die Steuerung der Hauptfigur innerhalb der Spielwelt ermöglichen. M
FA-05 Das Spiel muss Kollisionen zwischen der Hauptfigur und relevanten Bestandteilen der Spielwelt berücksichtigen. M
FA-06 Die Fortbewegung der Hauptfigur muss von ihrem aktuellen körperlichen Zustand beeinflusst werden. Nur bei voller mentaler Anzeige, kann man “normal” fliegen, also ohne zu schwanken und dennoch muss man im richtigen Rhythmus flattern. M
FA-21 Der Bewegungsrhythmus der Hauptfigur muss ihre Bewegungsgeschwindigkeit beeinflussen. K

3.3 Zustände und Kampf

ID Anforderung Priorität
FA-07 Das Spiel muss den mentalen Zustand der Hauptfigur verwalten und dessen Veränderung während des Spielverlaufs berücksichtigen. M
FA-08 Unterschreitet M 15 %, verliert die Figur kontinuierlich ein halbes Herz pro 15 Sekunden, bei 0 Herzen ist “Game Over”. M
FA-09 Das Besiegen eines Gegners muss den mentalen Zustand der Hauptfigur verbessern. M
FA-10 Das Spiel muss ein Kampfsystem zur Interaktion mit Gegnern bereitstellen. Nahkampfangriff mit 0,5 Sekunden Abklingzeit; ein Standardgegner ist nach 3 Treffern besiegt. Kontakt mit einem Gegner kostet ein halbes Herz, gefolgt von 1 Sekunde Unverwundbarkeit. Gegneranzahl steigt je Level 2, 4, 6, 8, 10; im MVP ein Gegnertyp. M
FA-11 Sobald sämtliche Lebenspunkte der Hauptfigur aufgebraucht sind, muss der aktuelle Spieldurchlauf mit „Game Over“ enden. M
FA-18 Das Spiel kann Quick-Time-Events bereitstellen. Rätsel und Kampfmechaniken K
FA-19 Das Spiel muss eine zufallsbasierte Vergabe von Gegenständen oder Belohnungen unterstützen. M
FA-20 Das Spiel soll Dialoge mit auswählbaren Antwortmöglichkeiten bereitstellen. S

3.4 Oberfläche, Menü und Ton

ID Anforderung Priorität
FA-12 Die Benutzeroberfläche muss die für das Spielen relevanten Zustände der Hauptfigur darstellen. M
FA-13 Das Spiel muss eine Pausenfunktion zur Unterbrechung und anschließenden Fortsetzung des Spielablaufs anbieten. M
FA-23 Für die im Spiel vorgesehenen Aktionen soll eine akustische Rückmeldung möglich sein. S

3.5 Speichern

ID Anforderung Priorität
FA-14 Das Spiel muss die Speicherung und spätere Wiederaufnahme eines Spielstands unterstützen. M
FA-15 Das Spiel soll die Verwaltung von drei getrennten Spielständen ermöglichen. M
FA-16 Spielstände sollen importiert und exportiert werden können. S
FA-17 Das Spiel muss den Spielfortschritt automatisch zwischenspeichern. M

3.6 Zufallsbasierte Vergaben/ Item Drops FA-19

Das Spiel muss eine zufallsbasierte Vergabe von Gegenständen unterstützen. Vergaben erfolgen bei definierten Anlässen:

  • Besiegen eines Gegners mit 30 % Wahrscheinlichkeit
  • Glitzernde Fundstellen am Boden mit 100 %, jedoch fester, seltener Platzierung.

Welcher Gegenstand erscheint, bestimmt sich über eine konfigurierbare Gewichtung je Gegenstand. 

Für den Spielfortschritt erforderliche Gegenstände – insbesondere Feenschnaps-Flaschen – sind fest platziert und unterliegen nicht dem Zufall. Die Wahrscheinlichkeiten sind als zentrale Konfigurationswerte umgesetzt.

Für Tests kann ein fester Startwert (Seed) für den Zufallsgenerator gesetzt werden.

Gegenstand Wirkung Herkunft Priorität
Feenschnaps-Flasche MZ +25 %-Punkte, T = 0 Fest platziert, 1–2 je Level MVP, M
Waldbeeren + viertel Herz Gegner-Drop (50 % der Drops) M
Blatt-Rüstung Erlittener Schaden halbes Herz→ viertel Herz, gilt bis Levelende Gegner-Drop (15 %) M
Moos-Balsam + halbes Herz Seltene Fundstelle S
Taubenfeder 30 s lang +25 % Geschwindigkeit; ein verpasster Schlag wird verziehen Gegner-Drop (20 %) K
Vierblättriges Glücksklee Drop-Chance für 60 s auf 50 % erhöht Sehr seltene Fundstelle K
Feenstaub MZ +1 pro gesammeltem Stück Überall verstreut K
Joker-Eichel Ein verfehltes QTE wird einmal wiederholt Fundstelle K

4. Nicht-funktionale Anforderung

4.1 Leistung und Ressourcenverbrauch

ID Nichtfunktionale Anforderung Geplante Prüfung Priorität
NFA-01 Das Spiel soll auf einem Testsystem mit integrierter Grafikeinheit eine Bildrate von mindestens 30 Bildern pro Sekunde erreichen. Bildrate während eines festzulegenden Testszenarios erfassen. S
NFA-02 Der Arbeitsspeicherbedarf des Spiels soll unter 2 GB liegen. Speicherbelegung während definierter Spielsituationen messen. S
NFA-03 Der Speicherplatzbedarf der installierten beziehungsweise bereitgestellten Spieldateien darf 3 GB nicht überschreiten. Größe der relevanten Dateien bestimmen. M
NFA-04 Ein Levelwechsel soll weniger als 10 Sekunden Ladezeit erfordern. Zeit zwischen Auslösung und abgeschlossener Bereitstellung des Folgelevels messen. S

4.2 Bedienbarkeit und visuelle Gestaltung

ID Nichtfunktionale Anforderung Geplante Prüfung Priorität
NFA-05 Das Spiel muss über Tastatur sowie Maus oder Touchpad bedienbar sein, soweit die jeweilige Interaktion diese Eingabegeräte vorsieht. Katalog aus 10 Bedienaufgaben (Spiel starten, bewegen, im Rhythmus flattern, angreifen, interagieren, Dialog führen, pausieren, speichern, laden, Spiel beenden); jede Aufgabe ist mit Tastatur sowie mit Maus oder Touchpad ohne Anleitung lösbar. M
NFA-06 Bedienelemente, Zustandsanzeigen und relevante Objekte der Spielwelt sollen visuell eindeutig unterscheidbar sein. Kontrastmessung der HUD-Elemente (Zielwert: Kontrastverhältnis mindestens 4,5:1) und Sichtprobe mit drei testenden Personen, die den Zustand der Figur allein anhand des HUD benennen. S
NFA-07 Menüs sollen übersichtlich aufgebaut sein und sich gestalterisch an einer einheitlichen visuellen Sprache orientieren. Review gegen einen kurzen Styleguide (Schriftart, Farbpalette, Bedienelement- und Icon-Stil); Abweichungen werden dokumentiert und entschieden. S
NFA-08 Die Tastenbelegung soll die Nutzung unterschiedlicher nationaler Tastaturlayouts berücksichtigen. Testläufe unter QWERTZ- und QWERTY-Belegung; alle Aktionen sind ohne Tasten erreichbar, die zwischen den Layouts wechseln; Belegungstabelle im Anhang. S

4.3 Stabilität und Wartbarkeit

ID Nichtfunktionale Anforderung Geplante Prüfung Priorität
NFA-09 Während der festgelegten Testszenarien dürfen keine reproduzierbaren Fehler auftreten, die einen unbeabsichtigten Programmabbruch verursachen. Funktions- und Absturztest in der Programmierungs- bzw. Debuggingphase. M
NFA-10 Spielmechaniken und weitere Funktionen sollen als möglichst unabhängig veränderbare Komponenten umgesetzt werden. Review der Diagramme mit speziellem Augenmerk auf Modularität. S
NFA-11 Die Schnittstellen zwischen den wesentlichen Softwarekomponenten müssen dokumentiert sein. Review der Diagramme mit speziellem Augenmerk auf die Schnittstellen. M

5. Schnittstellen

5.1 Benutzerschnittstelle

Aktion Standard Eingabe
Bewegen Pfeiltasten
Flattern im Rhythmus A und D
Angreifen W
Interagieren, Bestätigen E
Menü- und Dialogauswahl Pfeiltasten und Eingabetaste, alternativ Maus oder Touchpad
Pause, Menü öffnen Esc

Die Belegung soll im Menü anpassbar sein (Wunsch, siehe US-13).

5.2 HUD-Anordnung

Die Menüs sollen eine begrenzte Anzahl eindeutig beschrifteter Bedienelemente enthalten. Die Gestaltung soll sich über die verschiedenen Ansichten hinweg konsistent verhalten. Das Head-up-Display (HUD) soll die relevanten Zustandsinformationen der Hauptfigur während des Spielens gut lesbar darstellen.

Inhalte des HUD Darstellung Platzierung
Lebenspunkte Herzen unten links
mentaler Zustand Balken mit markierter 15-%-Grenze oben links
Feenschnaps Flaschenzähler oben links
Levelanzeige z. B. „Level 2 von 5“ oben rechts
Inventar (S) Eine Reihe von 5 festen Kästchen unten mittig

Lesbarkeit

Mindestschriftgröße 16 Pixel bei der Referenzauflösung, Kontrastverhältnis mindestens 4,5:1, Zustände nicht nur über Farbe codiert (ergänzende Icons oder Beschriftung), Farbstufen grün/gelb/rot zusätzlich mit Zahlenwerten.

Akustische Rückmeldungen

Spielaktionen sollen durch akustische Rückmeldungen unterstützt werden. Die Hintergrundmusik übernimmt außerdem eine rhythmische Funktion, die mit der vorgesehenen Bewegungsmechanik zusammenhängt.

Rückmeldung für die Aktionen

Angriff ausgelöst sowie Treffer/Verfehlen, erlittener Schaden, Gegner besiegt, Gegenstand aufgesammelt, Feenschnaps getrunken, Dialogoption bestätigt, Kneipeninteraktion, Levelwechsel, „Game Over“ und Spielabschluss. Umsetzung als kurze Einzelsounds über den Soundmanager von Phaser; Musik als Schleife pro Level; getrennte Lautstärkeregelung für Musik und Effekte im Optionenmenü.

5.3 Systemumgebung

  • Ausführung im Webbrowser unter Windows und macOS; kompatibel mit den gängigen aktuellen Browsern (Chrome, Firefox, Edge, Safari).
  • Spielstände bleiben auf dem Gerät der spielenden Person; es gibt keine Verbindung zu externen Diensten.
  • Eingabegeräte sind Tastatur und Maus oder Touchpad; Controller werden nicht unterstützt.
  • Audioausgabe über Lautsprecher oder Kopfhörer des Geräts.

5.4 Projektwerkzeuge

Anforderungen, Aufgaben und Zeiten werden in Redmine geführt, der Quellcode wird in GitLab verwaltet. Jedes Ticket verweist auf seine Anforderungs-ID.

//Phaser und TypeScript stehen bewusst nirgends im Lastenheft, denn Technologiewahl und Umsetzung gehören ins Pflichtenheft. In der Anforderungsanalyse stehen sie in Kapitel 04 und 11. Im Lastenheft steht nur, was der Auftraggeber verlangt: Ausführung im Webbrowser unter Windows und macOS (Kapitel 5.3). Abschnitt 5.4 nennt nur Redmine und GitLab als Projektwerkzeuge.

6.Datenanforderungen

6.1 Datenobjekte

Datenonjekt Inhalt Dauer Bezug
Spielzustand Herzen, mentaler Zustand, Zeit ohne Feenschnaps* Nur im Spielstand FA-07 bis FA-11
Spielfortschritt Level, Position, Inventar, besuchte Dialoge, besiegte Gegner Im Spielstand FA-14
Spielstand Abbild von Spielzustand und Spielfortschritt, Spielzeit, Zeitstempel Ja, 3 Plätze + 1 Autosave FA-14, FA-15, FA-17
Einstellungen Lautstärke Musik und Effekte, Tastenbelegung Ja, für das ganze Spiel FA-23, US-13
Ergebnisse Spielzeit je Level und gesamt, Highscore Ja, unabhängig vom Spielstand FA-26, US-07
Inhaltsdaten Level, Gegenstände mit Gewichtung, Dialoge, Balancing-Werte Fest im Spiel, vom Spieler nicht änderbar FA-01, FA-19, FA-20

*Inhalt des Spielzustands

Datum Wertebereich Startwert Veränderung Bezug
Herzen (Lebenspunkte) 0 bis 3** 3** Gegnerkontakt −½ Herz (2 Einheiten); bei M unter 15 % alle 15 s −½ Herz; Waldbeeren +¼ Herz (1 Einheit); Moos-Balsam +½ Herz (2 Einheiten) FA-08, FA-10, FA-11, FA-19
Mentaler Zustand (MZ.) 0 bis 100 % 100 % −25% pro Minute; +10% je besiegtem Gegner; −5% je erlittenem Treffer; +25% je Flasche Feenschnaps (höchstens 100 %) FA-07, FA-09
Zeit ohne Feenschnaps (T) ab 0 Sekunden 0 Zählt seit dem letzten Konsum, Rücksetzung auf 0 bei Konsum FA-07

**3 Herzen= 12 Einheiten, Ein Herz besteht aus vier Einheiten (Viertelherzen). Die Startwerte von 3 Herzen entsprechen deshalb 12 Einheiten. Die Einheiten sind nötig, weil die Regeln halbe und Viertelherzen verwenden und diese ohne Rundung darstellbar sein müssen. Auf dem Bildschirm werden weiterhin Herzen angezeigt (FA-12).

6.2 Spielzustand

ID Anforderung Begründung Priorität
DA-01 Das Spiel verwaltet für die Hauptfigur die Werte Herzen, mentaler Zustand (M) und Zeit ohne Feenschnaps (T) mit den Bereichen und Startwerten der folgenden Tabelle. Grundlage der Spielmechanik M
DA-02 Die Herzen werden intern in Einheiten geführt. Ein Herz besteht aus vier Einheiten (Viertelherzen), am Start sind es 3 Herzen = 12 Einheiten. Auf dem Bildschirm werden weiterhin Herzen angezeigt (FA-12). Halbe und Viertelherzen ohne Rundung M

6.2.1 Umrechnung der Herzen

Regel Anforderung Herzen Einheiten
Startwert DA-02 3 12
Gegnerkontakt kostet Leben FA-10 1/2 -2
Herzverlust bei MZ unter 15%, alle 15 s FA-08 1/2 -2
Waldbeeren geben Herz zurück FA-19 1/4 +1
Blatt-Rüstung FA-10, FA-19 1/4 -1
Moos-Balsam FA-19 1/2 +2
Game Over bei 0 Einheiten FA-11 0 0

6.2.2 Rücksetzung

ID Anforderung Begründung Priorität
DA-03 Nach „Game Over“ und Neustart des Levels erhalten Herzen, M und T ihre Startwerte, und die Figur steht am Levelanfang. Faire Wiederholung M
DA-04 Beim Levelwechsel bleiben aktuelle Herzen und M erhalten. Kontinuität über das Spiel M
DA-05 Beim Laden eines Spielstands werden alle Werte aus dem Spielstand übernommen. Exakte Wiederherstellung (FA-14) M
DA-06 Nach einer Therapiesitzung steht M im darauf folgenden Level auf 100 %. Wirkung der Therapiesitzung (FA-24, FA-25) S

6.3 Spielfortschritt und Inventar

ID Anforderung Begründung Priorität
DA-07 Das Spiel führt für den Fortschritt: aktuelles Level, Position der Figur, besuchte Dialoge und besiegte Gegner. Wiederaufnahme am selben Punkt M
DA-08 Das Spiel führt das Inventar mit allen mitgeführten Gegenständen und ihrer Anzahl, darunter den Flaschenvorrat. Das Inventar gehört zum Spielstand. Gegenstände dürfen beim Laden nicht verloren gehen (FA-19, FA-27) M
DA-09 Das Spiel führt aktive Wirkungen mit Restzeit (z. B. Blatt-Rüstung, Taubenfeder) und stellt sie beim Laden wieder her. Gleicher Spielzustand nach dem Laden S

6.4 Spielstände

ID Anforderung Begründung Priorität
DA-10 Ein Spielstand enthält alle Werte aus 6.2 und 6.3, die Spielzeit und einen Zeitstempel. Vollständige Wiederherstellung M
DA-11 Das Spiel verwaltet drei voneinander getrennte Spielstände und einen eigenen Platz für die automatische Sicherung. Die automatische Sicherung überschreibt keinen der drei Spielstände. FA-15, FA-17 M
DA-12 Ein Spielstand bleibt nach dem Schließen und erneuten Öffnen des Browsers erhalten. Mehrwöchige Spielpausen (FA-14) M
DA-13 Ein einzelner Spielstand ist klein; Vorschlag: höchstens 1 MB. Alle vier Plätze zusammen bleiben deutlich unter dem Speicherplatz, den ein Browser pro Spiel erlaubt. Platz für alle Plätze sicherstellen S

Die automatische Sicherung erfolgt mindestens bei jedem Levelwechsel, alle 60 Sekunden und beim Öffnen des Pausenmenüs (FA-17).

6.5 Einstellungen

ID Anforderung Begründung Priorität
DA-14 Das Spiel speichert die Lautstärke für Musik und Effekte getrennt. FA-23, UC-03 S
DA-15 Das Spiel speichert die Tastenbelegung. US-13, UC-04 S
DA-16 Einstellungen gelten für das ganze Spiel und nicht je Spielstand. Sie bleiben beim Laden und Löschen von Spielständen unverändert. Einmal einstellen genügt S

6.6 Ergebnisse und Highscore

ID Anforderung Begründung Priorität
DA-17 Das Spiel erfasst die Spielzeit je Level und gesamt (Summe über alle Level, ohne Pausenzeiten). FA-23, UC-03 S
DA-18 Gespeichert wird mindestens die beste Gesamtzeit eines erfolgreichen Durchlaufs. Eine Liste der besten Zeiten ist optional. FA-26 S

6.7 Inhaltsdaten und konfigurierbare Werte

ID Anforderung Begründung Priorität
DA-19 Level, Gegenstände, Dialoge und Spieltexte (Deutsch) gehören fest zum Spiel. Der Spieler kann sie nicht ändern. Kontrollierte Spielerfahrung M
DA-20 Zahlenwerte der Spielregeln liegen zentral an einer Stelle und sind ohne Umbau des Spiels änderbar. Die Liste unten ist der Mindestumfang. Balancing und Tests ohne Neuentwicklung S
DA-21 Für Tests lässt sich der Zufall mit einem festen Startwert (Seed) festlegen. Mit gleichem Startwert vergibt das Spiel dieselbe Abfolge von Gegenständen. Wiederholbare Tests (FA-19) S
Wert Sollwert Bezug
MZ-Verlust ohne Feenschnaps 25 % pro Minute FA-07
MZ-Gewinn je besiegtem Gegner 10 % FA-09
MZ-Verlust je Treffer 5 % FA-07
MZ-Gewinn je Flasche Feenschnaps 25 % FA-07
Schwellenwert für Herzverlust 15 % FA-08
Intervall des Herzverlusts 15 Sekunden, ½ Herz FA-08
Abklingzeit Angriff 0,5 Sekunden FA-10
Treffer bis Gegner besiegt 3 FA-10
Unverwundbarkeit nach Gegnerkontakt 1 Sekunde FA-10
Drop-Chance Gegner 30 % FA-19
Drop-Anteile Waldbeeren 50 %, Taubenfeder 20 %, Blatt-Rüstung 15 % (restliche 15 % noch offen) FA-19
Fundstellen 100 %, fest und selten platziert FA-19
Feenschnaps-Flaschen je Level 1 bis 2, fest platziert FA-19
Intervall der automatischen Sicherung 60 Sekunden FA-17
QTE-Zeitfenster (Vorschlag) 2 Sekunden, Toleranz ±0,2 Sekunden FA-18
Rausch (optional) mehr als 3 Flaschen in 60 Sekunden, 10 Sekunden Dauer FA-07

6.8 Lebensdauer der Daten

Datenobjekt Besteht … Wird gelöscht, wenn …
Spielzustand, Fortschritt Nur im laufenden Spiel und im Spielstand ein neues Spiel beginnt oder der Spielstand gelöscht wird
Spielstand (Platz 1 bis 3) Dauerhaft die spielende Person ihn löscht oder überschreibt
Automatische Sicherung Dauerhaft, wird laufend ersetzt ein neuer Autosave entsteht
Einstellungen Dauerhaft die spielende Person sie zurücksetzt
Ergebnisse, Highscore Dauerhaft die spielende Person sie löscht
Inhaltsdaten Fest im Spiel nie durch die spielende Person

Löscht die spielende Person die Browserdaten, gehen Spielstände, Einstellungen und Ergebnisse verloren. Das Spiel weist deshalb auf die Exportfunktion hin (DA-27).

6.9 Datenqualität

ID Anforderung Begründung Prio
DA-22 Das Spiel prüft beim Laden eines Spielstands, ob alle Pflichtwerte vorhanden sind und in ihrem Bereich liegen (Herzen 0 bis 12 Einheiten, MZ 0 bis 100 %, T ab 0, Level innerhalb der vorhandenen Level). Schutz vor beschädigten Daten M
DA-23 Ist ein Spielstand fehlerhaft, zeigt das Spiel eine Meldung, markiert den Platz als „defekt“ und überschreibt ihn nicht. Daten bleiben für eine Reparatur erhalten M
DA-24 Nach einem defekten Spielstand kann die spielende Person die letzte automatische Sicherung laden oder ein neues Spiel beginnen. Weiterspielen ohne Totalverlust M
DA-25 Spielstände enthalten eine Versionsangabe, damit spätere Änderungen am Aufbau erkennbar bleiben. Alte Spielstände bleiben nutzbar S

6.10 Austausch (Import und Export)

ID Anforderung Begründung Prio
DA-26 Das Spiel exportiert einen Spielstand als eine Datei und weist die spielende Person darauf hin, dass Browserdaten verloren gehen können. Sicherung, Gerätewechsel (FA-16, US-11) S
DA-27 Das Spiel importiert eine solche Datei und stellt exakt denselben Stand wieder her. FA-16 S
DA-28 Das Spiel lehnt ungültige oder fremde Dateien mit einer Meldung ab und verändert dabei keinen vorhandenen Spielstand. Schutz vor Datenverlust S

6.11 Datenschutz und Sicherheit

ID Anforderung Begründung Prio
DA-29 Das Spiel erhebt keine personenbezogenen Daten und verlangt weder Konto noch Anmeldung. Nicht-Ziel „keine Benutzerkonten“ M
DA-30 Spielstände, Einstellungen und Ergebnisse bleiben auf dem Gerät der spielenden Person. Das Spiel überträgt keine Daten an externe Dienste. Nicht-Ziel „keine Cloud-Speicherung“ M
DA-31 Fremde Dateien (Import) werden nie als Programm ausgeführt, sondern nur als Daten gelesen. Sicherheit M

6.12 Erlaubte Zustandswechsel

Von Auslösendes Ereignis Nach
Hauptmenü „Neues Spiel“ gewählt Spielstandauswahl, dann Level 1
Hauptmenü „Fortsetzen“ gewählt, Platz gewählt Laufendes Level (geladener Stand)
Laufendes Level Pausentaste Pausiert
Pausiert „Fortsetzen“ gewählt Laufendes Level
Pausiert „Hauptmenü“ gewählt (nach automatischer Sicherung) Hauptmenü
Laufendes Level Kneipeninteraktion, nicht letztes Level Levelwechsel, dann Folgelevel
Laufendes Level 0 Herzen Game Over
Game Over „Level neu starten“ Laufendes Level mit Startwerten
Game Over „Hauptmenü“ Hauptmenü
Laufendes Level, letztes Level Zielkneipe erreicht Spielende, dann Hauptmenü

6.13 Abnahmekriterien zu den Datenanforderungen

Abgeleitet aus den Must-Anforderungen.

ID Zu prüfen Abnahmekriterium
AK-D01 DA-01, DA-02 Startwerte sind 3 Herzen (12 Einheiten), MZ = 100 %, T = 0. Gegnerkontakt zieht 2 Einheiten ab, Waldbeeren geben 1 Einheit. Die Anzeige stimmt mit den internen Werten überein.
AK-D02 DA-03 bis DA-05 Nach Game Over und Neustart stehen alle Werte auf Start. Beim Levelwechsel bleiben Herzen und MZ unverändert. Nach dem Laden stimmen alle Werte mit dem Spielstand überein.
AK-D03 DA-07, DA-08 Nach Speichern und Laden sind Level, Position, Inventar, besuchte Dialoge und besiegte Gegner unverändert.
AK-D04 DA-10 bis DA-12 Drei Spielstände und der Autosave sind getrennt. Nach Neustart des Browsers lässt sich jeder Platz laden.
AK-D05 DA-20 Level, Gegenstände und Dialoge sind für die spielende Person nicht änderbar.
AK-D06 DA-23 bis DA-25 Ein absichtlich veränderter Spielstand (z. B. Herzen = 99) wird beim Laden erkannt, als „defekt“ markiert und nicht überschrieben. Der Autosave ist ladbar.
AK-D07 DA-30, DA-31 Im Testlauf werden keine Daten an externe Adressen gesendet, und es gibt keine Anmeldung.
AK-D08 DA-32 Eine Datei mit Programmtext wird beim Import abgelehnt oder nur als Daten gelesen und nicht ausgeführt.

7.Abnahmekriterien

Abgenommen wird auf fünf Testsystemen (Windows und macOS, verschiedene Browser, von schwacher bis starker Hardware). Ergebnisse werden je Anforderung in Redmine dokumentiert. Die Kriterien unten gelten für alle Must-Anforderungen; Should- und Could-Anforderungen werden nach Möglichkeit mitgeprüft. Das MVP gilt als abgenommen, wenn alle Kriterien erfüllt sind.

ID Zu prüfende Anforderung Abnahmekriterium
AK-01 FA-01 Mindestens 3 Level (Ziel: 5) sind startbar und optisch unterscheidbar.
AK-02 FA-02 In jedem Level ist genau eine Kneipe mit erkennbarem Eingang vorhanden.
AK-03 FA-03 Nach der Interaktion an einer geschlossenen Kneipe erscheint ein Dialog mit Grund, danach ist das Folgelevel spielbar.
AK-04 FA-04 Die Figur lässt sich mit den Pfeiltasten in alle Richtungen steuern und reagiert in unter 100 ms.
AK-05 FA-05 Die Figur durchquert in Testläufen keine Wand und kein Hindernis.
AK-06 FA-06 Bei T unter 45 s und Flattern im Takt schwankt die Figur nicht. Bei T = 45 s schwankt sie leicht, bei T = 90 s mittel und bei T = 150 s stark; die Schwankung ist in jeder höheren Stufe sichtbar stärker als in der vorherigen. Nach dem Konsum von Feenschnaps ist T = 0 und das Schwanken verschwunden. M hat keinen Einfluss auf das Schwanken.
AK-07 FA-07 M ändert sich nur durch die definierten Ereignisse. Der angezeigte Wert stimmt mit dem internen Wert überein.
AK-08 FA-08 Bei MZ = 14 % sinken die Herzen um ein halbes Herz in 15 Sekunden. Bei MZ = 15 % tritt kein Verlust auf.
AK-09 FA-09 Nach einem besiegten Gegner steigt MZ um 10 Prozentpunkte (höchstens 100 %).
AK-10 FA-10 Ein Gegner ist nach 3 Treffern besiegt. Die Abklingzeit beträgt 0,5 s. Ein Gegnerkontakt kostet ein halbes Herz, danach ist die Figur 1 s unverwundbar.
AK-11 FA-11 Bei 0 Herzen erscheint Game Over mit den Optionen „Level neu starten“ und „Hauptmenü“. Weiterspielen ist nicht möglich.
AK-12 FA-12 Das HUD zeigt Herzen, MZ, Flaschenzähler und Level. Alle Werte stimmen mit den internen Werten überein.
AK-13 FA-13 Während der Pause stehen Spielgeschehen und Zeitmessung still. Nach dem Fortsetzen sind Position und alle Werte unverändert.
AK-14 FA-14 Nach Neustart des Browsers stellt „Laden“ alle gespeicherten Werte exakt wieder her.
AK-15 FA-17 Automatisches Speichern erfolgt bei Levelwechsel, alle 60 s und bei Pause; der Zeitstempel der Sicherung belegt dies.
AK-16 FA-19 Fest platzierte Feenschnaps-Flaschen sind in jedem Level vorhanden. Bei 100 Gegnerbesiegungen weicht die Droprate höchstens 10 Prozentpunkte vom Sollwert ab.
AK-17 FA-22 Die Interaktion an der Kneipe des letzten Levels zeigt den Abschlussbildschirm mit Aufklärungsteil und führt danach ins Hauptmenü.
AK-18 NFA-03 Die Gesamtgröße der Spieldateien beträgt höchstens 3 GB.
AK-19 NFA-05 Alle 10 Bedienaufgaben (Spiel starten, bewegen, flattern, angreifen, interagieren, Dialog führen, pausieren, speichern, laden, beenden) sind ohne Anleitung lösbar.
AK-20 NFA-09 Ein 10-minütiger Testdurchlauf über Level 1 bis 3 mit Kampf, Speichern und Laden verläuft ohne Absturz.
AK-21 NFA-11 Die Schnittstellen der wesentlichen Komponenten sind dokumentiert und im Review bestätigt.

8.Anhang

8.1 Rückverfolgbarkeit

Jedes Redmine-Ticket nennt im Titel die Anforderungs-ID (z. B. „FA-08 – Herzverlust bei niedrigem mentalem Zustand“). Testfälle folgen dem Muster T-FA-08-01. Eine Abnahmematrix verknüpft Anforderung, Ticket, Testfall und Ergebnis.

8.2 Anwendungsfälle (Übersicht)

Neues Spiel beginnen · durch die Welt bewegen · Audio und Tasten einstellen · pausieren · gegen Gegner kämpfen · mentalen Zustand verschlechtern · Feenschnaps trinken · Levelziel erreichen · Level wechseln · Dialog führen · Quick-Time-Event bestehen · Item finden · speichern, laden, importieren, exportieren · Game Over · automatisch speichern. Die ausführlichen Beschreibungen (UC-01 bis UC-22) stehen in der Anforderungsanalyse v2.0.

8.3 User Stories (Übersicht)

US-01 bis US-19 aus der Anforderungsanalyse v2.0 gelten als Quelle der Anforderungen. Jede User Story ist mindestens einer Anforderung in Kapitel 3 oder 4 zugeordnet; die Zuordnung wird in der Abnahmematrix geführt.

8.4 Mitgeltende Unterlagen

  • Anforderungsanalyse MAIN v2.0 (Freigabe 05.11.2026)
  • Pflichtenheft (folgt)

8.5 Offene Punkte aus der Ableitung

  • Die Anforderungsanalyse nennt bei FA-04 als Steuerung den Mauszeiger, in Kapitel 09 aber die Pfeiltasten. Hier gelten die Pfeiltasten.
  • Das Beispiel T-FA-08-01 der Analyse („Lebenspunkte sinken um 5“) passt nicht zu „ein halbes Herz alle 15 Sekunden“. Hier gilt die Regel aus FA-08.
  • UC-09 und UC-10 erwähnen einen Shop zwischen den Leveln, der in den Anforderungen nicht vorkommt. Er ist hier nicht enthalten.
  • FA-21 ist in den Abnahmekriterien der Analyse gestrichen, steht dort aber noch in der Anforderungsliste. Hier ist es als Could geführt.
  • Wie viele Level einen versteckten Therapieort haben, ist in der Analyse widersprüchlich (FA-24: „einem Level“, Kapitel 02: „jedem Level“). Das Team muss das noch entscheiden.
  • die Quick-Time-Events (QTE) haben bisher bewusst weniger Gewicht. FA-18 steht im Lastenheft als Could, und die Abnahmekriterien AK-01 bis AK-21 sowie AK-D01 bis AK-D08 decken nur die Must-Anforderungen ab. Ein Could braucht für das MVP kein Abnahmekriterium, es soll nur nach Möglichkeit mitgeprüft werden.
    (1-1/1)