Troubleshooting
Having trouble? Find solutions to the most common issues below.
Common Issues
Section titled “Common Issues”| Problem | Quick Solution | Full Guide |
|---|---|---|
| Game file grayed out during import | Disable File Extension Filter | Import Problems |
| Game crashes on launch | Try a different engine version | Game Crashes |
| Black screen during videos | Try a different platform archive | Video Issues |
| Lag/heating during cutscenes | WebM software decoding limitation | Video Issues |
| App closes to home screen | Device memory limit (jetsam) | Game Crashes |
| Cannot load RPYC file | Encrypted/custom compiled scripts — report to support | Game Crashes |
| Saves not loading | Check version compatibility | Save Issues |
| Mod not working | Verify folder structure | Mod Issues |
| Controller not detected | Check Bluetooth and settings | Keyboard & Controller |
| Broken menus or UI layout | Override device variants to pc / large | Display Issues |
| Storage running low | Use Storage Manager | Storage |
Quick Fixes
Section titled “Quick Fixes”Before diving into specific guides, try these universal fixes:
- Restart the game — Close and relaunch from the library
- Try Safe Mode — Enable in Game Settings to use a vanilla Ren’Py engine without Spark’s patches
- Change engine version — In Game Settings, try a different Ren’Py version
- Reinstall the game — Delete and reimport from the archive
- Check for updates — Make sure Spark is up to date on the App Store
Still Need Help?
Section titled “Still Need Help?”- Join our Discord for community support
- Email spark@devl.ai for direct help
- Include your Spark version, device model, and any error logs when reporting issues