Versionsauswahl

Spark enthaelt mehrere Ren’Py-Engine-Versionen und laesst dich waehlen, welche fuer jedes Spiel verwendet werden soll.

Spark buendelt die folgenden Ren’Py-Engine-Versionen:

Wenn du ein Spiel importierst, erkennt Spark die Ren’Py-Version, die mit dem Spielarchiv gebuendelt war (aus Engine-Versionsdateien wie vc_version.py, __init__.py oder deren kompilierten Aequivalenten) und verwendet sie, um eine kompatible Engine vorzuschlagen.

Die script_version.txt des Spiels ist eine separate Datei, die intern von Ren’Py verwendet wird, um Kompatibilitaets-Flags fuer die Skript-Schicht zu setzen — sie ist nicht dasselbe wie die Engine-Version.

Spark bietet zwei Engine-Vorschlagsstrategien (konfigurierbar in den Einstellungen):

• Genau (Standard) — Empfiehlt eine Engine, die der gleichen Nebenversion entspricht (z.B. ein 7.5.x-Spiel bekommt die 7.5.3-Engine)
• Neueste — Empfiehlt die neueste Engine innerhalb der gleichen Hauptversion (z.B. ein 7.x-Spiel bekommt die neueste 7.x-Engine, ein 8.x-Spiel bekommt die neueste 8.x-Engine)

Die Engine-Laufzeitversion wird unter der Spiel-starten-Schaltflaeche auf dem Spieldetail-Bildschirm angezeigt. Es gibt zwei Versionseinstellungen, die du aendern kannst:

Dies steuert, welche gebuendelte Ren’Py-Engine Spark zum Ausfuehren des Spiels verwendet.

1. Tippe auf Modify neben der Engine-Version auf dem Spieldetail-Bildschirm
2. Waehle aus der Versionsauswahl
3. Tippe auf Confirm

Wenn du die Engine geaendert hast und Probleme feststellst, kannst du zuruecksetzen:

• Die Originalversion wird automatisch gespeichert
• Verwende die Revert-Schaltflaeche in der Versionsauswahl, um zurueckzukehren

Dies aktualisiert die script_version.txt des Spiels, die steuert, wie Ren’Pys interne Kompatibilitaetslogik angewendet wird. Ren’Py verwendet diesen Wert, um rueckwaertskompatibles Verhalten fuer aeltere Spiele zu aktivieren oder zu deaktivieren.

Das Aendern kann Probleme loesen, bei denen ein Spiel bestimmte Legacy-Verhaltensweisen erwartet, die in neueren Engine-Versionen geaendert wurden. Siehe die Ren’Py-Dokumentation zu inkompatiblen Aenderungen fuer Details zu den Aenderungen zwischen Versionen.

• Spiel stuerzt beim Start ab — Versuche eine andere Engine-Version
• Fehlende Funktionen — Einige Spiele erfordern bestimmte Ren’Py-Versionen
• Leistungsprobleme — Neuere Engines koennen besser performen
• Kompatibilitaet — Aeltere Spiele benoetigen moeglicherweise aeltere Engines

Jedes Spiel in Spark hat drei optionale Startmodi, die steuern, wie viel von Sparks Engine-Patching und Laufzeit-Integration aktiv ist. Diese findest du in den Spieleinstellungen (langes Druecken auf ein Spiel in der Bibliothek).

Der Safe Mode startet das Spiel mit einer unmodifizierten Standard-Ren’Py-Engine anstelle von Sparks benutzerdefiniertem Patch-Build. Sparks Engine-Modifikationen und Skript-Injektionen werden deaktiviert, aber das Overlay und die Laufzeitfunktionen bleiben verfuegbar.

Die Start-Schaltflaeche wird gruen und zeigt “Safe Launch” an, wenn dieser Modus aktiv ist.

Wann verwenden: Ein Spiel stuerzt ab oder verhaelt sich fehlerhaft und du vermutest, dass Sparks Engine-Patches die Ursache sind.

Der Advanced Mode ist fuer Spiele konzipiert, bei denen der Entwickler Aenderungen direkt an der Python-Schicht der Ren’Py-Engine vorgenommen hat. Einige Spiele werden mit einem modifizierten renpy/-Verzeichnis ausgeliefert, das benutzerdefinierten Engine-Code enthaelt — ohne diese Modifikationen kann das Spiel abstuerzen oder sich fehlerhaft verhalten. Wenn aktiviert:

• Spark sucht nach einem advanced/renpy-Verzeichnis im Spielordner
• Alle dort gefundenen Python-Quelldateien ueberschreiben die integrierten Ren’Py-Quellen der Engine
• Ein separater Engine-Versionswaehler erscheint, unabhaengig vom normalen Versionswaehler

Die Start-Schaltflaeche wird pink und zeigt “Advanced Launch” an, wenn dieser Modus aktiv ist.

Wann verwenden: Das Spiel enthaelt benutzerdefinierte Aenderungen am Python-Quellcode von Ren’Py (ein modifiziertes renpy/-Verzeichnis). Dies ist ungewoehnlich, aber einige Spiele sind auf Engine-Level-Aenderungen fuer benutzerdefinierte Funktionen, UI-Frameworks oder Kompatibilitaets-Workarounds angewiesen.

Dieser Modus entfernt Sparks Laufzeitschicht vollstaendig aus der Spielsitzung. Wenn aktiviert:

• Die Spark-Overlay-UI (Spielsteuerung, Quick Menu, Tastaturhelfer, UI-ausblenden-Schaltflaeche) erscheint nie
• Alle Laufzeit-Python-Injektionen werden uebersprungen — Dialog-Tracking, Galerie-Freischalter, Gestenkonfiguration, Lautstaerke-Sync, Uebersetzungssystem und Tastenbelegungs-Ueberschreibungen sind alle deaktiviert
• Das Spiel laeuft ohne jegliche Spark-Laufzeitmodifikationen
• RPY-basierte Einstellungen (Developer Mode, Konsole, transparente Textbox) funktionieren weiterhin, da Ren’Py sie selbst laedt, anstatt dass Spark sie injiziert

Wann verwenden: Ein Spiel steht in Konflikt mit Sparks Laufzeitfunktionen und der Safe Mode allein hat das Problem nicht geloest. Dies bietet maximale Kompatibilitaet und Isolation auf Kosten aller Spark-Overlay-Funktionalitaet.