Help and troubleshooting
UniPatcher FAQ
Learn how ROM patching works, prepare compatible files and diagnose the errors most often caused by mismatched input.
Getting started
What is UniPatcher?
UniPatcher is an Android utility that applies patch files to compatible video-game ROM files. It supports common patch standards and writes the result to an output file you choose.
What is a ROM patch?
A patch describes changes to a particular source file. Those changes can translate text, fix bugs, alter graphics or modify game behavior without packaging the full original game. The patch normally expects one exact ROM region and revision.
How do I apply a patch?
- Extract the ROM and patch if either is inside an archive.
- Open Apply patch and select the patch file.
- Select the matching ROM file described by the patch author.
- Choose a new output filename and location, then run the patch.
- Test the output with an emulator for the original game system.
Keep an untouched backup. The visual Apply patch guide shows every selector, the Android save screen and the completion message.
Can UniPatcher patch Android games or installed apps?
No. UniPatcher works with ROM files used by emulators for older game systems. It is not designed to modify Android application packages, installed games or live game data.
Files and compatibility
Which patch formats are supported?
UniPatcher 0.17.3 supports these documented formats:
- IPS
- IPS32
- UPS
- BPS
- APS (GBA)
- APS (N64)
- PPF
- DPS
- EBP
- XDelta3
XDelta3 is supported; that does not imply compatibility with every older XDelta variant. Use the patch format and file named by the patch author.
Do I need to extract ZIP, 7Z or RAR files?
Yes. An archive is a container, not the ROM or patch itself. Extract it with a suitable file manager, then select the actual patch and ROM files inside. An unusual extension alone does not prove that a file is unsupported.
Why does UniPatcher say the ROM is incompatible?
The patch may expect a different region, language, revision, checksum, dump format or header state. Compare the filename, hash values and any preparation instructions supplied by the patch author. Do not assume two files are identical because they have the same game title.
Does UniPatcher include ROMs or games?
No. You must provide a ROM you are legally entitled to use. The app and this website do not distribute commercial game files or promise that a third-party patch is lawful in every jurisdiction.
Troubleshooting
Why is the output broken after applying an IPS patch?
IPS does not contain strong built-in source-file validation, so a patch can be applied to the wrong ROM and still produce an output. Verify the exact ROM region, revision, original size and required header state. If hashes are published, compare them before applying the patch again.
Should I ignore a checksum mismatch?
Usually not. A mismatch is evidence that the selected file differs from the source expected by the patch. Continuing can create a corrupt or unstable result. Only proceed when the patch author's instructions explicitly explain why the warning is safe for that particular release.
What should I check when patching fails?
- Confirm that both inputs are extracted and readable.
- Use the precise ROM version and region requested by the patch.
- Make sure Android has free storage and UniPatcher can access the output location.
- Avoid overwriting the original; choose a new filename.
- Read the patch's own documentation for header or checksum requirements.
Tools and support
Can UniPatcher create patch files?
It can create XDelta3 patches from an original file and a modified file. Patch creation is not claimed for every format the app can apply. Follow the XDelta creation guide to keep the source, modified and output fields in the correct order.
What additional ROM tools are included?
UniPatcher can fix checksums for Sega Mega Drive and Genesis ROMs and remove SMC headers from Super Nintendo ROMs. The checksum tool does not create a backup, and the SMC tool removes headers only.
Where can I get help or report a bug?
Search the GitHub issue tracker for the exact error. For a new report, include UniPatcher version 0.17.3, Android version, patch format, steps and error text. Do not attach copyrighted ROM files.