Mod Issues

Symptom: Game launches but the mod content doesn’t appear.

Solutions:

1. Check file placement — Mod files must be in the game’s game/ folder

   • Open Files > On My iPhone > Spark > games > [GameName] > game
   • Verify mod files are here, not in a subfolder

2. Delete compiled files — If the mod includes .rpy files, delete matching .rpyc files

   • Ren’Py may be using old compiled versions instead of the mod

3. Check game version — The mod may require a specific game version

Solutions:

1. Check compatibility — Ensure the mod was made for your game version
2. Try a different engine — Some mods were built for specific Ren’Py versions
3. Enable Safe Mode — Test if the crash is mod-related
4. Remove the mod — Delete the mod files and verify the base game works

iOS Files app handles file merging differently than desktop:

• When copying a folder that already exists, iOS may offer Replace or Keep Both
• Choose Replace to overwrite existing files with mod versions
• If you need to merge (keep some original files, add mod files), copy individual files instead of the whole folder

1. Backup first — Back up your saves before installing mods
2. Read mod instructions — Each mod may have specific installation steps
3. Test after install — Launch the game immediately to verify the mod works
4. Keep the mod archive — In case you need to reinstall