From c574050222a0b1f6515091786932e7ba7c53ad2a Mon Sep 17 00:00:00 2001 From: laz Date: Sun, 19 Jan 2025 15:00:55 +0100 Subject: [PATCH] psvita --- .../vita3k/vita3k-guide.md | 58 +++++++++++++++---- 1 file changed, 46 insertions(+), 12 deletions(-) diff --git a/wiki-rtd/docs/wiki_emulator_guides/vita3k/vita3k-guide.md b/wiki-rtd/docs/wiki_emulator_guides/vita3k/vita3k-guide.md index a5d552f..942360b 100644 --- a/wiki-rtd/docs/wiki_emulator_guides/vita3k/vita3k-guide.md +++ b/wiki-rtd/docs/wiki_emulator_guides/vita3k/vita3k-guide.md @@ -22,71 +22,105 @@ --- ## Where to put the games? -Vita3K games should be put into the `retrodeck/roms/psvita/` directory.
-The supported formats are `pkg`, `zip`, `vpk`.
+ +Vita3K games should be put into the `retrodeck/roms/psvita/` directory. + +## What file formats are supported? + +``` +.pkg +.zip +.vpk +``` ## Does Vita3K require BIOS or Firmware? -Yes, it requires two firmwares. + +Yes, it requires two firmwares. + +It also requires licence and keys files play games. + +### Firmware files - The Firmware: `PSVUPDAT.PUP` - The Firmware Font Package: `PSP2UPDAT.PUP` -The firmware and font firmware can be downloaded and installed from the Configurator. +The firmware and font firmware can be downloaded and installed from the RetroDECK Configurator. -You can also install them manually:
-Download the firmwares from +You can also install them manually: - [Sony PSVita Firmware](https://www.playstation.com/en-us/support/hardware/psvita/system-software/) - [Sony PSVita Firmware Font Package](https://dus01.psp2.update.playstation.net/update/psp2/image/2022_0209/sd_59dcf059d3328fb67be7e51f8aa33418/PSP2UPDAT.PUP?dest=usand) Open Vita3K from the Configurator and press `File - Install Firmware` to install the downloaded firmware. -## Licence Files and Keys +### Licence Files and Keys + +Licence files `.bin` `.rif` or licence keys called a `zRif` are required for many games. -Licence files `.bin` `.rif` or licence keys called a `zRif` are required for many games.
They need to be installed by pressing `File - Install Licence` then either `Select work.bin / rif` for the files or `Enter zRif` to input the key. -## How to: Get games to show up inside the ES-DE interface +## Folder structure + +| Type | Folder | Comment | +| :---: | :---: | :---: | +| ROMs Folder |`retrodeck/roms/psvita/` | | +| Saves Folder |`retrodeck/saves/psvita/vita3k/` | | | +| Config Folder |`~/.var/app/net.retrodeck.retrodeck/config/Vita3K/` | `config.yml` | +| Data Folder |`~/.var/app/net.retrodeck.retrodeck/data/Vita3K/` | | + +## How-to: Get games to show up inside the ES-DE Frontend **Example:**
+ In this example we got a game we want to add: `OutWipe 4820` ### Step 1: Install the Game + Open the Vita3K emulator via Configurator and press `File` and either `Install .pkg` or `Install .zip, .vpk` depending on what game file you have. In our example `OutWipe 4820` is a `.pkg` file so we chose the `Install .pkg` option and navigate to the file to install it. #### Step 1b: Add Licences (not always needed) -During installation the Vita3K could call for a Licence File or Key.
+ +During installation the Vita3K could call for a Licence File or Key + Either add the `.bin` or `.rif` files or input the `zRif` key in the prompt. + Check more above in the **Licence Files and Keys** section. #### Step 1c: Install any DLCs or patches + Install the patches and DLC the same way as the game by repeating Step 1 to 1b for the filetype the patch/DLC is in `pkg`, `zip`, `vpk`. ### Step 2: Check the Title ID of the game -In the Vita3K interface the third colum you can see the Title ID of the game you just installed.
+In the Vita3K interface the third colum you can see the Title ID of the game you just installed. + You can also check [Vita3K Game Compatibility and ID List](https://vita3k.org/compatibility.html?lang=en). In our example we find out that the Title ID of `OutWipe 4820` is `PCSF00007` ### Step 3: Create the .psvita file + - The `.psvita` file starts as a empty textfile that needs to be created in roms folder `retrodeck/roms/psvita/` - Name the file `.psvita` - In our example the file will be called `OutWipe 4820.psvita` -The end result should look like:
+The end result should look like: + `retrodeck/roms/psvita/OutWipe 4820.psvita` ### Step 4: Open the pstvita file and add the Title ID + Open up the empty `OutWipe 4820.psvita` file and just type in the `` in the first row of the file and save, in this example you enter `PCSF00007`.
Make sure you don't add any spaces or linebreaks and the file should just contain the word `PCSF00007`. ### Step 5: The game should now run + The game should now be added to the ES-DE interface from the `retrodeck/roms/psvita/OutWipe 4820.psvita` file you just created and can be played after you reload RetroDECK from the Configurator or re-launch the application. ### Step 6: Cleanup + The game is now installed, so if wished, the package file can be deleted, only the `.psvita` file is needed at this point.