Project

General

Profile

Files » Anforderungsanalyse MAIN (1.2).md

Drinkerbell Anforderungsanalyse 1.2 - Paul Kriegler, 11/10/2026 05:15 PM

 

Anforderungsanalyse - 2D-Top-Down-Fantasy-Adventure

Projektname: Drinkerbell (Arbeitstitel)

Dokumenttyp: Anforderungsanalyse / Entwurf einer Software Requirements Specification (SRS)

Dokumentstatus: Überarbeitet nach Arbeitsstand

Version und Freigabestand: [OFFEN]

Vorschlag: Version v1.1 (entsprechend dem Änderungsverzeichnis in Kapitel 01), Freigabestand nicht freigegeben. Die Freigabe erfolgt, sobald die Freigabekriterien aus Kapitel 01 erfüllt sind; danach wäre der Stand als „Freigegeben“ mit neuer Versionsnummer (z. B. v2.0) zu kennzeichnen.

Hinweis zum Bearbeitungsstand: Dieses Dokument basiert auf den bisher festgehaltenen Projektangaben. Nicht spezifizierte Sachverhalte sind als [OFFEN] gekennzeichnet. Diese Kennzeichnung bedeutet, dass noch eine fachliche oder technische Entscheidung erforderlich ist. Sie ist kein bereits beschlossenes Anforderungskriterium. Zu jedem offenen Punkt ist ergänzend ein Vorschlag notiert. Vorschläge sind Entscheidungsvorlagen für das Team und werden erst mit Beschluss zu verbindlichen Inhalten; anschließend kann die [OFFEN]-Kennzeichnung wie in den Kapiteln 01 und 04 durchgestrichen werden.

01 Dokumentenverwaltung

Für die Nachvollziehbarkeit der Projektentwicklung sollen Änderungen am Anforderungsdokument versioniert werden. Dabei sind mindestens der Änderungsgegenstand, die verantwortliche Person und das Änderungsdatum festzuhalten. Der vorgesehene Freigabeprozess und die Zuständigkeiten für die Pflege des Dokuments sind noch festzulegen.

[OFFEN] Versionsschema, Verantwortlichkeiten, Freigabekriterien und Änderungsverzeichnis.

Änderungsverzeichnis

Version Datum Verantwortlichkeit
v1.0 18.10.26 Autor Paul Kriegler
v1.1 27.10.26 Prüfer Angelina Grambow
v1.2 30.10.26 Prüfer Monika Fröh
Freigeber

Freigabekriterien:

  • Inhaltlicher Check -> wurden die Anforderungen aus der Aufgabenstellung erfüllt?
  • Quellen Check -> sind alle fremden Gedanken angegeben?
  • Qualitäts Check -> wurde die Arbeit vollständig von einer Person, die es nicht geschrieben hat, gegengelesen?
  • haben mindestens 3 unserer Gruppenmitglieder das "okay" für das Dokument gegeben?

02 Projektbeschreibung und Vision

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 weitere Spielmechaniken 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.

Genre und Perspektive

Das Spiel ist als 2D-Fantasy-Adventure mit einer Top-Down-Perspektive konzipiert. Die Gestaltung orientiert sich an einer pixelbasierten Darstellung.

[OFFEN] Die ursprüngliche Angabe „32bit“ ist hinsichtlich des konkreten Grafikstils zu präzisieren. Sie lässt sich ohne weitere Festlegung nicht eindeutig als technische Eigenschaft oder als ästhetische Beschreibung interpretieren.

„32bit“ als ästhetische, nicht als technische Angabe interpretieren und wie folgt präzisieren: Pixel-Art-Stil orientiert an der 16-/32-Bit-Konsolenära; Kachelformat 32×32 Pixel, Figuren-Sprites 32×32 bis 48×48 Pixel; interne Referenzauflösung von 480×270 Pixeln mit ganzzahliger Hochskalierung ohne Bildglättung (in Phaser über pixelArt: true umsetzbar); begrenzte Farbpalette pro Level (16–32 Farben) für einen einheitlichen Look. Für die Animationen sollen 3 Frames pro Animation reichen.

Projektziel

Ziel des Spiels ist es, die Spielfigur durch mehrere aufeinanderfolgende Level zu führen und jeweils eine Kneipe als Zielort zu erreichen, doch bei jeder außer der letzen Kneipe, gibt es einen Grund, warum diese nicht betreten werden kann und eine andere gefunden werden muss. Nur die letzte Kneipe ist betretbar und beendet das Spiel. Der Spielverlauf wird dabei durch den körperlichen und mentalen Zustand der Hauptfigur beeinflusst. Sobald die letzte Kneipe erreicht wurde, gilt das Spiel als erfolgreich abgeschlossen. Gehen zuvor sämtliche Lebenspunkte verloren, endet der aktuelle Spieldurchlauf.
Zudem wird es in jedem Level einen zusätzlichen versteckten Zielort geben, in denen die Spielfigur eine Therapiesitzung erhält. Wenn diese Therapiesitzung entdeckt wurde, wird es im nächsten Level keine zustandsabhängige Bewegungssteuerung geben, da die Fee nüchtern ist.

03 Stakeholder- und Zielgruppenanalyse

Spielende

Als primäre Zielgruppe werden Personen betrachtet, die 2D-Adventure-Spiele und Fantasy-Szenarien bevorzugen und einen auch dunkleren Humor akzeptieren. Für die Gestaltung des Spielablaufs wird von zeitlich unterschiedlich langen und unregelmäßigen Spielsitzungen ausgegangen. Beispielsweise können während der Woche einzelne Sitzungen von etwa einer Stunde stattfinden, während am Wochenende längere Spielphasen möglich sind. Auch mehrwöchige Unterbrechungen sollen die Fortsetzung eines begonnenen Spieldurchlaufs nicht grundsätzlich verhindern.

Aus diesem Nutzungsverhalten ergeben sich insbesondere Anforderungen an eine Pausenfunktion und die Speicherung des Spielfortschritts.

[OFFEN] In der Ausgangsfassung wird eine geschlechtsunabhängige Ansprache der Zielgruppe sowie eine möglichst geringe geschlechtliche Festlegung der Spielfiguren genannt. Wie diese Zielsetzung mit der ausdrücklich weiblich beschriebenen Hauptfigur vereinbart werden soll, ist gestalterisch zu klären.

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.

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.

[OFFEN] Die verbindlichen Bewertungskriterien ergeben sich aus den Vorgaben der Lehrveranstaltung und müssen mit diesen abgeglichen werden.

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.

04 Systemkontext und Abgrenzung

Das betrachtete System ist ein 2D-Spiel, das die Darstellung der Spielwelt, die Steuerung der Hauptfigur, die Zustandsverwaltung, die Interaktion mit Spielelementen und den Ablauf der einzelnen Level umfasst. Zu den relevanten Systembestandteilen zählen außerdem die grafische Benutzeroberfläche und die Verwaltung von Spielständen.

Als technische Grundlage ist das Framework Phaser vorgesehen. Als Zielplattformen werden Windows und macOS genannt. Ob die Ausführung unmittelbar im Browser oder über eine gesonderte Desktop-Anwendung erfolgen soll, ist bislang nicht festgelegt. Dennoch ist bekannt, dass mit der JavaScript-Engine gearbeitet wird und Phaser nutzt Standardgemäß die WebGL. Das ist die Schnittstelle, die dem Browser erlaubt, die GPU des Spielers direkt für flüssige 2D-Grafiken mit 60 FPS zu nutzen.

Zur Lokalen Datenabhängigkeit zählen lokale Assets und Schriftarten, die wir eventuell benötigen. Als externen Dienst benutzen wir Local Storage, damit können wir die Daten als Text direkt im Browser speichern. So können Daten erhalten werden, auch wenn der Browser geschlossen wird. Außerdem haben wir eine Abhängigkeit zu Code den wir nicht selber geschrieben haben und damit Phaser selbst, eventuell auch zu Zusatz-Plugins, sollten wir spezielle Physik oder Partikeleffekte nutzen wollen.

Unsere Systemgrenze ist die Web-Storage-Schnittstelle des Browsers. Wir benutzen als technische Form der Spielstandspeicherung die local Storage API, damit können Spielzustände asynchron als JSON-formatierte Textstrings gespeichert und persistent hinterlegt werden.

[OFFEN] Ausführungsumgebung, externe Dienste und Datenabhängigkeiten, Systemgrenzen sowie die technische Form der lokalen Spielstandspeicherung.

05 Produktumfang und Scope

Der bisher beschriebene Funktionsumfang umfasst insbesondere:

- Erkundbare Level mit jeweils einem zu erreichenden Zielort.

  • Erkundbare Level mit jeweils 2 zu erreichenden Zielorten.
  • Steuerung und zustandsabhängige Bewegung der Hauptfigur.
  • Darstellung und Veränderung von Lebenspunkten und mentalem Zustand.
  • Kampfhandlungen und Interaktionen mit Gegnern.
  • Benutzeroberfläche mit Zustandsanzeigen und Menüs.
  • Pausen- und Speicherfunktionen.
  • Dialogauswahl, Quick-Time-Events und zufallsbasierte Gegenstandsvergaben.

Die Aufteilung in zwingend erforderliche Funktionen, optionale Erweiterungen und ausdrücklich ausgeschlossene Funktionen wurde noch nicht abgeschlossen. Eine verbindliche Definition des Minimum Viable Product (MVP) liegt daher gegenwärtig nicht vor.

[OFFEN] Muss-, Soll- und Kann-Anforderungen priorisieren; MVP festlegen; Nicht-Ziele dokumentieren.

Nicht-Ziele:

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

06 Spielkonzept und Gameplay

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.

Spielabschluss

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

[OFFEN] Anzahl der Level, Zustandswerte und Grenzwerte, Einfluss des Trinkens auf die Zustände, genaue Bewegungsmechanik, Kampfregeln sowie Bedingungen für den Levelwechsel.

Levelanzahl

5 Level, davon 4 mit geschlossener Kneipe und 1 mit betretbarer Zielkneipe; für das MVP genügen 3 Level. Geplante Spielzeit je Level: 2–5 Minuten.

Zustandswerte:

Herzcontainer 3, Startwert 3; mentaler Zustand M 0–100 %, Startwert 100%; Zeit ohne Feenschnaps T in Sekunden, Startwert 0.

Einfluss des Trinkens:

Mentaler Zustand sinkt ohne Feenschnaps um 25 %-Punkte pro Minute, steigt durch jeden besiegten Gegner um 10 %-Punkte fällt durch jeden erlittenen Treffer um 5 %-Punkte. Flaschen Feenschnaps sind in den Leveln auffindbar; Konsum erhöht Mentaler Zustand um 25 %-Punkte (bis 100 % begrenzt) und setzt T auf 0 zurück. Optional (unterstützt die Präventionsbotschaft): Mehr als 3 Flaschen innerhalb von 60 Sekunden lösen für 10 Sekunden einen „Rausch“ aus, in dem die Steuerung vorübergehend invertiert reagiert. Therapiesitzungen lassen den mentateln Zustand im darauf folgendem Level auf 100% erhalten.

Grenzwerte:

Unterschreitet M 15 %, verliert die Figur kontinuierlich ein halbes Herz pro 15 Sekunden (FA-08). Erreichen von 0 Herzen führt zu „Game Over“.

Bewegungsmechanik (FA-06):

Die Bewegung ergibt sich aus dem mentalen Zustand. - M = 100 %: kein Schwanken (FA-06); unter 100 % nimmt die Schwank-Amplitude stufenweise zu, sodass die Richtungskontrolle erschwert wird. Zusätzlich kann es durch eine andere Droge z.B. zeitverzögerte Steuerung geben.

Kampfregeln (FA-10):

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 (Vorschlag: 2, 4, 6, 8, 10); im MVP ein Gegnertyp.

Levelwechsel (FA-03):

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. Die Interaktion an der Zielkneipe des letzten Levels beendet das Spiel erfolgreich (FA-22).

Quick Time Events

[OFFEN] Prüfung der Quicktime Events durch andere Teammitglieder und Zustimmung.

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

Zufallsbasierte Vergaben FA-19

[OFFEN] Prüfung der Zufallsbasierten Vergabe und Items durch andere Teammitglieder und Zustimmung.

Das Spiel muss eine zufallsbasierte Vergabe von Gegenständen unterstützen. Vergaben erfolgen bei definierten Anlässen (Vorschlag: 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 Stufe
Feenschnaps-Flasche M +25 %-Punkte, T = 0 Fest platziert, 1–2 je Level MVP - must Anforderungen, diese Items muss es geben
Waldbeeren + viertel Herz Gegner-Drop (50 % der Drops) MVP
Blatt-Rüstung Erlittener Schaden halbes Herz→ viertel Herz, gilt bis Levelende Gegner-Drop (15 %) MVP
Moos-Balsam + halbes Herz Seltene Fundstelle Stufe 2 - should
Taubenfeder 30 s lang +25 % Geschwindigkeit; ein verpasster Schlag wird verziehen Gegner-Drop (20 %) Stufe 2 - could Anforderungen
Quellwasser-Fläschchen Kein Rausch-Risiko für das Level Fundstelle Stufe 2 – unterstützt die Präventionsbotschaft: Es gibt eine Alternative zum Alkohol
Vierblättriges Glücksklee Drop-Chance für 60 s auf 50 % erhöht Sehr seltene Fundstelle optional - could Anforderungen
Feenstaub M +1 pro gesammeltem Stück Überall verstreut optional
Joker-Eichel Ein verfehltes QTE wird einmal wiederholt Fundstelle optional

Vorschlag
| Pfifferling | Die Steuerung der Spielfigur verzögert sich um 5% | Fundstelle | optional |

07 Funktionale Anforderungen

Die folgenden Anforderungen beschreiben das von der Software erwartete Verhalten. Die Kennzeichnungen dienen der eindeutigen Referenzierung; sie stellen noch keine Priorisierung dar.

ID Funktionale Anforderung
FA-01 must Das Spiel muss mehrere voneinander unterscheidbare Level bereitstellen.
FA-02 must Jedes Level muss eine Kneipe als zu erreichenden Zielort enthalten.
FA-03 must 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
FA-04 must Das Spiel muss die Steuerung der Hauptfigur innerhalb der Spielwelt ermöglichen.
FA-05 must Das Spiel muss Kollisionen zwischen der Hauptfigur und relevanten Bestandteilen der Spielwelt berücksichtigen.
FA-06 must 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.
FA-07 must Das Spiel muss den mentalen Zustand der Hauptfigur verwalten und dessen Veränderung während des Spielverlaufs berücksichtigen.
FA-08 must Bei Unterschreitung von 15% des mentalen Zustands muss die Hauptfigur Lebenspunkte verlieren. Unterschreitet M 15 %, verliert die Figur kontinuierlich ein halbes Herz pro 15 Sekunden, bei 0 Herzen ist "Game Over".
FA-09 must Das Besiegen eines Gegners muss den mentalen Zustand der Hauptfigur verbessern.
FA-10 must 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 (Vorschlag: 2, 4, 6, 8, 10); im MVP ein Gegnertyp.
FA-11 must Sobald sämtliche Lebenspunkte der Hauptfigur aufgebraucht sind, muss der aktuelle Spieldurchlauf mit „Game Over“ enden.
FA-12 must Die Benutzeroberfläche muss die für das Spielen relevanten Zustände der Hauptfigur darstellen.
FA-13 must Das Spiel muss eine Pausenfunktion zur Unterbrechung und anschließenden Fortsetzung des Spielablaufs anbieten.
FA-14 must Das Spiel muss die Speicherung und spätere Wiederaufnahme eines Spielstands unterstützen.
FA-15 should Das Spiel soll die Verwaltung von drei getrennten Spielständen ermöglichen.
FA-16 sould Spielstände sollen importiert und exportiert werden können.
FA-17 must Das Spiel muss den Spielfortschritt automatisch zwischenspeichern.
FA-18 could Das Spiel kann Quick-Time-Events bereitstellen. Rätsel und Kampfmechaniken
FA-19 must Das Spiel muss eine zufallsbasierte Vergabe von Gegenständen oder Belohnungen unterstützen.
FA-20 should Das Spiel soll Dialoge mit auswählbaren Antwortmöglichkeiten bereitstellen.
FA-21 must Der Bewegungsrhythmus der Hauptfigur muss ihre Bewegungsgeschwindigkeit beeinflussen.
FA-22 must 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.
FA-23 should Für die im Spiel vorgesehenen Aktionen soll eine akustische Rückmeldung möglich sein.
FA-24 should In jedem Level soll eine versteckter zweiter Zielort (Therapiesitzung) sein, um dem Spielenden eine Abwechslung im Spielablauf zu ermöglichen
FA-25 should Nach Abhandeln der Therapiesitzung soll das nächste Level spätestens nach 10 Sekunden spielbar sein (vgl. NFA-04)

Ein Teil dieser Anforderungen beschreibt bislang nur die gewünschte Funktion. Für eine vollständige Spezifikation sind unter anderem Auslösebedingungen, Zustandsgrenzen, Ausnahmen und erwartete Ergebnisse zu konkretisieren.

[OFFEN] Zu jeder Anforderung Priorität, verantwortliche Rolle und mindestens ein überprüfbares Abnahmekriterium ergänzen. Insbesondere FA-06, FA-08, FA-18, FA-19 und FA-21 benötigen eine genauere Beschreibung der Spielregeln.

Die Priorität ist durch die Kennzeichnung must/should/could je Anforderung bereits abgedeckt; sie ist im Rahmen des MVP-Beschlusses (Kapitel 05) zu bestätigen. Für verantwortliche Rollen werden Tätigkeitsbereiche vorgeschlagen, bis die Personen in Kapitel 11 zugeordnet sind. Die Spielregeln zu FA-06, FA-08, FA-18, FA-19 und FA-21 liefern die Vorschläge in Kapitel 06 und 09.

ID Rolle Abnahmekriterium
FA-01 Programmierung Die vorgesehene Levelanzahl (Vorschlag: 5, MVP mindestens 3) ist vollständig startbar; jedes Level ist gestalterisch unterscheidbar.
FA-02 Design In jedem Level ist genau eine Kneipe mit erkennbarem Eingang vorhanden; Nachweis je Level im Testlauf.
FA-03 Programmierung Nach der Interaktion an der Kneipe ist das Folgelevel spätestens nach 10 Sekunden spielbar (vgl. NFA-04).
FA-04 Programmierung Bewegung in alle Richtungen per Mauszeiger; die Reaktion erfolgt ohne wahrnehmbare Verzögerung (unter 100 ms).
FA-05 Programmierung Die Hauptfigur kann Wände und Hindernisse nicht durchqueren; geprüft durch Testläufe gegen jede Hindernisart.
FA-06 Programmierung, Design Regelwerk aus Kapitel 06 umgesetzt: Schwanken ändert mit Mentalem Zustand
FA-07 Programmierung Mentaler Zustand ändert sich ausschließlich durch definierte Ereignisse; HUD-Anzeige und interner Wert stimmen überein (Abgleich über Debug-Anzeige).
FA-08 Programmierung Bei M = 14 % Herzen sinken um ein halbes Herz pro 15 Sekunden; bei M ≥ 15 % tritt kein Herz-Verlust auf (Test per Debug-Werten).
FA-09 Programmierung Nach Besiegen eines Gegners steigt M um 10 %-Punkte, begrenzt auf 100 %.
FA-10 Programmierung Ein Gegner ist nach 3 Treffern besiegt; Trefferzeitpunkt und Abklingzeit entsprechen Kapitel 06.
FA-11 Programmierung Bei Herz = 0 erscheint der Game-Over-Bildschirm mit den Optionen „Level neu starten“ und „Hauptmenü“; ein Weiterspielen ist ausgeschlossen.
FA-12 Design, Programmierung HUD zeigt Herzen und Mentaler Zustand; angezeigte Werte stimmen mit den internen Werten überein.
FA-13 Programmierung Pause hält Simulation und Zeitmessung an; „Fortsetzen“ stellt Position und alle Werte unverändert wieder her.
FA-14 Programmierung Nach Neustart des Browsers stellt „Laden“ exakt den gespeicherten Stand wieder her (Abgleich aller gespeicherten Werte).
FA-15 Programmierung Drei Slots sind anwählbar; Speichern und Laden wirken ausschließlich auf den gewählten Slot.
FA-16 Programmierung Export erzeugt eine JSON-Datei; der Import derselben Datei stellt denselben Stand her; ungültige Dateien werden mit Meldung abgelehnt.
FA-17 Programmierung Automatisches Speichern bei Levelwechsel, alle 60 Sekunden und bei Pause; nachweisbar über den Zeitstempel im Autosave-Slot.
FA-18 Programmierung Ein QTE erscheint an definierter Stelle; Erfolgs- und Misserfolgsfolge entsprechen der Festlegung und sind wiederholbar.
FA-19 Programmierung Vergabewahrscheinlichkeiten sind im Code definiert (z. B. 30 %); über 100 Durchläufe weicht die beobachtete Häufigkeit um höchstens ±10 %-Punkte ab.
FA-20 Design, Programmierung Mindestens ein Dialog bietet zwei Optionen; beide führen zu erkennbar unterschiedlichem Fortgang.
FA-21 Programmierung Treffer im Takt erhält die volle Geschwindigkeit; ein verpasster Schlag reduziert die Geschwindigkeit für 1 Sekunde um 50 % (messbar im Testlauf).
FA-22 Programmierung, Design Interaktion an der Zielkneipe zeigt den Abschlussbildschirm inklusive Präventionsteil; danach Rückkehr ins Hauptmenü.
FA-23 Sound Jede definierte Aktion erzeugt ein hörbares Geräusch; Nachweis über eine Prüfliste.
FA-24 Design In jedem Level ist genau ein versteckter Therapieraum vorhanden; Nachweis je Level im Testlauf.
FA-25 Programmierung Nach Abhandlung der Therapiesitzung ist das Folgelevel spätestens nach 10 Sekunden spielbar (vgl. NFA-04).

08 Nichtfunktionale Anforderungen

Nichtfunktionale Anforderungen beschreiben qualitative Eigenschaften sowie Rahmenbedingungen des Spielsystems. Messbare Zielwerte sind dort angegeben, wo diese bereits vorliegen.

Leistung und Ressourcenverbrauch

ID Nichtfunktionale Anforderung Geplante Prüfung
NFA-01 should 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.
NFA-02 should Der Arbeitsspeicherbedarf des Spiels soll unter 2 GB liegen. Speicherbelegung während definierter Spielsituationen messen.
NFA-03 must Der Speicherplatzbedarf der installierten beziehungsweise bereitgestellten Spieldateien darf 3 GB nicht überschreiten. Größe der relevanten Dateien bestimmen.
NFA-04 should Ein Levelwechsel soll weniger als 10 Sekunden Ladezeit erfordern. Zeit zwischen Auslösung und abgeschlossener Bereitstellung des Folgelevels messen.

Die genannten Grenzwerte sind als Projektziele zu verstehen. Für eine reproduzierbare Prüfung fehlen derzeit insbesondere die genaue Hardwarekonfiguration, die Messbedingungen und die Festlegung, ob Durchschnitts-, Spitzen- oder Mindestwerte maßgeblich sind.

Bedienbarkeit und visuelle Gestaltung

ID Nichtfunktionale Anforderung Geplante Prüfung
NFA-05 must 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.
NFA-06 should 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.
NFA-07 should 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.
NFA-08 should 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.

Stabilität und Wartbarkeit

ID Nichtfunktionale Anforderung
NFA-09 must Während der festgelegten Testszenarien dürfen keine reproduzierbaren Fehler auftreten, die einen unbeabsichtigten Programmabbruch verursachen.
NFA-10 should Spielmechaniken und weitere Funktionen sollen als möglichst unabhängig veränderbare Komponenten umgesetzt werden.
NFA-11 must Die Schnittstellen zwischen den wesentlichen Softwarekomponenten müssen dokumentiert sein.

[OFFEN] Für die noch qualitativen Anforderungen sind nachvollziehbare Prüfverfahren festzulegen, beispielsweise konkrete Bedienaufgaben, Darstellungsregeln oder Anforderungen an die Trennung einzelner Komponenten.

Vorschlag:
eigefügt in die Tabelle in Version 1.2. Zu bestätigen durch nächste Prüfung.

  • NFA-05: 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.
  • NFA-06: 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.
  • NFA-07: Review gegen einen kurzen Styleguide (Schriftart, Farbpalette, Bedienelement- und Icon-Stil); Abweichungen werden dokumentiert und entschieden.
  • NFA-08: Testläufe unter QWERTZ- und QWERTY-Belegung; alle Aktionen sind ohne Tasten erreichbar, die zwischen den Layouts wechseln; Belegungstabelle im Anhang.
  • Für NFA-01 bis NFA-04 werden Messverfahren und Testkonfiguration im Kapitel 13 vorgeschlagen.

Vorschlag für Stabilität und Wartbarkeit:

  • NFA-09: Abfangen von Fehlern in der Porgrammier- bzw. Debuggingphase.
  • NFA-10: Review der Diagramme mit speziellem Augenmerk auf Modularität.
  • NFA-11: Review der Diagramme mit speziellem Augenmerk auf die Schnittstellen.

09 Benutzerinteraktion und UI/UX

Eingabekonzept

Die Spielsteuerung ist für die Verwendung von Tastatur sowie Maus oder Touchpad vorgesehen. Bei der Festlegung der Tastaturbelegung sollen Unterschiede zwischen nationalen Layouts berücksichtigt werden. Die bisherige Angabe einer vereinfachten QWERTY-Belegung beschreibt dieses Ziel noch nicht ausreichend, da QWERTY nicht alle Zielsysteme gleichermaßen abdeckt.

[OFFEN] Konkrete Tastenbelegung, mögliche Anpassung der Steuerung und Zuordnung der Eingabegeräte zu den einzelnen Aktionen.

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

Menüs und Head-up-Display

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.

[OFFEN] Verbindliche Inhalte des HUD, Platzierung der Anzeigen, Schriftgrößen und Kriterien für Lesbarkeit und Kontrast.

Inhalte des HUD: Lebenspunkte als Herzen, mentaler Zustand als Balken mit markierter 15-%-Grenze, Flaschenzähler für Feenschnaps, Levelanzeige (z. B. „Level 2 von 5“). Platzierung: Zustandsbalken und Flaschenzähler oben links, Levelanzeige oben rechts, Herzen unten links. 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.

[OFFEN] Welche Aktionen eine Rückmeldung auslösen und in welcher Weise Musiktempo und Bewegungsrhythmus aufeinander abgestimmt werden.

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

10 Daten und Zustandsmodelle

Spielzustand

Als wesentliche Zustandsgrößen sind gegenwärtig der aktuelle Levelstand, die Lebenspunkte, der mentale Zustand und der körperliche Zustand der Hauptfigur bekannt. Zusätzlich wird die Dauer ohne Feenschnaps als Einflussgröße für die Bewegung beschrieben.

[OFFEN] Konkrete Wertebereiche, Beziehungen zwischen den Zustandsgrößen, Übergänge und Rücksetzbedingungen. Ein Zustandsdiagramm kann diese Zusammenhänge dokumentieren.

Größe Wertebereich Startwert Veränderung
Herzen 0–100 100 pro 15 s bei M < 15 %; ein halbes Herz Abzug
Mentaler Zustand (M) 0–100 % 100 % -25% pro Minute; +10% je besiegtem Gegner; −5% je erlittenem Treffer; +25% bei Feenschnaps
Zeit ohne Feenschnaps (T) ≥ 0 s 0 s zählt seit dem letzten Konsum; Rücksetzung auf 0 bei Konsum

Rücksetzbedingungen (Vorschlag): Nach „Game Over“ und Neustart des Levels erhalten Herzen und Mentaler Zustand wieder ihre Startwerte, T = 0, Position am Levelstart. Beim Levelwechsel werden Herzen und Mentaler Zustand nicht zurückgesetzt (Kontinuität über das Spiel). Beim Laden eines Spielstands werden alle Werte aus dem Speicherstand übernommen. Ein Zustandsdiagramm wird als Anhang ergänzt; ein Entwurf steht im Vorschlag zu den Zustandsübergängen.

Spielstände

Das Spiel soll drei voneinander getrennte Spielstände verwalten können. Bereits gespeicherte Spielstände sollen nach einer Unterbrechung wieder geladen werden können. Darüber hinaus sind automatische Zwischenspeicherung sowie Import und Export vorgesehen.

Als Speicherort wurde zunächst der Spielordner genannt. Ob dies unter der noch zu bestimmenden Ausführungsumgebung technisch möglich und sinnvoll ist, muss geprüft werden. Insbesondere ist der konkrete Zugriff auf das Dateisystem noch ungeklärt.

[OFFEN] Speicherformat, Speicherort, Zeitpunkt der automatischen Speicherung, bei Speicherung erfasste Zustände und Verhalten bei beschädigten Spielständen.

Vorschlag: Speicherformat: JSON-Text mit Feld version (Schema-Version, Startwert 1), damit spätere Formatänderungen erkennbar bleiben. Speicherort: localStorage unter den Schlüsseln drinkerbell.slot1, drinkerbell.slot2, drinkerbell.slot3 und drinkerbell.autosave; ein separater Spielordner entfällt damit, da der Browser-Zugriff auf das Dateisystem nicht verlässlich möglich ist. Export und Import erfolgen als JSON-Datei über einen Download- beziehungsweise Dateiauswahl-Dialog. Automatische Speicherung (FA-17): bei jedem Levelwechsel, alle 60 Sekunden Spielzeit und beim Öffnen des Pausenmenüs; die automatische Speicherung landet im eigenen Autosave-Slot und überschreibt die drei manuellen Slots nicht. Erfasste Zustände: alle Größen aus Kapitel 10 (Level, Position, LP, M, K, T), zusätzlich Vorrat an Flaschen, Ereignis-Flags (besuchte Dialoge, besiegte Gegner) sowie Spielzeit und Zeitstempel. Verhalten bei beschädigten Spielständen: Validierung beim Laden (Schema-Version, Pflichtfelder, plausible Wertebereiche); bei Fehler wird eine Meldung angezeigt, der betroffene Slot als „defekt“ markiert und nicht überschrieben; Fortsetzen ist über den letzten Autosave-Stand oder ein neues Spiel möglich.

Zustandsübergänge

Die vorgesehenen Zustandswechsel umfassen mindestens den Beginn eines Spieldurchlaufs, den laufenden Spielbetrieb, die Pausierung, den Levelwechsel, das erfolgreiche Spielende und „Game Over“.

[OFFEN] Darstellung der erlaubten Zustandsübergänge und der jeweils auslösenden Ereignisse.

Erlaubte Zustandsübergänge:

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

Entwurf eines Zustandsdiagramms für den Anhang:

stateDiagram-v2
    [*] --> Hauptmenue
    Hauptmenue --> Spielstandauswahl: Neues Spiel
    Spielstandauswahl --> LaufendesLevel: Level 1 starten
    Hauptmenue --> LaufendesLevel: Spielstand laden
    LaufendesLevel --> Pausiert: Pausentaste
    Pausiert --> LaufendesLevel: Fortsetzen
    Pausiert --> Hauptmenue: Hauptmenue (automatisch gespeichert)
    LaufendesLevel --> LaufendesLevel: Levelwechsel über Kneipeninteraktion
    LaufendesLevel --> GameOver: Herz = 0
    GameOver --> LaufendesLevel: Level neu starten
    GameOver --> Hauptmenue: Hauptmenue
    LaufendesLevel --> Spielende: Zielkneipe im letzten Level erreicht
    Spielende --> [*]

11 Technische und organisatorische Randbedingungen

Technologischer Rahmen

Für die Implementierung ist das Framework Phaser vorgesehen. Die Zielplattformen sind Windows und macOS. Weitere verbindliche technische Festlegungen wurden bislang nicht getroffen.

[OFFEN] Version des Frameworks, verwendete Programmiersprache, Ausführungs- und Bereitstellungsform sowie gegebenenfalls zusätzliche Bibliotheken.

Vorschlag:

  • Framework: Phaser in Version 3.90.0 als Arbeitsstand (letzte stabile 3.x mit großem Bestand an Dokumentation, Beispielen und Community-Antworten); die Versionsnummer wird in der Projektdatei fixiert. Alternativ wäre Phaser 4 möglich (aktuelle Hauptversion, seit April 2026); wegen des deutlich kleineren Bestands an Lernressourcen wird es nur als Option geführt.
  • Programmiersprache: TypeScript (ECMAScript 2020 oder neuer) mit ES-Modulen; als Build- und Entwicklungswerkzeug Vite.
  • Ausführungs- und Bereitstellungsform: Ausführung im Browser; Bereitstellung über statisches Hosting, insbesondere GitLab Pages. Eine Desktop-Variante (z. B. über Electron) bleibt Kann-Erweiterung, falls Projektzeit übrig bleibt.
  • Zusätzliche Bibliotheken: keine zwingend erforderlich im MVP. Empfohlen wird der Tiled Map Editor zur Erstellung der Leveldaten, da Phaser Tiled-JSON-Dateien direkt einlesen kann; weitere Plugins nur bei nachgewiesenem Bedarf.

Projektressourcen

Als personelle Ressourcen werden vier Personen für die Programmierung sowie Tätigkeiten im Bereich Design und Sounddesign genannt. Die genaue personelle Zuordnung dieser Tätigkeiten ist noch zu dokumentieren. Für die Entwicklung stehen Laptops und Desktop-PCs zur Verfügung.

Der Projektzeitraum erstreckt sich über ein Semester. Die Arbeiten sollen anhand von Meilensteinen geplant und überprüft werden.

[OFFEN] Verbindliche Meilensteine, Verantwortlichkeiten, Verfügbarkeit der Beteiligten und Zuordnung der Arbeitspakete.

Meilensteine bezogen auf eine Semesterlänge von etwa 15 Wochen:

  • M1 (Ende Woche 3): Anforderungsanalyse freigegeben; Projekt-Setup mit GitLab-Repository, Redmine und Phaser-Projektgerüst abgeschlossen.
  • M2 (Ende Woche 5): Bewegungs-Prototyp in einem Testlevel (FA-04, FA-06, FA-21) spielbar.
  • M3 (Ende Woche 8): Kern-Loop im ersten Level vollständig (Zustände, Kampf, Kneipeninteraktion, Levelwechsel).
  • M4 (Ende Woche 10): Alle vorgesehenen Level mit Inhalten; HUD, Pausenfunktion sowie Speichern und Laden umgesetzt.
  • M5 (Ende Woche 12): Feature-Freeze im MVP-Umfang; Beginn der Abnahmetests auf den fünf Testsystemen.
  • M6 (Ende Woche 14/15): Abgabe; Bugfix-Fenster abgeschlossen und Präsentation vorbereitet.

Arbeitspakete (Vorschlag): AP1 Projekt-Setup und Werkzeuge; AP2 Bewegungsmechanik; AP3 Zustandssystem; AP4 Kampfsystem; AP5 Leveldesign und Assets; AP6 UI, HUD und Menüs; AP7 Speichersystem inklusive Import/Export; AP8 Sound und Musik; AP9 Test und Dokumentation; AP10 Abschlussbildschirm mit Präventionsteil.

Rollenzuordnung:

  • Game Projektmanergerin: Angelina Grambow
  • Software-Architektin: Monika Fröh
  • Software-Entwicklerin: Munguntsetseg Gankhuyga
  • Tester: Paul Kriegler
  • Gamedesigner Matthias Sack wöchentliche Verfügbarkeiten werden im Team in Redmine erfasst.

12 Use Cases und User Stories

Die bestehenden Anforderungen lassen sich in Nutzungsszenarien überführen. Die folgenden Beispiele sind unmittelbar aus dem vorgesehenen Spielablauf abgeleitet; sie ersetzen noch keine vollständige Use-Case-Spezifikation.

Use Cases

UC-01: Neues Spiel beginnen

Akteur: Spielende Person

Vorbedingung: Hauptmenü wurde geöffnet

Hauptablauf: Die spielende Person beginnt das Spiel zum ersten Mal oder zum erneuten durchspielen

Alternativablauf: Fehlerfall (z.B. Abstruz), Optionen geöffnet

Nachbedingung: Neues Spiel startet mit dem ersten Level

UC-02: Durchs Spiel bewegen

Akteur: Spielende Person

Vorbedingung: Spiel gestartet

Hauptablauf: Mit dem Bewegungssystem durch die Spielwelt navigieren

Alternativablauf: Fehlerfall, Pause

Nachbedingung: Interaktion mit Spielwelt (z.B. Kampf)

UC-03: Audioeinstellungen ändern

Akteur: Spielende Person

Vorbedingung: Optionen geöffnet

Hauptablauf: Spielende Person passt die Lautstärke der Hintergrundmusik oder der SFX's an

Alternativablauf: Fehlerfall, Spiel fortsetzen

Nachbedingung: Hauptmenü, Fortsetzen des Spieles mit angepasster Audio

UC-04: Tastatureinstellungen ändern

Akteur: Spielende Person

Vorbedingung: Optionen geöffnet

Hauptablauf: Spielende Person passt passt sich individuell die Bewegungssteuerung an

Alternativablauf: Fehlerfall, Spiel fortsetzen

Nachbedingung: Hauptmenü, Fortsetzen des Spieles mit angepasster Bewegungssteuerung

UC-05: Spiel pausieren

Akteur: Spielende Person

Vorbedingung: Spiel läuft

Hauptablauf: Spielende Person pausiert das laufende Spiel

Alternativablauf: Fehlerfall

Nachbedingung: Fortsetzen des Spiels, Speichern, Beenden, Optionen

UC-06: Kampf mit einem Gegner

Akteur: Spielende Person

Vorbedingung: Spiel läuft, In Gegner gelaufen

Hauptablauf: Spielende Person will den metanlen Zustand verbessern

Alternativablauf: Fehlerfall, dem Gegner ausweichen, Game Over bei gescheitertem Kampf, Pause

Nachbedingung: Aufsammeln des Drops nach besiegen des Gegners

UC-07: Mentaler Zustand der Spielfigur verschlechtert sich

Akteur: Spielende Person

Vorbedingung: Spiel läuft

Hauptablauf: Spielende Person bewegt sich in der Spielwelt, wobei die Anzeige des mentalen Zustands geringer wird

Alternativablauf: Fehlerfall, Spieler bekämpft einen Gegner, Lebensanzeige des Spielcharakters beginnt geringer zu werden, Therapiesitzung aufgesucht und anzeige steht still

Nachbedingung: Bewegung des Spielcharakters erschwert sich

UC-08: Benutzung von Feenschnaps

Akteur: Spielende Person

Vorbedingung: Spiel läuft, Feenschnaps durch Kampf erlangt

Hauptablauf: Spielende Person lässt Spielfigur Feenschnaps konsumieren, um die Anzeige des mentalen Zustands aufzufüllen

Alternativablauf: Fehlerfall, Spiel ohne Konsum fortsetzen

Nachbedingung: Mental State Anzeige wird voller, Bewegung der Spielfigur fällt leichter

UC-09: Levelziel erreichen

Akteur: Spielende Person

Vorbedingung: Ein Level ist gestartet und die Hauptfigur kann gesteuert werden, Kneipe wurde erreicht

Hauptablauf: Die spielende Person erreicht die Kneipe und löst die dafür vorgesehene Interaktion aus

Alternativablauf: Fehlerfall, Verliert die Hauptfigur zuvor sämtliche Lebenspunkte, endet der Spieldurchlauf mit „Game Over“

Nachbedingung: Shop vor Beginn des nächsten Levels

UC-10: Shop Interaktion

Akteur: Spielende Person

Vorbedingung:

Hauptablauf:

Alternativablauf:

Nachbedingung:

UC-11: Beginn des nächsten Levels

Akteur: Spielende Person

Vorbedingung: Verlassen des Shops

Hauptablauf: Die spielende Person hat das vorherige Level erfolgreich abgeschlossen und beschreitet das Nächste

Alternativablauf: Fehlerfall, Pause, Speichern & Beenden

Nachbedingung: Startpunkt des nächsten Levels

UC-12: Spielende erreichen

Akteur: Spielende Person

Vorbedingung: Spiel mit allendazugehörigen Leveln durchgespielt

Hauptablauf: Die spielende Person erreicht die letzte Kneipe und löst das Spielende aus

Alternativablauf: Fehlerfall

Nachbedingung: Outro

UC-13: Spielstand speichern

Akteur: Spielende Person

Vorbedingung: Spiel pausiert

Hauptablauf: Die spielende Person speichert das Spiel zur Absicherung zwischendurch oder um das Spiel zu beenden

Alternativablauf: Fehlerfall, Beenden ohne Speichern, Weiterspielen

Nachbedingung: Fortsetzen, Beenden

UC-14: Spiel beenden

Akteur: Spielende Person

Vorbedingung: Spiel pausiert und gespeichert

Hauptablauf: Die spielende Person unterbricht den Spieldurchlauf und beendet das Spiel

Alternativablauf: Fehlerfall, Fortsetzen

Nachbedingung: Anwendung beendet

UC-15: Highscore betrachten

Akteur: Spielende Person

Vorbedingung: Spiel durchgespielt

Hauptablauf: Die spielende Person kann die Zeit einsehen, in der er/sie das Spiel durchgespielt hat

Alternativablauf: Fehlerfall

Nachbedingung: Hauptmenü

UC-16: Importieren des Spielstands

Akteur: Spielende Person

Vorbedingung: Vorhandener Spielstand

Hauptablauf: Die spielende Person will seinen/ihren Spielstand auf anderem Gerät fortsetzen

Alternativablauf: Fehlerfall

Nachbedingung: Spielen des Spiels auf anderem Gerät

UC-17: Game Over gehen

Akteur: Spielende Person

Vorbedingung: Lebensanzeige der Spielfigur ist auf 0 gefallen

Hauptablauf: Die spielende Person hat verloren und muss ab letztem Speicherpunkt fortfahren

Alternativablauf: Fehlerfall

Nachbedingung: Laden des letzten Speicherstands

UC-18: Autosave erreichen

Akteur: Spielende Person

Vorbedingung: Bestimmten Checkpoint im Spieldurchlauf durchlaufen

Hauptablauf: Spiel speichert bei bestimmten Punkten auf der Karte automatisch

Alternativablauf: Fehlerfall, manuelles Speichern

Nachbedingung: Spiel läuft weiter

UC-19: Spielstand fortsetzen

Akteur: Spielende Person

Vorbedingung: Ein zuvor gespeicherter Spielstand ist vorhanden

Hauptablauf: Die spielende Person wählt einen vorhandenen Speicherstand aus

Alternativablauf: Fehlerfall

Nachbedingung: Spiel läuft an gespeichterter Position weiter

[OFFEN] Weitere Anwendungsfälle, etwa Pausierung, Kampf, Dialogauswahl, Import und Export von Spielständen sowie Bedienung der Quick-Time-Events, vollständig beschreiben.

Vorschlag: Ergänzende Anwendungsfälle im selben Format:

UC-20: Dialog mit Antwortmöglichkeiten führen

Akteur: Spielende Person

Vorbedingung: Ein Dialog wurde ausgelöst, etwa durch die Interaktion mit einer Figur oder der Kneipe

Hauptablauf: Die spielende Person wählt eine von mindestens zwei Antwortmöglichkeiten über Pfeiltasten und Eingabetaste oder per Mausklick aus; das Spiel setzt entsprechend der Auswahl fort

Alternativablauf: Ein Abbruch während des Dialogs ist nicht vorgesehen; der Dialog ist bis zum Ende zu führen

Nachbedingung: Spiel läuft weiter in Abhängigkeit zur Dialogauswahl

UC-21: Quick-Time-Event bestehen

Akteur: Spielende Person

Vorbedingung: Ein definiertes Ereignis hat ein Quick-Time-Event ausgelöst

Hauptablauf: Innerhalb des Zeitfensters erscheinen Eingabeaufforderungen; rechtzeitige korrekte Eingaben führen zum Erfolg mit einer Belohnung

Alternativablauf: Bei verpasster Eingabe tritt eine definierte Folge ein (siehe Punkt 6 Quick Time Events) und das Spiel läuft weiter
Nachbedingung: Spiel läuft weiter

UC-22: Item finden

Akteur: Spielende Person

Vorbedingung: Die spielende Person finden einen der definierten Orte mit Item

Hauptablauf: Durch Interaktion mit dem Ort (z.B. funkeln ) erhält die spielende Person einen Gegenstand (siehe Punkt 6 Gegenstände)
Alternativablauf: Spiel läuft weiter ohne Interaktion mit dem Item

Nachbedingung: Spiel läuft weiter

User Stories

ID User Stories Type Use Case Connected Module
US-01 World Als Spieler möchte ich ähnlich der realen Welt als Avatar mit Objekten kollidieren um nicht durch Wände zu laufen. -Collisionboxes, Boundingboxes
US-02 Battle Als Spieler möchte ich Gegner in der Welt attackieren können um mit ihnen zu kämpfen. -Kampfsystem
US-03 World Als Spieler möchte ich die Welt erkunden um das gesamte Spiel sehen zu können. -Bewegungssystem walk-Bewegungssystem fly/jump
US-04 Items Als Spieler möchte ich Objekte finden um später einen Nutzen aus ihnen ziehen zu können. -Dropkriterien, Drops
US-05 Items Als Spieler möchte ich mitgenommene Drops benutzen können um mir einen Vorteil zu verschaffen. Drop Use, Uses
US-06 Gameplay Als Spieler möchte ich einem Zeitdruck im Level unterliegen um zum Ende getrieben zu werden. -Mental State Bar
US-07 Goal Als Spieler möchte ich einen Highscore haben um für meine Schnelligkeit belohnt zu werden. -Highscore zur Spiellänge ∑ aus Leveln
US-08 QoL(quality of life) Als Spieler möchte ich ein informatives HUD haben um meinen Avatar und die Spielwelt optimal einschätzen zu können. -HUD (Inventory/map/POI/health bars/numbers/names/timers, key helpers)
US-09 QoL Als Spieler möchte ich die Möglichkeit haben das Spiel zu pausieren um nicht afk zu sterben. -Pausefunktion
US-10 QoL Als Spieler möchte ich meinen Spielstand speichern können um ihn später weiterspielen zu können. -savegames, paths
US-11 QoL Als Spieler möchte ich meinen Spielstand importieren um ihn auf anderen Windows Geräten weiterspielen zu können. -import export function der savegames
US-12 QoL Als Spieler möchte ich ein ansprechendes Menü im Spiel haben um nicht alle Veränderungen in config Dateien selber schreiben zu müssen. -ansprechendes Menü
US-13 QoL Als Spieler möchte ich meine Tastaturlayouts und Tasten im Spiel anpassen da mir die Globalen Standarts nicht gefallen. -Tastenbelegung ändern im Menü
US-14 Gameplay Als Spieler möchte ich mit Touchpad und Keyboard alles steuern können um meinen Laptop zum spielen nutzen zu können. -Steuerungen simpel, inputs Maus/Tastatur kein Controller
US-15 QoL Als Spieler möchte ich den Ton des Spiels anpassen um nicht von Lauten Geräuschen überrascht zu warden. -Ton Slider im Menü
US-16 QoL Als Spieler möchte ich das Spiel auf einfachem und Bequemen Wege schließen können um keine Tastenkürzel drücken zu müssen. -Schließen button im Menü
US-17 Gameplay Als Spieler möchte ich verlorenes Leben vom Spielcharakter wiedergewinnen können um das Spiel nicht zu schnell zu verlieren. -Health boost, luck drop, buy-ables
US-18 QoL Als Spieler möchte ich in der Mitte eines Levels einen Checkpoint vorfinden um nicht meinen Spielstand zu verlieren falls ich vergesslich werde. -Autosaves in der Mitte der leveltiles
US-19 Story Als Spieler möchte ich die Geschichte der Welt schön dargestellt bekommen um mehr über die Spielwelt lernen zu können. -Cutscenes, Einleitungen

13 Abnahmekriterien und Verifikation

Die Überprüfung der Anforderungen soll auf fünf Testsystemen mit unterschiedlichen Hardwarekonfigurationen erfolgen. Hierzu zählen Workstations, Desktop-PCs für den Heimgebrauch und Laptops. Messergebnisse und Funktionsprüfungen sollen in Redmine schriftlich sowie bei Bedarf mit Bildern dokumentiert werden.

Für die technische Bewertung sind folgende Messgrößen vorgesehen:

Messgröße Einheit Bezug
Ladezeit Sekunden (s) Prüfung der Dauer von Levelwechseln
Arbeitsspeicherbelegung Megabyte (MB) Prüfung des Speicherbedarfs
Speicherplatzbedarf Megabyte (MB) Prüfung der Größe der Spieldateien
CPU-Auslastung Prozent (%) Beobachtung der Systemlast
GPU-Auslastung Prozent (%) Beobachtung der Grafiklast
Bildrate Bilder pro Sekunde (FPS) Prüfung der Darstellungsleistung

Nicht jede Messgröße bildet bereits ein Abnahmekriterium. So wurden für CPU- und GPU-Auslastung bislang keine verbindlichen Grenzwerte definiert. Auch die Messdauer, die verwendeten Spielsituationen und die konkrete Konfiguration der Testsysteme sind noch festzulegen.

Als Nachweise sind die schriftliche und bildliche Testdokumentation, die Versionshistorie in GitLab sowie der Aufgaben- und Bearbeitungsverlauf in Redmine vorgesehen.

[OFFEN] Zu jeder Anforderung einen Testfall mit Vorbedingungen, Testschritten und erwartetem Ergebnis anlegen. Testsysteme und Messverfahren nachvollziehbar beschreiben.

Vorschlag: Einheitliche Testfallvorlage mit den Feldern: Testfall-ID (Muster T-FA-08-01), zugehörige Anforderung, Vorbedingungen, Testschritte, erwartetes Ergebnis, tatsächliches Ergebnis, Testsystem, Testerin oder Tester, Datum, Status (bestanden/fehlgeschlagen). Ablage in Redmine, Verknüpfung über die Anforderungs-ID.

Beispielfall T-FA-08-01: Vorbedingung – laufendes Level, Debug-Zugriff auf die Zustandswerte. Testschritte – M per Debug-Wert auf 14 % setzen und 10 Sekunden warten; anschließend M auf 15 % setzen und erneut 10 Sekunden warten. Erwartetes Ergebnis – im ersten Fall sinken die Lebenspunkte um 5, im zweiten Fall tritt kein Verlust auf.

[OFFEN] Testsysteme: Fünf Systeme mit dokumentierter Konfiguration (Betriebssystem und Version, Browser und Version, CPU- und GPU-Klasse, Arbeitsspeicher). Vorschlagsmatrix: ein Windows-Desktop mit dedizierter Grafikeinheit, ein Windows-Laptop mit integrierter Grafikeinheit, ein älterer Windows-Laptop mit schwacher Ausstattung, ein macOS-Laptop (Apple Silicon), ein macOS-Desktop.

Messverfahren: Bildrate über die Framerate-Anzeige von Phaser (game.loop.actualFps) oder die Performance-Aufzeichnung der Browser-Entwicklerwerkzeuge; Bewertung nach dem Minimum über den Testdurchlauf. Arbeitsspeicher über Task-Manager beziehungsweise Aktivitätsanzeige als Spitzenwert. Ladezeit über Zeitmessung um den Szenenwechsel, gemittelt über drei Durchläufe. Speicherplatz über die Dateigröße des Build-Artefakts. Festes Testszenario: 10-minütiger Durchlauf über die Level 1 bis 3 mit Kampf sowie Speichern und Laden.

14 Risiken, Annahmen und Abhängigkeiten

Die bisherige Planung benennt insbesondere Risiken in den Bereichen Softwaresicherheit, Zugriff auf Systemressourcen und Speicherverwaltung. Dazu zählen Fragen zu Berechtigungen, Datenschutz, möglichen Sicherheitslücken sowie zur unzureichenden Freigabe von Arbeitsspeicher oder anderen zwischengespeicherten Ressourcen.

Ob und in welchem Umfang beispielsweise Betriebssystemschutz, Firewalls oder ein unberechtigter Zugriff auf Speicherbereiche für das konkrete Spiel relevante Projektrisiken darstellen, hängt von der noch zu klärenden Systemarchitektur ab. Die bisherige Aufzählung ist daher als Sammlung möglicher Risikofelder und nicht als abgeschlossene Risikobewertung zu verstehen.

Für die weitere Planung sind insbesondere die Wahrscheinlichkeit, die Auswirkung und mögliche Gegenmaßnahmen der relevanten Risiken zu bewerten. Ebenfalls zu berücksichtigen sind organisatorische Abhängigkeiten, etwa die begrenzte Entwicklungszeit und die Abstimmung zwischen den beteiligten Tätigkeitsbereichen.

[OFFEN] Relevante Risiken priorisieren, Eintrittswahrscheinlichkeit und Auswirkung bewerten sowie konkrete Maßnahmen benennen.

Bewertung der relevanten Risiken (Wahrscheinlichkeit und Auswirkung jeweils niedrig/mittel/hoch):

Risiko Wahrscheinlichkeit Auswirkung Maßnahme
Umfang steigt über das MVP hinaus (Scope Creep) hoch hoch MVP-Beschluss verbindlich halten; Erweiterungen erst nach Fertigstellung des MVP.
Zeitmangel durch Semesterbelastung hoch hoch Meilensteine mit Puffern; kleine, abgeschlossene Tickets in Redmine.
Zu niedrige Bildrate auf schwachen Testsystemen mittel mittel Frühe Messungen, begrenztes Asset-Budget, sparsamer Partikeleinsatz.
Verlust von Spielständen (Löschen von Browserdaten) mittel mittel Import/Export als Sicherungsweg (FA-16); Hinweis im Spiel.
Nutzungsrechte bei Grafik-, Sound- und Musik-Assets mittel hoch Ausschließlich frei lizenzierte (z. B. CC0) oder selbst erstellte Assets; Quellenliste führen.
Kritische öffentliche Wahrnehmung des Alkohol-Themas mittel mittel Präventionsteil am Spielende; Tonalität im Team verbindlich abstimmen.
Ausfall einzelner Teammitglieder (Krankheit, Prüfungen) mittel mittel Wissen teilen (Kurz-Dokumentation je Arbeitspaket), vertretbare Ticketgrößen.
Browserunterschiede bei WebGL-Unterstützung niedrig mittel Phaser im AUTO-Modus mit Canvas-Fallback; Tests auf allen fünf Systemen.
Fehler in der verwendeten Framework-Version niedrig mittel Framework-Version fixieren; Updates nur nach gemeinsamer Abstimmung.

15 Rückverfolgbarkeit und Anhänge

Rückverfolgbarkeit

Redmine ist als Werkzeug zur Dokumentation der Anforderungen und der daraus abgeleiteten Aufgaben vorgesehen. Die Implementierung kann über die Versionshistorie in GitLab nachvollzogen werden. Die eindeutigen Anforderungskennungen aus diesem Dokument können für die Zuordnung zwischen Anforderungen, Arbeitspaketen, Implementierung und Tests verwendet werden.

[OFFEN] Einheitliches Verfahren zur Verknüpfung von Anforderung, Redmine-Ticket, Quellcodeänderung und Testnachweis festlegen.

Vorschlag: Verfahren in fünf Punkten:

  1. Jedes Redmine-Ticket erhält im Titel die Anforderungs-ID, z. B. „FA-08 – LP-Verlust bei mentalem Zustand unter 15 % umsetzen“.
  2. Commit-Meldungen referenzieren Ticket und Anforderung, z. B. „FA-08 (#123): LP-Verlust implementiert“.
  3. Testfälle werden nach dem Muster T-FA-08-01 nummeriert und im Redmine-Wiki abgelegt.
  4. Eine Abnahmematrix verknüpft Anforderung, Ticket, Testfall und Ergebnis und wird mit dem Bearbeitungsstand aktualisiert.
  5. Definition of Done je Ticket: Code gemergt, Testfall ausgeführt und verlinkt, Dokumentation aktualisiert.

Glossar

Begriff Bedeutung im Projekt
Core Loop Wiederkehrender grundlegender Spielablauf aus Erkundung, Erreichen eines Zielorts und Übergang zum nächsten Level.
HUD Während des Spielens eingeblendete Anzeige relevanter Spielinformationen.
Quick-Time-Event Ereignis, bei dem innerhalb eines vorgegebenen Ablaufs eine bestimmte Eingabe erforderlich ist; die konkrete Umsetzung ist noch offen.
GitLab Werkzeug zur Versionsverwaltung und Nachverfolgung von Änderungen am Quellcode.
Redmine Werkzeug zur Dokumentation und Verwaltung von Projektaufgaben und Nachweisen.
MVP Kleinster sinnvoll nutzbarer Funktionsumfang, der für das Projekt noch festzulegen ist.

Geplante Anhänge

  • Diagramm des Systemkontexts.
  • Zustandsdiagramm der Spielfigur und des Spielablaufs.
  • Übersicht der Softwarekomponenten und Schnittstellen.
  • Detaillierte Use-Case-Beschreibungen.
  • Testfälle und Zuordnung zu den Anforderungskennungen.

Die konkreten Diagramme und Anhänge liegen im derzeitigen Dokumentstand noch nicht vor.


Noch zu klärende Punkte vor einer Abgabe

  1. Dokumenttyp festlegen: Die Bezeichnungen „Lastenheft“ und „Software Requirements Specification“ bezeichnen nicht in jedem Vorgehensmodell denselben Detaillierungsgrad. Das Dokument sollte anhand der Vorgaben der Lehrveranstaltung eindeutig eingeordnet werden.
  2. MVP bestimmen: Welche Spielmechaniken sind für die erste abgabefähige Version zwingend erforderlich? Welche sind optional?
  3. Spielregeln präzisieren: Insbesondere Zustandswerte, Grenzwerte, Bewegung im Rhythmus, Kampfsystem und Wirkung des Feenschnapses.
  4. Technische Zielumgebung klären: Phaser, Windows und macOS lassen noch offen, wie das Spiel ausgeführt und bereitgestellt wird.
  5. Speicherverwaltung überprüfen: Drei Speicherplätze, automatische Sicherung sowie Import und Export sind vorgesehen; Speicherort und technische Umsetzung sind offen.
  6. Abnahmekriterien vervollständigen: Die funktionalen Anforderungen benötigen überprüfbare Testfälle; qualitative Anforderungen brauchen konkretisierte Bewertungsmaßstäbe.
  7. Prioritäten und Verantwortlichkeiten zuordnen: Die Anforderungskennungen ermöglichen diese Zuordnung, ersetzen sie aber nicht.
  8. Dokumentation ergänzen: Offene Abschnitte zu Systemkontext, Diagrammen, Versionsverwaltung und Risikoanalyse vervollständigen.

Einsatz von KI:

Promt:
Prüfe meine bisherige Anforderungsanalyse auf sprachliche und fachliche Unklarheiten. Behalte die Spielidee und meine Anforderungen bei. Hilf mir, die vorhandenen Inhalte verständlicher zu formulieren, besser zu ordnen und fehlende Angaben zu erkennen. Schlage bei Bedarf Beispiele vor, ohne neue Spielideen festzulegen.

Erklärung der durchgeführten Aktionen von KI:
Für die Gliederung der Anforderungsanalyse wurde eine KI-erstellte Vorlage
( Blueprint_Anforderungsanalyse_Vorlage.md ) als Orientierung verwendet. Die Spielidee und der erste inhaltliche Entwurf wurden eigenständig erarbeitet. Bei der anschließenden Überarbeitung wurde KI zur sprachlichen Verbesserung, Strukturierung der Anforderungen und Erstellung beispielhafter Use Cases eingesetzt.

Prompt:
Versuche in diesem Dokument: Anforderungsanalyse MAIN (1) Vorschläge auszuarbeiten, die für [OFFEN] verwendet werden können.

Erklärung der durchgeführten Aktionen von KI:
Zusätzlich wurden die zu den [OFFEN]-Punkten eingefügten Vorschläge mit KI-Unterstützung aus dem bestehenden Dokumentstand ausgearbeitet. Die Vorschläge sind Entscheidungsvorlagen und wurden vor einer Übernahme vom Team zu prüfen und zu beschließen.

Prompt:
Noch eine Anfrage: Wie könnte man die FA-18 und FA-19 noch ausformulieren? Hast du Ideen für Quicktime Events? Und welche Item könnte es geben?

Erklärung der durchgeführten Aktionen von KI:
Es wurden die Ideen für FA-18 und FA-19 erstellt und von mir angepasst und überarbeitet.

(13-13/49)