Get started with Vita3K and play your favorite PSVita games!
Goal: Add a robust, user-friendly feature that reliably converts legacy Scratch project ZIP exports (or malformed/partial ZIPs) into valid .sb3 files so projects open in modern Scratch.
| Problem | Likely Cause | Fix |
|---------|--------------|-----|
| File loads but sprites are missing | assets folder is missing or incorrectly named | Ensure the folder is exactly assets (lowercase) |
| "Corrupted file" error after renaming | ZIP contains extra system files | Use 7-Zip or WinRAR to delete __MACOSX folder before renaming |
| Works on computer but not on Scratch website | File size > 50 MB | Compress images/sounds or split the project |
| project.json not found | You zipped the parent folder | Re-zip the contents only (Step 3 above) |
Smart ZIP-to-SB3 Repair & Conversion
Some games require the system modules be present for Vita3K to (low level) emulate them. This can be done by installing the PS Vita firmware through Vita3K.
The firmware can be downloaded from the official PlayStation website, there's also an additional firmware package that contains the system fonts that needs to be installed. The font firmware package can be downloaded straight from the PlayStation servers.
Install both firmware packages using the File > Install Firmware menu option.
System modules can be managed in the Configuration > Settings > Core tab of the emulator,
we recommend Modules Mode > Automatic.
And if you have doubts some modules are causing crashes you can try to remove them.
Goal: Add a robust, user-friendly feature that reliably converts legacy Scratch project ZIP exports (or malformed/partial ZIPs) into valid .sb3 files so projects open in modern Scratch.
| Problem | Likely Cause | Fix |
|---------|--------------|-----|
| File loads but sprites are missing | assets folder is missing or incorrectly named | Ensure the folder is exactly assets (lowercase) |
| "Corrupted file" error after renaming | ZIP contains extra system files | Use 7-Zip or WinRAR to delete __MACOSX folder before renaming |
| Works on computer but not on Scratch website | File size > 50 MB | Compress images/sounds or split the project |
| project.json not found | You zipped the parent folder | Re-zip the contents only (Step 3 above) |
Smart ZIP-to-SB3 Repair & Conversion