Unterstützung #482 » Anforderungsanalyse MAIN (1.2).md
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 | |
| 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-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-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:
- Jedes Redmine-Ticket erhält im Titel die Anforderungs-ID, z. B. „FA-08 – LP-Verlust bei mentalem Zustand unter 15 % umsetzen“.
- Commit-Meldungen referenzieren Ticket und Anforderung, z. B. „FA-08 (#123): LP-Verlust implementiert“.
- Testfälle werden nach dem Muster
T-FA-08-01nummeriert und im Redmine-Wiki abgelegt. - Eine Abnahmematrix verknüpft Anforderung, Ticket, Testfall und Ergebnis und wird mit dem Bearbeitungsstand aktualisiert.
- 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
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.MVP bestimmen: Welche Spielmechaniken sind für die erste abgabefähige Version zwingend erforderlich? Welche sind optional?Spielregeln präzisieren: Insbesondere Zustandswerte, Grenzwerte, Bewegung im Rhythmus, Kampfsystem und Wirkung des Feenschnapses.- Technische Zielumgebung klären: Phaser, Windows und macOS lassen noch offen, wie das Spiel ausgeführt und bereitgestellt wird.
Speicherverwaltung überprüfen: Drei Speicherplätze, automatische Sicherung sowie Import und Export sind vorgesehen; Speicherort und technische Umsetzung sind offen.Abnahmekriterien vervollständigen: Die funktionalen Anforderungen benötigen überprüfbare Testfälle; qualitative Anforderungen brauchen konkretisierte Bewertungsmaßstäbe.Prioritäten und Verantwortlichkeiten zuordnen: Die Anforderungskennungen ermöglichen diese Zuordnung, ersetzen sie aber nicht.- 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.