An imported save changed story progress
Return to the untouched original and test only a copied save. Check location, key items and major events before continuing.
Common problems and fixes
Gen2Recomp Troubleshooting
Protect your progress first, match the problem below, and try the safest fix before reinstalling Gen2Recomp or deleting anything.
Last updated:
Before changing anything
- Close Gen2Recomp normally.
- Copy important progress to a separate safe location.
- Write down version 0.8.12, your device, chosen game and enabled mods.
- Change one thing, then repeat the same action.
Quick fixes for common problems
| Problem | Likely reason | Try this first |
|---|---|---|
| Game is rejected | The region, revision or game is not recognized. | Check the exact game on the Compatibility page. Renaming the file will not change it. |
| Several games do not appear | Only one was imported, or the import did not finish. | Return to the launcher, use the import option again and add each recognized game separately. |
| Windows ZIP will not open | The ZIP is still compressed or some files were moved. | Extract the complete ZIP, keep all files together and open Gen2Recomped.exe. |
| Windows MSIX will not install | Its supplied certificate is not trusted yet. | Install the matching 0.8.12 certificate once, then open the MSIX again. Use the ZIP if you want the simpler path. |
| macOS blocks the app | The app came from outside the Mac App Store. | Confirm the current macOS ZIP, then use the normal Privacy & Security approval for this app. |
| Linux AppImage will not open | The file is not allowed to run, or the device is ARM64. | Allow the AppImage to run. Version 0.8.12 has only an x86-64 Linux package and cannot replace a missing ARM64 build. |
| Android cannot install the update | A pre-v0.7.10 app uses the older signing setup. | Export saves, verify the copies, uninstall the old app, then install 0.8.12. |
| Android game preparation stopped | The import was interrupted or the chosen data folder could not be used safely. | Reopen the launcher and use its retry option. Version 0.8.12 keeps the unfinished step and checks the folder before replacing prepared files. |
| iPhone or iPad cannot install the IPA | The app is unsigned or the seven-day period ended. | Use AltStore or Sideloadly and refresh the app with the same Apple ID. |
| Switch, Xbox or RG34XXSP setup fails | The required device setup is missing. | Check the homebrew, Developer Mode or PortMaster requirement on the Download page. |
| Dramatic Shapes is missing | It is disabled in the current mod profile. | Open the included mod manager and enable Dramatic Shapes for the selected game. Do not look for a separate 0.8.12 download. |
| No update appears on a console | Most console versions only announce updates. | Install the current console package manually. Switch users can also use its own update option. |
| Game is slow | The visual settings or mods are demanding. | Choose Auto, Balanced or Low, then test with Dramatic Shapes and other mods disabled. |
If a game opens but something is missing
First check the game's current status. Red, Blue, Gold and Silver are the safest choices. Yellow and FireRed are Alpha, Crystal and Polished Crystal are Beta, Prism is experimental, and Platinum is marked WIP.
- Emerald currently has no music or sound playback.
- Emerald still has unfinished Battle Frontier and side activities.
- Prism dialogue and map events can behave incorrectly.
- Platinum now has maps, battles, menus and activities, but unfinished commands, screens, animations and story behavior remain.
- Dramatic Shapes does not yet give every object a custom 3D shape.
These are current project limits, not problems that reinstalling the app will fix.
Check every game's statusIf saves, editors or mods cause problems
A save-editor change went wrong
Restore the backup made before editing. Change one Party, Box, Item, Event, Map or Dex value at a time.
A map pack causes a problem
Disable that pack in the current profile and confirm the unedited map works. The original game file itself should remain unchanged.
The app works with mods disabled
Turn mods back on one at a time. The first one that returns the problem is the best place to start.
If controls or link play do not respond
- Open Options → Controls and confirm every button.
- Reconnect a controller before reopening Gen2Recomp.
- On mobile, check both portrait and landscape touch layouts.
- For internet link play, confirm the chosen UDP port can reach the host or use a private network app.
- Link sessions use normal speed and turn off gameplay-changing mods, so this behavior is expected.
Check the controls guide for the full button list.