Compatibility Patches

Spark includes a set of compatibility patches that target specific games to fix known issues when running on iOS. These patches are applied automatically when Compatibility Patches is enabled in the Ren’Py Engine settings.

Patches only affect the games they target and have no impact on other games.

Issue: Black screens during animations.

The original game’s build_animation function defaults to the Android media path when it detects a mobile platform (iOS or Android). This means if the PC package was imported, the game looks for Android-format video files that don’t exist — resulting in black screens wherever animations should play.

Patch: Forces the game to detect and use both video formats regardless of which platform package was imported. This ensures animations display correctly whether the game was imported from a PC or Android build.