TheRealRetro
b75d1130e3
The updater wrote the new files with fopen(), which gives no execute permission, so the console refused to start the updated eboot.bin (CE-107750-0). 0.6.3 unpacks the update next to the app folder with 0777 permissions (as an FTP copy gets), closes, and its helper payload swaps the folders so ShadowMountPlus installs the app again (ProsperoUpdateJob). The release zip is now Mupen64PlusPS5.zip: 0.6.0-0.6.2 look for PPSA99064.zip, so they never offer an update their updater would break.
Mupen64Plus PS5
mupen64plus-core 2.6.0, the Nintendo 64 emulator, as a native PS5 home-screen app for jailbroken consoles: a game shelf with box art, DualSense support with rumble, save states, and the x86-64 dynarec, so games like GoldenEye 007 and Donkey Kong 64 run at full speed.
Title ID PPSA99064. No games are included: use ROMs you dumped yourself.
Install
Requirements: a jailbroken PS5 with kstuff (or kstuff-lite), ShadowMountPlus, and an ELF loader running (elfldr, etaHEN or PS5 Payload Manager's: the usual setup).
- Download
Mupen64PlusPS5.zipfrom the latest release. - Copy the
PPSA99064folder to/data/homebrew/on the console (FTP...), or tohomebrew/on an exFAT USB drive. ShadowMountPlus adds Mupen64Plus PS5 to the home screen. - Put your ROMs (
.z64 .n64 .v64 .rom, zipped or not) in/data/mupen64plus/roms, or inmupen64plus/romson a USB drive.
Nothing to send by hand: when the app starts, it sends the helper built into eboot.bin to the ELF loader,
which lets it out of its sandbox (/data, USB drives, executable memory for the dynarec).
Updates
The app checks this repository's latest release each time it starts. When a newer one exists it downloads
Mupen64PlusPS5.zip, checks it against the SHA-256 GitHub publishes for it, and asks:
✕ Update now / ○ Later. On ✕ it unpacks the update and closes; a background helper installs it, and a
notification says when to open the app again. Saves, states, covers and settings in /data/mupen64plus are
kept. Settings → Check for updates turns the question off.
On 0.6.0, 0.6.1 or 0.6.2? Their updater is broken (the updated app wouldn't start), so they don't see
newer releases. Install 0.6.3 or newer by hand once: delete /data/homebrew/PPSA99064, then copy the
PPSA99064 folder from Mupen64PlusPS5.zip. Updates after that work from inside the app.
Compatibility
- Compatibility list: how each tested game runs (public, view-only).
- Report a game: tested one? A short form, no account needed. Reports go straight into the list.
For a crash or a bug, please open an issue and attach /data/mupen64plus/logs/boot.log.
Documentation
ps5/README.md: controls, settings, folders, how the port works, and building.
Building and releasing (Windows + WSL Ubuntu 24.04)
build-native.bat build-native\PPSA99064\ + Mupen64PlusPS5.zip (+ .debug.elf)
build-native.bat Ffpfsc also a compressed .ffpfsc image
build-native.bat Clean from scratch (nothing reused from earlier builds)
release.bat clean build, then publish a GitHub release
Releasing:
- Raise
VERSIONinps5/Makefile, and set the matchingcontentVersioninps5/app/sce_sys/param.json(0.7.0 →00.007.000; the build stops if they differ). That number is also the release tag. - Write
release-notes/<contentVersion>.md: a few short lines, shown on the console in the update question. - Commit and push, then run
release.bat. It builds, creates the release withMupen64PlusPS5.zip, and checks GitHub's digest against the local zip.
Never reuse or lower a version.
Repository layout
mupen64plus-core/: the original core source, unmodified.ps5/: the port (plugins, PS5 layer, frontend, build).release-notes/: one file per release.
License
GPL-3.0 (LICENSE). The parts and their licenses are listed in THIRD_PARTY_NOTICES.md.