ROM hack white screen: what a bad patch does and how to fix it
A ROM hack that shows a white screen in iGBA almost always has a patched file at fault, not the app. Re-patch from a clean copy of the exact base revision the author lists, apply the patch once, keep the name iGBA gives the copy, and delete any cheats written for the original game.
This page is only about hacks. For a plain game file that will not open, such as an empty copy or a wrong extension, our black screen guide is the right one.
Patch problems, most likely first
| Cause | How it shows up | Fix |
|---|---|---|
| Wrong base revision | White screen, or iGBA refuses a UPS or BPS patch | Patch the exact revision the author lists |
| Patched twice | Blank screen or garbage | Start again from the clean backup |
| IPS on the wrong base | Broken file, no warning at all | Check the base by hand; IPS cannot |
| Patch for another hack version | Odd graphics or a freeze early on | Use the patch that matches your version |
| Cheats from the original game | Picture breaks after adding a code | Remove them from Cheats |
| Wrong save type | Save errors, or save damage later | Set Flash 128K, reopen |
Redo the patch from scratch
- Delete the broken game from iGBA with Delete ROM File. Only the game file goes; saves stay.
- Find the original backup in your library, not the patched copy. If you only have the patched copy, you need a fresh backup from your cartridge.
- Compare it with the base the author lists. iGBA checks UPS and BPS patches against it and refuses a mismatch; IPS patches are never checked.
- Pick the patch with Import ROMs, choose the clean original and tap Apply Patch, once.
- Open the new copy. To keep your progress, export the old save first and bring it in with Import .sav.
The step people skip is the first. A clean original makes the rest quick, and every other fix assumes it.
Why IPS fails without a word
An IPS patch is a list of byte positions and the bytes to write there. It never looks at what is already in those positions. Give it a file from another revision and it overwrites the wrong bytes, then reports success. UPS and BPS carry a checksum of the file they expect, so iGBA stops you before it writes anything.
Cheats and old codes
A hack moves data around. A cheat code written for the original game may write to a place that now holds something else. Remove everything from the Cheats list, play a minute, then add codes one at a time.
A renamed file, a missing save
If the hack runs but your progress is gone, you probably renamed the file. iGBA ties the save to the file name, so the old save, named after the old file, is still there. Rename the file back, or long-press the game and use Import .sav with the old save.
Save corrupted or save type
Big hacks such as Radical Red use a 128K flash chip. On 64K the game stumbles late, and a save written that way is missing half its data. Check Save diagnostics under Settings → Saving; our Flash 128K guide explains the rest and how to recover.
Questions and answers
Why does my ROM hack show a white screen?
Why is Radical Red white on my iPhone?
Why is my ROM hack not working at all?
Is my Radical Red save file corrupted?
Do I need a BIOS file for a hack?
More iGBA guides
- How to save a state and load it back in a GBA emulator
- How to rewind a mistake and speed up a GBA emulator
- How to use cheat codes in a GBA or GBC emulator
- How to use the GBA link cable nearby or online, or trade with yourself on one iPhone
- How to Use an Xbox or PS5 Controller With a GBA Emulator on iPhone
- How to play GBA and GBC games on Apple Watch
- How to back up GBA save files before a reinstall or new phone
- How to transfer your GBA saves between iPhone and Android
- GBA emulator black screen: what to check, in order
- How to open a GBA file on an iPhone or iPad
- How to fix a GBA emulator save error with Flash 128K
- How to patch a ROM on iPhone with iGBA, then play the hack
- How to play Radical Red on iPhone, from patch to save file
- Play Unbound on iPhone and bring your old save along
- All questions about iGBA
- Back to iGBA