Spiele importieren

Spark unterstuetzt mehrere Methoden zum Importieren von Ren’Py-Spielen auf dein iOS-Geraet.

• ZIP (.zip) — Am gaengigsten
• APK (.apk) — Android-Pakete
• 7-Zip (.7z) — Hohe Komprimierung
• RAR (.rar) — Legacy-Unterstuetzung
• TAR (.tar) — Unkomprimierte Archive
• Gzip (.gz) — Gzip-komprimierte TAR-Archive
• BZ2 (.bz2) — Bzip2-komprimierte TAR-Archive
• IPA (.ipa) — iOS-Anwendungsarchive
• APP (.app) — Anwendungspakete

1. Oeffne Spark und tippe auf die Import-Schaltflaeche in der Bibliothek
2. Navigiere mit dem System-Dateiauswahldialog zu deinem Spielarchiv
3. Waehle die Datei aus und warte, bis die Extraktion abgeschlossen ist

Spark prueft das Archiv vor der Extraktion:

• Berechnet die unkomprimierte Groesse, um zu ueberpruefen, ob genug freier Speicherplatz vorhanden ist
• Erkennt, ob das Archiv passwortgeschuetzt ist, und fordert dich auf, das Passwort einzugeben
• Scannt den Archivinhalt, um den game/-Ordner zu finden

Wenn mehrere Spielordner im Archiv gefunden werden, wirst du gefragt, welchen du importieren moechtest.

Das Archiv wird in ein temporaeres Staging-Verzeichnis extrahiert. Spark ueberwacht den Speicherplatz waehrend der Extraktion und stoppt, wenn der Speicher kritisch knapp wird. macOS-Artefaktordner (__MACOSX) werden automatisch entfernt.

Fuer doppelt verpackte APK-Dateien (ein ZIP, das eine APK enthaelt) erkennt Spark dies und extrahiert automatisch beide Schichten.

Nach der Extraktion organisiert Spark die Dateien im endgueltigen Spielverzeichnis:

• Spielordner — Der game/-Ordner mit Skripten, Assets und Archiven wird an seinen endgueltigen Speicherort verschoben
• Spielname — Wird aus android.json (APK-Importe), einer .py-Datei neben dem Spielordner oder dem Archivdateinamen als Fallback ermittelt
• Eindeutige Benennung — Wenn ein Spiel mit demselben Namen bereits existiert, wird ein numerisches Suffix angehaengt

Spark durchsucht die extrahierten Dateien nach dem mitgelieferten Ren’Py-Engine-Ordner (renpy/). Wenn gefunden:

• Die Engine wird im advanced/renpy/-Verzeichnis des Spiels zur Verwendung mit dem Advanced Mode gespeichert
• Die Ren’Py-Version wird aus Versionsdateien im Engine-Ordner gelesen (z.B. vc_version.py, __init__.py, script_version.txt oder deren kompilierte Aequivalente)
• Die erkannte Version wird in den Metadaten des Spiels fuer die Engine-Zuordnung gespeichert
• Fuer Android-APK-Importe wird eine mitgelieferte Datei (private.mp3) extrahiert, um die Engine wiederherzustellen und die Python-Version zu erkennen

• Benutzerdefinierte Schriftarten — Wenn die mitgelieferte Engine des Spiels geaenderte Schriftarten enthaelt (anders als Ren’Pys Standards), werden diese in den Spielordner kopiert, damit das Spiel sie zur Laufzeit verwenden kann
• Live2D-Unterstuetzung — Das Archiv wird nach Live2D-Bibliotheken durchsucht. Wenn gefunden, wird eine Markierung erstellt, damit Spark das Live2D-Framework beim Spielstart laedt

• Eine info.json-Datei wird mit dem Spielnamen, der erkannten Engine-Version, dem urspruenglichen Archivdateinamen und dem Import-Zeitstempel geschrieben
• Staging-Verzeichnisse werden bereinigt und temporaere Dateien entfernt
• Die Spielebibliothek wird aktualisiert und das neue Spiel erscheint in deiner Bibliothek

• Grosse Spiele (1 GB+) koennen eine Weile zum Extrahieren brauchen
• Einige Archivformate wie 7z koennen extrem lange zum Extrahieren brauchen, wenn das Archiv Tausende von losen Dateien enthaelt. Spiele sollten idealerweise mit .rpa-Archiven oder aehnlichen konsolidierten Formaten verpackt werden. Einige der Extraktionsbibliotheken sind fuer diese Szenarien nicht optimiert
• Wenn ein Spiel erscheint, aber nicht startet, versuche die Engine-Version in den Spieleinstellungen zu aendern
• APK-Dateien koennen vom Dateifilter ausgeblendet werden — deaktiviere ihn unter Einstellungen > Game Library