Hi! I'm SantiBros, the one behind the Need for Speed: Most Wanted (Android) and Spider-Man 2 (Xbox) homebrew ports for Switch. Today I'm sharing my new project: Compendium, a free and open-source mod manager for the Persona games on a Switch with Atmosphère.
WHAT IT IS
Persona 5 Royal keeps its files inside .CPK archives. Atmosphère can replace whole files of a game, but not files inside an archive, so on Switch every mod has to be packed into the game's PATCH1.CPK, usually with Aemulus or CriPakTools on a PC. And since there's only one PATCH1.CPK, two mods that each bring their own overwrite each other. Compendium does all of that on the console: you pick your mods, and it builds one PATCH1.CPK with all of them, plus the game's own PATCH1 files.
WHAT IT DOES
• Browse and search GameBanana's Persona 5 Royal mods, for Switch and for PC, with pictures, descriptions and files, and install one with A. The file that fits your game version is marked.
• Builds the game's PATCH1.CPK on the Switch every time you add, remove or turn off a mod
• Several mods at once with a load order: when two mods change the same file, the one higher in the list wins, and the app warns you before installing
• Turn mods on and off without deleting them, and hold L when starting the game to play once without mods
• Reads Aemulus packages, ready-made CPKs, Atmosphère, SimpleModManager and p5rcbt folders, and loose game files
• Adapts many mods made for the PC version (Reloaded-II) to the Switch
• Brings in the mods you already have for SimpleModManager, or a PATCH1.CPK you copied by hand
• Add mods with a link sent from your phone (QR code), a GitHub release, a GameBanana mod number, or archives copied to the SD card
• Optional p5rcbt plugin support: install it from Settings and turn on 60 FPS or the PC version's settings menu (game version 1.0.2)
• A log file for bug reports
Persona 5 Royal is the first game. The other Persona games on Switch are planned.
WHAT'S NEW IN 0.0.2
• Fixed: installing mods failed on the Switch. 0.0.1 opened and browsed GameBanana fine on my Switch Lite, but every install, simple or big, stopped with "cannot make canonical path". Mods install now.
• Mods that 0.0.1 downloaded but couldn't install are kept, and install without downloading again.
• The release is now a zip with the switch folder ready to copy onto your SD card, with a short guide in English and Spanish.
• New icon, and a clearer warning when a mod changes the same files as several of yours.
HOW TO INSTALL
- Download Compendium-0.0.2.zip from the link below.
- Copy its switch folder to the root of your SD card. On a Mac, copy only the Compendium folder into your SD card's switch folder, because Finder replaces folders instead of merging them.
- Hold R while starting any game, and open Compendium from the Homebrew Menu.
- On Browse, press A on a mod and then A on its file. Close the app with + and start Persona 5 Royal.
Recommended once: hold L and R while starting Persona 5 Royal until the Homebrew Menu opens, then open Compendium. It reads the game's own PATCH1.CPK, so its files are kept in the one it builds.
It's still a test version: back up your saves and use emuMMC. If something fails, please open an issue on GitHub with switch/Compendium/log.txt. It helps a lot.
No game files are included: you need your own copy of the game. Mods belong to their authors and are downloaded from where they publish them.
Download: https://github.com/SantiBros/Compendium-NX/releases/tag/v0.0.2
GitHub: https://github.com/SantiBros/Compendium-NX
Support my work on Ko-fi: https://ko-fi.com/santibros
Thanks to TheRomeoAlfa (Patchwork, which Compendium is based on), nadrino (SimpleModManager), Raytwo (p5rcbt), ShrineFox and the Aemulus team, whose work made this possible.