Eine neue Fähigkeit in einem bestehenden Metroidvania kann unbemerkt mehr durcheinanderbringen als nur den Zugang durch eine verschlossene Tür. Sie kann optionale Routen, die Rückkehr zu Kontrollpunkten, den Zugang zu Bossen und den Weltzustand verändern, den ein älterer Spielstand voraussetzt. Erfasse zuerst den Fortschrittszustand und seine Abhängigkeiten. Setze dann eine klar begrenzte, dauerhafte Änderung in dem System um, das den Zustand bereits verwaltet, und teste die betroffenen Routen.

Dieser Leitfaden richtet sich an Entwickler, die ein bestehendes Projekt erweitern. Die Beispielwelt Glassroot ist frei erfunden. Nutze die folgende Karte, die Spielstand-Flags und die Testfälle als Planungshilfen und passe sie an deine Architektur an.
Definiere, was „persistente Progression“ bedeutet
Bevor du ein Feld im Spielstand anlegst, benenne die für Spieler sichtbare Änderung, die einen Raumwechsel, das erneute Laden eines Kontrollpunkts oder einen vollständigen Neustart überdauern soll. Ein freigeschalteter Dash kann dauerhaft verfügbar bleiben. Ein Steintor, das sich mit dieser Fähigkeit öffnen lässt, kann offen bleiben. Ein temporärer Schalter, der Alarmzustand eines Gegners oder ein Kampfbonus kann beim erneuten Laden des Raums zurückgesetzt werden. Diese Entscheidungen fallen ins Spieldesign. Der Serializer setzt sie lediglich um.
| Zustandstyp | Beispiel | Offene Entscheidung |
|---|---|---|
| Fähigkeit | Dash, Festhalten an Wänden, Doppelsprung | Wird sie dauerhaft freigeschaltet, vorübergehend gewährt oder in einem Spielmodus zurückgesetzt? |
| Änderung der Spielwelt | Geöffnetes Tor, das sich nur in eine Richtung passieren lässt | Bleibt die Änderung weltweit, pro Region oder nur bis zum Verlassen des Bereichs bestehen? |
| Raumzustand | Betätigter Hebel, besiegter Gegner | Soll der Raum diesen Zustand bei der Rückkehr wiederherstellen? |
| Kurzzeitiger Effekt | Aufblitzen bei erlittenem Schaden, vorübergehender Bonus | Soll der Effekt überhaupt in der Spielstanddatei landen? |
Im fiktiven Beispiel Glassroot schaltet die Erkundungsfigur einen Dash dauerhaft frei, öffnet ein bestimmtes Steintor und kann über eine kurze Schleife zum zentralen Knotenpunkt zurückkehren. Ein Gegner in der Nähe erscheint nach dem Verlassen des Bereichs erneut. Diese Regeln dienen der Veranschaulichung und wurden nicht getestet. In deinem Spiel können andere Regeln fürs Zurücksetzen gelten. Halte sie fest, bevor du den Code änderst.
Ordne Fähigkeiten den Zugangssperren und Routen zu
Eine Fähigkeit ist nützlich, wenn sie auf der Karte eine Aufgabe erfüllt. Liste jede Sperre auf, die von der Fähigkeit abhängt, ebenso die Räume, die vor und nach dem Upgrade erreichbar sind, und den Rückweg zu einem Knoten- oder Kontrollpunkt. Berücksichtige optionale Abzweigungen und Stellen, an denen man hinunterspringen, aber auf demselben Weg nicht wieder hinaufgelangen kann. Eine Übersicht der Abhängigkeiten deckt einen häufigen Designfehler auf, bei dem ein neues Flag zwar die vorgesehene Tür öffnet, der Spieler aber auf der falschen Seite des Rückwegs festsitzt.

| Abhängigkeit | Ohne die Fähigkeit | Mit der Fähigkeit | Frage für den Regressionstest |
|---|---|---|---|
| Rissige Barriere | Sichtbar, aber unpassierbar | Der Dash durchbricht oder überwindet sie | Kann der Spieler zum Kontrollpunkt zurückkehren? |
| Hoher Vorsprung | Die Route bleibt optional | Die Fähigkeit eröffnet eine Abkürzung | Überspringt die Abkürzung ein Pflicht-Tutorial? |
| Boss-Siegel | Der Weg zum Boss bleibt versperrt | Ein Welt-Flag ermöglicht den Zutritt | Kann ein Spielstand geladen werden, bei dem der Zustand des Siegels und der des Bosses auseinanderfallen? |
Richte die Tabelle an der tatsächlichen Karte aus. Ist eine Route per Sequence Break erreichbar, also unter Umgehung der vorgesehenen Abfolge, entscheide, ob du das unterstützen, blockieren oder lediglich testen willst. Bevor du einen unerwarteten Weg mit einer globalen Sperre „reparierst“, kläre, wie die Spieler dorthin gelangen und wie viel Freiheit das Spiel ihnen geben soll.
Verwalte den Fortschrittszustand in einem einzigen System
Verfolge, wie das bestehende Projekt Fähigkeiten, das erneute Laden von Räumen, Kontrollpunkte, Zugangssperren und Spielstände handhabt. Ermittle, welches System bereits das Inventar oder die Welt-Flags verwaltet. Erweitere nach Möglichkeit dieses System, bevor du einen zweiten Manager für die Progression einführst. Zwei unabhängige Kopien von „Dash freigeschaltet“ können voneinander abweichen. So kann das HUD die Fähigkeit schon anzeigen, während die Logik des Tors noch einen veralteten Wert liest.
Verwende für dauerhafte Änderungen stabile Bezeichner wie gate_moss_archive_open. Die angezeigten Raumnamen können sich ändern. Lege einen Standardwert für ältere Spielstände fest, in denen das neue Feld noch fehlt. Soll das Tor bei fehlendem Flag geschlossen bleiben, seinen Zustand aus einem Boss-Flag ableiten oder einer einmaligen Migrationsregel folgen? Triff diese Entscheidung bewusst und dokumentiere sie.
Die Dokumentation zur stabilen Godot-Version beschreibt user:// als beschreibbaren Speicherort für Benutzerdaten und zeigt Beispiele für dateibasierte Spielstände. Das Tutorial zum Speichern von Spielen zeigt außerdem, wie du persistente Objekte erkennst und relevante Daten serialisierst. Die Dokumentation dient hier als Referenz für Speicherung und Serialisierung. Sie empfiehlt kein Datenschema für Metroidvanias. Prüfe deine Engine-Version und behalte die vorhandene Speicherarchitektur des Projekts bei, soweit das praktikabel ist.
Halte die gespeicherten Daten möglichst kompakter als den Szenenbaum. Stabile Fähigkeits-IDs und Welt-Flags können ausreichen, um die Darstellung eines Raums wiederherzustellen. Wenn du pauschal jeden Knoten speicherst, kann das spätere Umbauten an Szenen erschweren. Serialisiert das Spiel bereits Objekte, folge seinen Konventionen und ergänze nur die Werte, die für die korrekte Wiederherstellung nötig sind.
Gib der KI einen klar begrenzten Änderungsauftrag
KI kann helfen, ein Projekt zu untersuchen oder einen vorgeschlagenen Patch zu durchdenken. Formuliere im Auftrag ausdrücklich, welches Verhalten erhalten bleiben muss. So kann der Auftrag aussehen.
Untersuche vor jeder Änderung die bestehende Fortschritts- und Speicherlogik. Ändere weder die Spielerbewegung noch die Raumtopologie, die Reihenfolge der Bosse, das Verhalten der Kontrollpunkte oder bestehende Fähigkeits-IDs. Schlage die kleinstmögliche Änderung vor, mit der sich eine neue Fähigkeit und das davon abhängige Tor im bereits zuständigen System dauerhaft speichern lassen. Liste zuerst die Dateien und die Annahmen zur Migration auf. Zeige anschließend einen Plan für einen rückgängig zu machenden Patch sowie die betroffenen Routen und Tests für neue, vorhandene und ältere Spielstände. Behaupte nur dann, dass das Spiel Tests bestanden hat, wenn diese in diesem Projekt ausgeführt wurden.
Prüfe im Diff, ob mehrere Systeme denselben Zustand verwalten, ob Anzeigetext als Schlüssel im Spielstand dient, welche Annahmen für ältere Spielstände gelten und ob sich Raumübergänge ändern. Bitte um eine Zusammenfassung pro Datei und um konkrete Schritte zum Rückgängigmachen des Patches. Ein Konzept oder Codevorschlag aus dem Tool belegt weder die Integration ins Spiel noch durchgeführte Tests.
Der Katalog von SEELE beschreibt, wie sich aus einer schriftlich formulierten Idee ein Spiel erstellen lässt, und nennt spielbare Kategorien wie RPGs, Runner, Shooter und Roguelikes. Damit kommt SEELE infrage, wenn du ein eigenständiges spielbares Konzept erkunden oder eine Idee zur Progression vermitteln möchtest. Der Katalog belegt keine Bearbeitung bestehender Repositorys oder Migration von Spielständen durch SEELE. Nutze für solche Änderungen den Workflow deines Projekts.
Erhalte alte Spielstände und definiere die Migration
Teste die Migration an einer Kopie des Spielstands und bewahre das Original auf. Liste auf, welche neuen Felder in der Datei fehlen und welche Standardwerte das Spiel einsetzt. Prüfe, ob eine bereits erworbene Fähigkeit unbemerkt verloren geht, ein Tor unerwartet zurückgesetzt wird oder ältere Flags für abgeschlossene Spielabschnitte ihre Bedeutung verlieren. Wenn du die Progression grundlegend änderst, versioniere das Spielstandschema und lege das Migrationsverhalten ausdrücklich fest.
Halte in der Migrationsnotiz die alte und neue Schemaversion, hinzugefügte oder umbenannte Felder, Ersatzwerte und das Verhalten bei einem Fehler beim Einlesen fest. Stimme die Wiederherstellung im Fehlerfall auf das bestehende Spieldesign ab. Eine beispielhafte Spielstandkarte kann diese Vereinbarung veranschaulichen. Ob der Spielstand tatsächlich kompatibel ist, zeigt erst das Laden im Ziel-Build.
Prüfe vor der Erweiterung einen Vertical Slice
Implementiere eine Fähigkeit, ein davon abhängiges Tor und einen Rückweg. Teste anschließend den gesamten Ablauf, bevor du das Muster auf alle Regionen überträgst. Halte den Build, die Spielstandversion, den Raum, die Schritte sowie den erwarteten und den beobachteten Zustand fest. Schlägt eine Prüfung fehl, grenze ein, ob die Abweichung beim Erwerb der Fähigkeit, bei der Serialisierung, bei der Wiederherstellung nach dem Laden, beim Betreten des Raums oder bei der visuellen Rückmeldung entsteht.
| Testfall | Aktion | Zu prüfen |
|---|---|---|
| Neuer Spielstand | Ohne die Fähigkeit starten | Das Tor ist geschlossen und die für den frühen Spielverlauf vorgesehene Route ist erreichbar |
| Erwerb | Die Fähigkeit freischalten und das zugehörige Tor passieren | Der Status der Fähigkeit und das Welt-Flag werden jeweils einmal aktualisiert |
| Rückweg | Den Bereich verlassen und über die Schleife zurückkehren | Tor, Kontrollpunkt und Karte zeigen einen konsistenten Zustand |
| Erneutes Laden | Speichern, das Spiel beenden und den Spielstand erneut laden | Die Fähigkeit und der dauerhafte Zustand des Tors werden wiederhergestellt |
| Älterer Spielstand | Eine Kopie aus der Zeit vor der Änderung laden | Die Standardwerte oder die Migration erhalten eine spielbare Route |
| Zurücksetzen | Die im Projekt vorgesehene Neustartfunktion nutzen | Dauerhafte und vorübergehende Werte folgen den dokumentierten Regeln |
Die folgende fiktive Kontrollpunkt-Abbildung zeigt eine weiterhin verfügbare Fähigkeit und eine offene Route. Sie stammt nicht aus einem laufenden Spiel.

Häufig gestellte Fragen
Welche Zustände sollten in einem Metroidvania dauerhaft gespeichert werden?
Speichere nur, was das Spieldesign nach dem Verlassen eines Raums oder einem Neustart benötigt. Dazu zählen erworbene Fähigkeiten, geöffnete Tore, die sich nur in eine Richtung passieren lassen, Ergebnisse von Bosskämpfen und dauerhafte Änderungen der Spielwelt. Verwalte vorübergehende Kampfeffekte und nicht gespeicherte Rauminteraktionen separat. Stimme die Felder auf das zuständige System und die Rücksetzregeln des bestehenden Spiels ab.
Wie füge ich eine Fähigkeit hinzu, ohne bestehende Routen zu unterbrechen?
Erfasse jede Zugangssperre, die von der Fähigkeit abhängt, und stelle sicher, dass vor dem Upgrade mindestens eine vorgesehene Route erreichbar bleibt. Prüfe Rückwege, Kontrollpunkte, Sequence Breaks und optionale Räume. Nutze die Karte als Grundlage für die Prüfung und teste anschließend jede Route im tatsächlichen Build.
Sollten geöffnete Tore nach dem Laden eines Spielstands offen bleiben?
Wenn das Tor für eine dauerhafte Änderung der Spielwelt steht, speichere eine stabile Tor-ID oder ein Welt-Flag und stelle den Raum beim Laden anhand dieses Zustands wieder her. Handelt es sich lediglich um einen temporären Schalter, verwalte ihn im Raumzustand. Richte die Entscheidung an der vorgesehenen Route aus und vermittle den Spielern, wann der Zustand zurückgesetzt wird.
Wo speichert Godot persistente Spieldaten?
Die Dokumentation zur stabilen Godot-Version beschreibt user:// als beschreibbaren Speicherort für Benutzerdaten und zeigt Beispiele für dateibasierte Spielstände. Prüfe die Zielplattform und die aktuelle Engine-Version und verwende nach Möglichkeit das vorhandene Speichersystem des Projekts. Welche Spielzustände dauerhaft gespeichert werden, legt die Dokumentation nicht fest.
Wie kann ich ein neues Fortschrittssystem sicher testen?
Verwende eine Kopie eines Spielstands und teste einen neuen Spieldurchlauf, den Erwerb der Fähigkeit, das davon abhängige Tor, den Rückweg, das erneute Laden am Kontrollpunkt und einen älteren Spielstand. Halte den Build, die Spielstandversion, den Raum und das erwartete Ergebnis fest. Eine fiktive Karte oder ein Oberflächenentwurf kann den Testplan veranschaulichen. Ob der tatsächliche Build die Tests besteht, lässt sich daraus nicht ableiten.
Erweitere das System erst, wenn der Ablauf funktioniert
Ordne jeder dauerhaften Fähigkeit und jeder bleibenden Änderung der Spielwelt die zugehörigen Zugangssperren, Rückwege und Rücksetzregeln zu. Halte auch fest, welches System die Daten speichert. Setze einen Vertical Slice um und prüfe den Erwerb der Fähigkeit, den Rückweg, das erneute Laden und das Verhalten älterer Spielstände, bevor du das Muster auf weitere Teile der Karte überträgst. So bleibt die Progression des bestehenden Spiels nachvollziehbar, und du hast eine sicherere Grundlage für die Erweiterung.
Wenn du rund um diesen Fortschrittsablauf eine eigenständige spielbare Idee skizzieren möchtest, probiere den SEELE AI Game Maker aus. Das Tool dient der Konzeptentwicklung. Für die Migration eines bestehenden Projekts ist es nicht vorgesehen.


