Ein Level-Editor für Spieler kann die Lebensdauer eines Rhythmusspiels verlängern. Er berührt jedoch das Chart-Format, die Audiozeitbasis, die Punktevergabe, die Eingabe, die Speicherung und mitunter auch Community-Funktionen. Das bestehende Wiedergabesystem bleibt maßgeblich. Beginne mit einem kleinen Funktionsumfang für die lokale Bearbeitung: Ereignisse auf einem musikalischen Raster platzieren, ein Chart in der Vorschau abspielen, es validieren und einen Entwurf mit Versionsnummer speichern, ohne die Wiedergabe bereits veröffentlichter Levels zu verändern.

Dieser Leitfaden zeigt, wie du ein bestehendes Projekt um einen Editor ergänzt. Die Rhythmus-Engine bleibt dabei erhalten. Das Beispielspiel, der Soundtrack, die Oberfläche, die Chart-Daten und die Ergebnisse sind erfunden. Es standen weder Projektdateien noch Musik, ein Parser oder ein Build zur Verfügung. Die Checklisten beschreiben vorgeschlagene Prüfungen und enthalten keine Testergebnisse.
Den Funktionsumfang des Editors abgrenzen
Beginne mit einem sauberen Commit und dokumentiere ein bekanntes Chart, das bereits korrekt abgespielt wird. Halte die Audiozeitbasis, die Ladelogik für Charts, die Tempokarte, die Eingabebelegung, die Notenspuren, die Regeln für die Punktevergabe, den Song-Offset, den Speicherpfad und die Statusmerker für den Spielfortschritt fest. Falls kein Build verfügbar ist, prüfe nur die bereitgestellten Dateien und stelle klar, dass das Laufzeitverhalten unbekannt bleibt.
Beschränke die erste Version auf die wichtigsten lokalen Funktionen. Spieler sollen einen verfügbaren Musiktitel auswählen, Ereignisse platzieren und verschieben, eine Änderung rückgängig machen, einen Abschnitt in der Vorschau abspielen, einen Entwurf speichern und erneut öffnen sowie Hinweise aus der Validierung sehen können. Online-Freigabe, Bewertungen, Moderation, Abonnements und geräteübergreifende Synchronisierung lassen sich separat planen. Wenn du alles gleichzeitig hinzufügst, ist die Ursache eines neu auftretenden Timing-Fehlers schwerer zu finden.
| Bestehendes System | Vor Beginn dokumentieren | Was standardmäßig erhalten bleibt |
|---|---|---|
| Audio und Timing | Zeitquelle, Latenzausgleich, Tempowechsel | Die Zeitbasis der Wiedergabe beibehalten |
| Chart-Verarbeitung zur Laufzeit | Dateifelder, Reihenfolge der Ereignisse, Verhalten beim Laden | Kompatibilität mit veröffentlichten Charts bewahren |
| Punktevergabe und Eingabe | Trefferfenster, Namen der Eingabeaktionen, Spurzuordnung | In der Vorschau dieselben Regeln verwenden |
| Spielfortschritt | Freischaltungen, Abschlüsse, gespeicherte Punktestände | Entwürfe von offiziellen Ergebnissen trennen |
Bitte die KI, die tatsächlichen Dateien zu prüfen und vor der Bearbeitung einen Änderungsplan zu erstellen. Fordere eine Liste der Dateien an, die geändert werden dürfen, und eine Liste der Systeme, die unangetastet bleiben. Eine Anweisung wie „Füge einen Level-Editor hinzu“ ist zu offen: Sie kann dazu führen, dass die KI ein neues Timing-Modell einführt oder die funktionierende Ladelogik für Charts ersetzt. Eine sicherere Anweisung legt ein Chart-Format, einen lokalen Speicherpfad und eine kleine Editor-Ansicht fest, die den bestehenden Wiedergabecode aufruft.
Ereignisse im musikalischen Raster erfassen
Speichere für jedes Ereignis seine Position im Song. Ein Zeitstempel der Systemuhr, der beim Ziehen eines Blocks erfasst wird, eignet sich dafür nicht. Wenn das Spiel zur Laufzeit Beat-Positionen verwendet, behalte dieses Koordinatensystem bei. Wenn es mit Sekunden arbeitet, ergänze einen eigenen Adapter und überprüfe die Umrechnung anhand der bestehenden Tempokarte. Die Zeitskala des Editors und das spielbare Chart müssen in jedem Tempoabschnitt übereinstimmen.
Ein Ereignis könnte eine stabile ID, die Spur, den Takt, den Beat, dessen Unterteilung, den Ereignistyp und optional eine Dauer enthalten. Beschränke die Felder auf das Nötigste und richte sie nach der tatsächlichen Ladelogik des Projekts aus. Speichere Tempowechsel nur dann im Format, wenn das Spiel sie bereits zur Laufzeit unterstützt oder der Funktionsplan ihre Einführung ausdrücklich vorsieht. Leite niemals ein vollständiges Schema aus einem Screenshot oder aus einem Beispiel-Chart ab, das dir nicht vorliegt.

Die Dokumentation zur stabilen Godot-Version beschreibt, wie sich Dateien zur Laufzeit mit FileAccess und verwandten APIs lesen und schreiben lassen. Sie enthält auch Beispiele für den Umgang mit Inhalten, die Nutzer bereitstellen. Der Leitfaden zu Datenpfaden dokumentiert user:// für dauerhaft gespeicherte Nutzerdaten. Diese Quellen zeigen, welche Möglichkeiten die Engine für Dateizugriffe bietet. Sie schreiben kein Chart-Format vor, geben keine Sicherheitsgarantie und belegen keine getestete Implementierung von Pulse Harbor.
Verwende stabile IDs, damit sich die IDs der übrigen Ereignisse nicht ändern, wenn du ein Ereignis verschiebst oder löschst. Lege für die Wiedergabe eine eindeutige Sortierreihenfolge fest und definiere, wie gleichzeitige Noten behandelt werden. Unterscheide außerdem zwischen einem fehlenden optionalen Feld und einem ungültigen Pflichtfeld. Falls das Projekt Charts bereits als Ressourcen speichert, verwende einen Editor-Adapter für dieses Format, statt es mit einer parallelen Datenstruktur zu umgehen.
Bearbeitung nachvollziehbar und rückgängig machbar gestalten
Verwende ein Beat-Raster mit Zoom, der die gespeicherten Zeitpositionen nicht verändert. Ein Klick fügt ein Ereignis hinzu. Durch Ziehen lässt es sich verschieben. Eine sichtbare Markierung macht klar, welches Ereignis beim Löschen entfernt wird. Änderungen lassen sich rückgängig machen. Tastenkürzel dürfen nicht mit den bestehenden Eingabeaktionen des Spiels kollidieren. Zeige den aktuellen Takt, die Beat-Unterteilung, die ausgewählte Spur und die Wiedergabeposition an, damit Spieler nachvollziehen können, was ihre Eingaben bewirken.
Halte die Bearbeitung von Entwürfen vom offiziellen Spielfortschritt getrennt. Eine Vorschau darf weder Spielfortschritt gutschreiben noch ein veröffentlichtes Chart überschreiben oder einen Punktestand an eine Bestenliste übermitteln. Speichere Entwürfe in einem eigenen Ordner und behalte eine Kopie des Originals, wenn ein Spieler ein bestehendes benutzerdefiniertes Chart öffnet. Unterstützt das Spiel nur mitgelieferte Songs, sollte der Editor diese zur Auswahl anbieten. Er sollte nicht den Eindruck erwecken, dass sich beliebige Audiodateien importieren lassen.
Im fiktiven Beispiel Pulse Harbor speichert der Editor einen lokalen Chart-Entwurf mit Versionsnummer und verwendet die bestehende Vorschau-Szene. Das ist ein Vorschlag für den Aufbau und keine Beschreibung tatsächlich vorhandener Dateien oder einer erfolgten Integration. In deinem Projekt kann ein anderer Zuschnitt nötig sein, insbesondere wenn das Laden von Charts an den Import von Ressourcen gekoppelt ist.
Lokale Chart-Dateien vor der Vorschau validieren
Behandle eine von Spielern erstellte Datei als Daten, die geprüft werden müssen. Führe ihren Inhalt nicht als Anweisungen aus. Prüfe die Dateiversion, Pflichtfelder, Spur-IDs, Ereignistypen, Wertebereiche, doppelte IDs und den referenzierten Musiktitel. Weise Charts zurück, die Projektgrenzen überschreiten oder auf eine nicht verfügbare Ressource verweisen. Formuliere Fehlermeldungen so, dass Spieler sie verstehen und den Fehler beheben können: Nenne das betroffene Ereignis oder Feld und erkläre, was zu korrigieren ist.
Unterscheide Warnungen von Fehlern, die eine Vorschau verhindern. Eine ungewöhnliche, aber zulässige Notendichte kann eine Warnung rechtfertigen. Eine fehlende Spur oder eine ungültige Beat-Position sollte die Vorschau blockieren, wenn das Spiel damit zur Laufzeit nicht umgehen kann. Begrenze Dateigröße und Ereignisanzahl anhand geeigneter Werte für das Projekt. Teste das Verhalten des Parsers mit leeren, abgeschnittenen und fehlerhaft formatierten Dateien sowie mit Dateien älterer Versionen. Die Grenzwerte müssen sich aus dem Design des jeweiligen Spiels ergeben. Es gibt hier keine pauschalen Zahlen, die du ohne Bezug zum Projekt festlegen solltest.
| Prüfbereich | Prüffrage | Verhalten im Fehlerfall |
|---|---|---|
| Version | Kann der Editor diese Schemaversion lesen? | Den Weg zur Aktualisierung oder den Grund für die Ablehnung erklären |
| Titelreferenz | Ist dieser Song im zulässigen Katalog vorhanden? | Den Musiktitel nicht stillschweigend ersetzen |
| Ereigniskoordinaten | Werden die angegebenen Spur- und Beat-Werte unterstützt? | Auf das ungültige Ereignis hinweisen |
| Ereignis-ID | Sind die IDs eindeutig und stabil? | Eine sichere Korrektur anbieten oder das Speichern blockieren |
| Dateigrenzen | Liegt der Inhalt innerhalb der Projektgrenzen? | Den Vorgang vor dem Laden kontrolliert abbrechen |
Die kleinstmögliche Projektänderung planen
Vergleiche einen Patch vor der Übernahme mit der Liste der vorgesehenen Dateiänderungen. Eine klar begrenzte erste Version kann eine Editor-Szene, einen Editor-Controller, einen Adapter für Chart-Daten, einen Dienst für lokale Entwürfe und einige Tests umfassen. Der Patch sollte nicht nebenbei sämtliche Song-Daten umschreiben, Trefferfenster ändern, den Audiotreiber anpassen oder Chart-Entwürfe in den offiziellen Spielfortschritt einbeziehen.
Bitte die KI, den vollständigen Diff zu zeigen, ihre Annahmen zur Kompatibilität zu nennen und zu beschreiben, wie sich die Funktion wieder entfernen lässt. Arbeite auf einem eigenen Branch oder mit einer Projektkopie. Lass ein bekanntes Chart und eine Referenzaufnahme unverändert. Wenn eine neue Datenversion nötig ist, erstelle einen Migrationsplan und teste ihn an Kopien der Charts, bevor du Spielerdaten veränderst. Falls sich die Wiedergabe ändert, kehre zum Ausgangsstand zurück und grenze die Ursache ein.
Timing und Regressionen an einer Projektkopie prüfen
Prüfe mehr als nur, ob sich der Editor öffnen lässt. Vergleiche dasselbe bekannte Chart vor und nach der Änderung. Prüfe eine Note am Anfang, einen mittleren Abschnitt, einen Tempowechsel und das Ende. Vergewissere dich, dass Wiedergabeposition im Editor, Ton in der Vorschau, Notenanimation, Treffererkennung und Punktevergabe dieselbe Zeitquelle verwenden. Ein optisch korrekt ausgerichtetes Raster belegt weder, dass die Audiolatenz stimmt, noch dass das Timing beim Spielen korrekt ist.

| Vorgeschlagene Prüfung | Aktion | Dokumentieren |
|---|---|---|
| Referenz-Chart | Ein bekanntes Chart im alten Build abspielen | Build, Musiktitel und erwartete Zeitstempel |
| Speichern und erneutes Öffnen im Editor | Ereignisse platzieren, den Entwurf speichern, erneut öffnen und in der Vorschau abspielen | Gespeicherte Ereignisdaten und etwaige Abweichungen |
| Tempowechsel | Ereignisse vor und nach einem Tempowechsel platzieren | Beat, Position im Audio und angezeigte Wiedergabeposition |
| Fehlerhafte Datei | Dateien mit fehlenden, ungültigen und nicht unterstützten Feldern ausprobieren | Verständliche Fehlermeldung ohne Absturz |
| Regression | Das unveränderte Referenz-Chart erneut spielen | Timing, Punktevergabe, Eingabe, Spielfortschritt |
| Rückkehr zum Ausgangsstand | Den Branch mit der neuen Funktion entfernen oder eine Kopie wiederherstellen | Das ursprüngliche Chart bleibt spielbar |
Diese Tabelle ist ein Prüfvorschlag und kein Beleg dafür, dass das Timing korrekt geblieben ist. Halte bei tatsächlichen Tests die Projektversion, das Audiogerät, das Chart, die Offsets, die genaue Aktion, das erwartete und das beobachtete Verhalten sowie etwaige Regressionen fest. Stelle eine generierte Beispieloberfläche nicht als Beleg dafür dar, dass ein Editor oder eine Prüfansicht existiert.
Veröffentlichung und Teilen in der Community separat planen
Wenn Charts langfristig geteilt werden sollen, kläre zuerst Moderation, Meldefunktionen, Löschung, Eigentumsrechte, Musiklizenzen, Speichergrenzen und Kompatibilität zwischen Spielversionen. Ein lokaler Editor bietet nicht automatisch eine sichere Online-Bibliothek. Gib erst dann an, dass von Spielern erstellte Charts veröffentlicht oder heruntergeladen werden können, wenn die entsprechenden Dienste und Richtlinien umgesetzt und getestet sind.
Wenn du unabhängig davon ein eigenes Rhythmusspiel-Konzept ausprobieren möchtest, kannst du den SEELE AI Game Maker nutzen. Das Tool dient der Konzeptentwicklung und ist kein Editor für bestehende Projekte.
Häufig gestellte Fragen
Was sollten Spieler mit einem Level-Editor für ein Rhythmusspiel tun können?
Beginne mit den Funktionen zum Erstellen und Abspielen eines Charts in der Vorschau: einen Musiktitel auswählen, Ereignisse auf einem Beat-Raster platzieren, sie bearbeiten oder Änderungen rückgängig machen und den Entwurf speichern und validieren. Plane Veröffentlichung, Teilen und Moderation als separate Funktionen, bis die lokale Bearbeitung zuverlässig funktioniert.
Sollten Chart-Ereignisse in Sekunden oder in Beats gespeichert werden?
Wenn das Spiel bereits eine Tempokarte hat, verwende möglichst eine stabile musikalische Position aus Takt, Beat und Unterteilung. Rechne diese über das bestehende Timing-System in Wiedergabezeit um. Behalte die aktuelle Audiozeitbasis und die Regeln für Offsets bei. Teste anschließend Tempowechsel und Noten nahe den Übergängen zwischen Abschnitten.
Wie kann ich einen Editor hinzufügen, ohne die Wiedergabe zu verändern?
Behalte die aktuelle Ladelogik für Charts, die Audiozeitbasis, die Punktevergabe, die Eingabe und die Notenspuren als Ausgangspunkt bei. Lass den Editor Daten im bestehenden Laufzeitformat oder über einen versionierten Adapter erzeugen. Vergleiche ein bekanntes Chart vor und nach der Änderung. Nimm die Änderung zurück, wenn sich die Zeitpositionen seiner Ereignisse verschieben.
Wie sollten von Spielern erstellte Charts validiert werden?
Prüfe vor der Vorschau die Dateiversion, Pflichtfelder, die Titelreferenz, Ereignistypen, zulässige Beat-Bereiche, doppelte IDs und nicht unterstützte Werte. Zeige behebbare Probleme im Editor an und weise fehlerhaft formatierte Inhalte sicher zurück. Eine Schema-Checkliste belegt nicht, dass ein realer Parser jede bösartig präparierte Datei sicher verarbeitet.
Kann KI einen Level-Editor in mein bestehendes Rhythmusspiel einbauen?
KI kann bereitgestellte Dateien prüfen, einen klar begrenzten Patch vorschlagen und Testfälle für die Validierung entwerfen. Ohne das tatsächliche Projekt und entsprechende Tests kann sie Timing und Kompatibilität nicht überprüfen. Gib ihr eine Liste der Dateien, die sie ändern darf, ein unverändertes Referenz-Chart, das erwartete Beat-Timing und einen Commit, zu dem du zurückkehren kannst. Prüfe den vollständigen Diff.
Chart-Bearbeitung ergänzen, ohne die Wiedergabe umzuschreiben
Die bestehende Rhythmus-Engine bleibt für das Timing zuständig. Ergänze einen kleinen lokalen Editor, der musikalische Ereignisse in einem versionierten Format speichert, sie vor der Vorschau validiert und Entwürfe von veröffentlichten Charts und offiziellen Punkteständen trennt. Prüfe den Diff, teste bekannte Charts an einer Projektkopie und bewahre einen Stand auf, zu dem du zurückkehren kannst. Bis das tatsächliche Spiel getestet wurde, gelten alle Ergebnisse als ungeprüft.


