Automatisierte Validierung
In Arbeit
Diese Dokumentation wird noch erweitert und überarbeitet. Funktionen, Screenshots und Beschreibungen können sich bis zur öffentlichen Veröffentlichung von Talescape ändern. Wenn etwas unklar ist oder du Hilfe brauchst, frag bitte im offiziellen Talescape Discord. Wir klären das gern oder aktualisieren die Seiten nach Bedarf.
Das Editor Checks System hilft dir zu überprüfen, ob deine Story vollständig, konsistent und veröffentlichungsbereit ist. Es durchsucht deine Story automatisch nach häufigen Problemen (von fehlenden Assets bis zu unvollständigen Metadaten) und gibt dir detailliertes Feedback, was zu beheben ist.
Die gleichen Prüfungen kommen auch während der automatisierten Überprüfung zum Einsatz, die vor der Veröffentlichung läuft. Wenn du sie bereits im Editor ausführst, kannst du Probleme frühzeitig lösen und eine Ablehnung während des Release vermeiden.
1. Checks ausführen
Du kannst Checks auf zwei Arten auslösen:
| Umfang | Beschreibung |
|---|---|
| Globaler Check (Übersicht) | Führt alle verfügbaren Validierungen für deine gesamte Story aus. Zugänglich über das Checks-Panel in der Seitenleiste. |
| Lokaler Check (Pro Element) | Führt Validierungen für das Element aus, das du gerade bearbeitest, z. B. ein bestimmtes Kapitel, eine Szene oder einen Dialog. |
Ergebnisse werden sofort angezeigt und nach Kategorien gruppiert (z. B. Marketplace, Kapitel, Szenen, Charaktere). Du kannst die Checks jederzeit erneut ausführen, indem du auf Checks ausführen klickst.
2. Schweregrade
Jedes Problem bekommt einen Schweregrad, der seine Wichtigkeit anzeigt:
| Schweregrad | Beschreibung | Aktion |
|---|---|---|
| Info | Information oder Vorschläge. | Keine Aktion erforderlich, kann aber die Qualität verbessern. |
| Warnung | Potenzielle Probleme, die je nach Kontext relevant werden können. | Prüfen und gegebenenfalls beheben. |
| Fehler | Kritische Fehler, die die Veröffentlichung deiner Story verhindern. | Muss vor dem Erstellen eines Release behoben werden. |
Fehler werden deutlich hervorgehoben. Eine Story mit irgendwelchen Fehlern kann nicht veröffentlicht werden, bis diese behoben sind.
3. Typische Checks
Das System deckt sowohl technische als auch strukturelle Validierungen ab, wie zum Beispiel:
| Kategorie | Beispielprüfungen |
|---|---|
| Marketplace | Beschreibungslänge, Screenshots und Tag-Anforderungen. |
| Kapitel | Jedes Kapitel hat eine Startszene und mindestens einen Ausgang. |
| Szenen | Jede Szene hat einen Hintergrund und wird irgendwo in der Story verwendet. |
| Dialoge | Keine unerreichbaren Zweige oder fehlenden Ziele. |
| Medien | Alle referenzierten Assets existieren und entsprechen den geforderten Formaten. |
| Gegenstände / Handwerk | Rezepte und Item-Verweise sind gültig. |
Jeder Check zeigt sein Ergebnis, einen Zeitstempel und eine detaillierte Meldung an, damit du genau weißt, was du anpassen musst.
4. Lokale Checks beim Bearbeiten
Du kannst lokale Checks auch direkt in Editoren wie Scenes, Dialogues oder Chapters ausführen.
Diese fokussierten Prüfungen überprüfen nur den Inhalt, an dem du gerade arbeitest — ideal für eine schnelle Validierung, bevor du mit der Entwicklung weitermachst.
Beispiel: Beim Bearbeiten einer Szene bestätigen lokale Checks, dass sie einen Hintergrund hat, gültige Ausgänge besitzt und irgendwo in der Story verwendet wird.
5. Release-Integration
Dasselbe Validierungssystem wird während der automatisierten Überprüfungsphase des Release-Workflows verwendet. Wenn du bereits alle im Editor Checks System angezeigten Probleme behoben hast, besteht deine Story automatisch die automatisierte Überprüfung.
Das gewährleistet einen reibungslosen Übergang von der Entwicklung zur Veröffentlichung.
6. Beste Vorgehensweisen
- Führ volle Story-Checks regelmäßig aus, besonders vor der Einreichung.
- Behebe alle Fehler und überprüfe Warnungen, um Überraschungen während der Prüfung zu vermeiden.
- Nutze häufig lokale Checks beim Bearbeiten, um Probleme früh zu erkennen.
- Prüfe die Zeitstempel, um nachzuvollziehen, wann welcher Check zuletzt ausgeführt wurde.
Das Editor Checks System fungiert als dein internes Qualitätsgate und stellt sicher, dass jede auf Talescape veröffentlichte Story stabil, vollständig und bereit ist, von Dreamers erkundet zu werden.