Skip to content

Compendium v0.0.2

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 06 Nov 01:28
4c6053c

Mods install on the Switch. Compendium is a mod manager for Persona games on Nintendo Switch: it installs mods for Persona 5 Royal from GameBanana and builds the game's PATCH1.CPK on the console, no PC needed. In 0.0.1 it opened and browsed GameBanana on a Switch, but every install stopped with an error; 0.0.2 fixes that. Still a test version: back up your saves, and please report what happens.

Warning

Use 0.0.4 instead. In 0.0.2, mods made to be packed on a PC with cpkmakec (like the one that brings back Persona 5's opening) install but don't show in the game.

Important

No game files are included. You need your own copy of Persona 5 Royal for Switch, and a console with Atmosphère.

Which file do I download?

File What it is
Compendium-0.0.2.zip The app. This is the only file you need.
Source code (zip / tar.gz) Added by GitHub: only the code, for building it yourself. Nothing to run.

How to install

  1. Unzip Compendium-0.0.2.zip and copy its switch folder to the root of your SD card. It joins the switch folder already there, and the app ends up in switch/Compendium/. (On a Mac, Finder replaces folders instead of joining them: copy just the Compendium folder into your SD card's switch folder.)
  2. Hold R while starting any game to open the Homebrew Menu, and choose Compendium.
  3. On Browse, press A on a mod, then A on its file. Press + to close the app and start Persona 5 Royal.

Recommended once: close the app, hold L and R while starting Persona 5 Royal until the Homebrew Menu opens, and open Compendium. It reads the game's own PATCH1.CPK so its files are kept. The full guide: docs/INSTALL.md.

Coming from 0.0.1? Copy the new switch folder over the old one. Mods that 0.0.1 downloaded but couldn't install are kept: install them again from Browse or My mods, and they won't download again.

What's new

  • Fixed: installing a mod failed on the Switch with "filesystem error: cannot make canonical path: Invalid argument", for simple and big mods alike.
  • The release is a zip with the switch folder ready to copy, with a short guide in English and Spanish (README.txt) and the inbox folder for mods you copy yourself.
  • New icon, and a clearer warning when a mod changes the same files as several of yours.

All the details are in the changelog.

What it does

  • Browse and search GameBanana's Persona 5 Royal mods, for the Switch and for PC (adapted when you install them), with pictures and descriptions.
  • Builds the game's PATCH1.CPK on the Switch from every mod that's on, keeping the game's own PATCH1 files, or a CPK for the p5rcbt plugin.
  • Aemulus packages, ready-made CPKs, Atmosphère and SimpleModManager folders, p5rcbt folders and loose game files.
  • Load order, conflict warnings, mods on and off without deleting them.
  • Mods from GameBanana, a mod number, GitHub, a link sent from your phone, or archives copied to switch/Compendium/inbox.

If something goes wrong

Hold L while starting the game to play once without mods. Open an issue with switch/Compendium/log.txt (and, for an Atmosphère error, the newest file in atmosphere/crash_reports).

Compendium.nro SHA-256: 19f1e297621f931058d44bcfe435b615191b3b48374f92e2587a20c6d4940a9b


Los mods se instalan en la Switch. Compendium es un gestor de mods de juegos Persona para Nintendo Switch: instala mods de Persona 5 Royal desde GameBanana y arma el PATCH1.CPK del juego en la consola, sin PC. En la 0.0.1 abría y exploraba GameBanana en una Switch, pero cada instalación se detenía con un error; la 0.0.2 lo arregla. Sigue siendo una versión de prueba: haz copia de tus partidas, y por favor cuéntanos qué pasa.

Warning

Usa la 0.0.4 en su lugar. En la 0.0.2, los mods hechos para armarse en un PC con cpkmakec (como el que trae la intro de Persona 5) se instalan pero no aparecen en el juego.

Important

No se incluyen archivos del juego. Necesitas tu propia copia de Persona 5 Royal para Switch y una consola con Atmosphère.

¿Qué archivo descargo?

Archivo Qué es
Compendium-0.0.2.zip La app. Es el único archivo que necesitas.
Source code (zip / tar.gz) Lo agrega GitHub: solo el código, para compilarlo tú. No hay nada que ejecutar.

Cómo instalar

  1. Descomprime Compendium-0.0.2.zip y copia su carpeta switch en la raíz de tu tarjeta SD. Se une a la carpeta switch que ya está, y la app queda en switch/Compendium/. (En un Mac, Finder reemplaza las carpetas en vez de unirlas: copia solo la carpeta Compendium dentro de la carpeta switch de tu SD.)
  2. Mantén R al abrir cualquier juego para que aparezca el Homebrew Menu, y elige Compendium.
  3. En Browse, pulsa A en un mod y luego A en su archivo. Pulsa + para cerrar la app y abre Persona 5 Royal.

Recomendado una vez: cierra la app, mantén L y R al abrir Persona 5 Royal hasta que aparezca el Homebrew Menu, y abre Compendium. Lee el PATCH1.CPK original del juego para conservar sus archivos. La guía completa: docs/INSTALL.es.md.

¿Vienes de la 0.0.1? Copia la carpeta switch nueva sobre la anterior. Los mods que la 0.0.1 descargó pero no pudo instalar se conservan: vuelve a instalarlos desde Browse o My mods, y no se descargarán de nuevo.

Qué hay de nuevo

  • Arreglado: instalar un mod fallaba en la Switch con "filesystem error: cannot make canonical path: Invalid argument", tanto con mods simples como con mods grandes.
  • La versión viene en un zip con la carpeta switch lista para copiar, con una guía corta en español e inglés (README.txt) y la carpeta inbox para los mods que copies tú.
  • Icono nuevo, y un aviso más claro cuando un mod cambia los mismos archivos que varios de los tuyos.

Todos los detalles están en el registro de cambios (en inglés).

Qué hace

  • Explora y busca los mods de Persona 5 Royal en GameBanana, de Switch y de PC (adaptados al instalarlos), con imágenes y descripciones.
  • Arma el PATCH1.CPK del juego en la Switch con todos los mods activados, conservando los archivos PATCH1 del propio juego, o un CPK para el plugin p5rcbt.
  • Paquetes de Aemulus, CPKs ya hechos, carpetas de Atmosphère y de SimpleModManager, carpetas de p5rcbt y archivos sueltos del juego.
  • Orden de carga, avisos de conflictos, mods activados o desactivados sin borrarlos.
  • Mods desde GameBanana, el número de un mod, GitHub, un enlace enviado desde tu móvil, o archivos copiados en switch/Compendium/inbox.

Si algo sale mal

Mantén L al abrir el juego para jugar una vez sin mods. Abre un issue con switch/Compendium/log.txt (y, si hubo un error de Atmosphère, el archivo más reciente de atmosphere/crash_reports).