Importing Mods

Many Ren’Py games have community-created mods that add or modify content. Here’s how to install them in Spark.

Mods typically consist of .rpy and .rpyc script files (and sometimes images, audio, or other assets) that are placed into the game’s game/ folder. They override or extend the base game’s content.

Download the mod and extract it on your device. The mod usually contains a game/ folder with the modified files.

1. Open the Files app
2. Navigate to On My iPhone/iPad > Spark > games > [Your Game]

Copy the mod’s files into the game’s game/ folder. If prompted to replace existing files, confirm the replacement.

Important: Some mods require you to merge folders rather than replace them. iOS Files app will ask whether to replace — choose Merge if available, or manually copy individual files.

If the mod includes .rpy files without corresponding .rpyc files, delete any existing .rpyc files with the same name. Ren’Py will recompile them on next launch.

• Mods designed for a specific Ren’Py version may not work with a different engine version
• If a mod causes crashes, try matching the engine version the mod was designed for
• Some mods require specific game versions — check the mod’s documentation
• Some mod makers use encryption or custom compilation on their mod files (.rpyc), which can prevent them from loading properly on Spark

To remove a mod, delete the mod’s files from the game/ folder. If you’re unsure which files belong to the mod, reinstall the game from the original archive.

See Mod Issues for common mod-related problems.