Skip to content

Add pages for the xemu (Xbox), Xenia Edge (Xbox 360) and Vita3K (PlayStation Vita) cores #1220

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
fpscan merged 1 commit into from
Oct 14, 2026
Merged

Add pages for the xemu (Xbox), Xenia Edge (Xbox 360) and Vita3K (PlayStation Vita) cores #1220

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions docs/guides/core-list.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -267,7 +267,7 @@
| [Vircon32](../library/vircon32.md) | Game engine | A port of Vircon32 game console to libretro |
| [Virtual Jaguar](../library/virtual_jaguar.md) | Atari Jaguar | |
| [VirtualXT](../library/virtualxt.md) | DOS | Runs PC/XT class software. Mainly intended for PC booters from the 80's. |
| Vita3K | Sony PlayStation Vita | A port of the Vita3K PlayStation Vita emulator to libretro |
| [Vita3K](../library/vita3k.md) | Sony PlayStation Vita | A port of the Vita3K PlayStation Vita emulator to libretro |
| [vitaQuake 2](../library/vitaquake2.md) | Game engine | A port of the VitaQuake 2 source port of iD's Quake 2 engine to libretro. There is a separate core for each of the Quake 2 mission packs, 'Rogue', 'Zaero' and 'Xatrix'. |
| vitaQuake 2 (Rogue) | Game engine | (See vitaQuake 2 note) |
| vitaQuake 2 (Xatrix) | Game engine | (See vitaQuake 2 note) |
Expand All @@ -277,8 +277,8 @@
| [WQXEmu](../library/wqxemu.md) | Wenquxing Electronic Dictionary | Emulates NC1020, PC1000, CC800, NC2000, and NC3000 models via low-level firmware execution |
| [WASM-4](../library/wasm-4.md) | Game engine | WASM-4 is a open source low-level fantasy game console for building small games with WebAssembly |
| [X Millennium](../library/x1.md) | Sharp X1 | |
| xemu | Microsoft Xbox | A port of xemu, the original Xbox emulator, to libretro |
| Xenia Edge | Microsoft Xbox 360 | A port of the Xenia Edge Xbox 360 emulator to libretro |
| [xemu](../library/xemu.md) | Microsoft Xbox | A port of xemu, the original Xbox emulator, to libretro |
| [Xenia Edge](../library/xenia_edge.md) | Microsoft Xbox 360 | A port of the Xenia Edge Xbox 360 emulator to libretro |
| [XRick](../library/xrick.md) | Game engine | A port of the XRick, an open-source clone of the Rick Dangerous engine |
| [YabaSanshiro](../library/yabasanshiro.md) | Sega Saturn | A port of the YabaSanshiro, which is itself a fork of Yabause emulator |
| [Yabause](../library/yabause.md) | Sega Saturn | |
Expand Down
218 changes: 218 additions & 0 deletions docs/library/vita3k.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,218 @@
# Sony - PlayStation Vita (Vita3K)

## Background

A port of [Vita3K](https://vita3k.org/), the experimental PlayStation Vita emulator, to libretro. It is built on current upstream Vita3K and on [danprice142's libretro port](https://github.com/danprice142/Vita3K-libretro), and reports upstream's version. Which games work is the same as in standalone Vita3K; see its [compatibility list](https://vita3k.org/compatibility.html).

The core is built for Linux (x86_64, arm64), Windows (x64) and Android (arm64-v8a, x86_64).

The Vita3K core has been authored by

- Vita3K Team
- danprice142
- WizzardSK

The Vita3K core is licensed under

- [GPLv2](https://github.com/WizzardSK/vita3k-libretro/blob/libretro/COPYING.txt)

A summary of the licenses behind RetroArch and its cores can be found [here](../development/licenses.md).

## Requirements

A 64-bit CPU and a GPU with Vulkan 1.1 support. The core renders on RetroArch's own Vulkan device, so set RetroArch's video driver to `vulkan`. The **Backend Renderer** core option also offers OpenGL, which needs the `glcore` video driver.

## BIOS

The core needs the PS Vita system software (firmware), which is not included with it. Download the packages from PlayStation's website and put them in a `vita3k` folder in RetroArch's system directory. The core installs them the first time it starts.

| Filename | Description | md5sum |
|:---------------------:|:-------------------------------------------------:|:------:|
| PSP2UPDAT.PUP | PS Vita system firmware - Required | - |
| PSP2UPDAT_PREINST.PUP | PS Vita firmware preinstalled package - Required | - |
| PSP2UPDAT_FONT.PUP | PS Vita firmware fonts - Optional | - |

The preinstalled and font packages are also accepted under the names they are downloaded with, `preinst_fresh.pup` and `font_fresh.pup`.

The core also needs its own data files: the `data` and `shaders-builtin` folders that come with the core's release go in `system/vita3k/` too.

## Extensions

Content that can be loaded by the Vita3K core have the following file extensions:

- .vpk
- .zip
- .pkg
- .bin

A game is loaded as a `.vpk` or `.zip` archive, or from a game folder through its `eboot.bin`. It is installed into `system/vita3k/` the first time it is started, and started from there afterwards.

A `.pkg` (a game, its update or its DLC) needs its license next to it: `<name>.zrif`, `<name>.rif`, `work.bin` or `<CONTENT_ID>.rif`. The **Game PKG** core option chooses whether a game's PKG is run straight from the file or installed first.

## Features

Frontend-level settings or features that the Vita3K core respects.

| Feature | Supported |
|-------------------|:---------:|
| Restart | ✔ |
| Screenshots | ✔ |
| Saves | ✕ |
| States | ✕ |
| Rewind | ✕ |
| Netplay | ✕ |
| Core Options | ✔ |
| [Memory Monitoring (achievements)](../guides/memorymonitoring.md) | ✕ |
| RetroArch Cheats | ✕ |
| Native Cheats | ✕ |
| Controls | ✔ |
| Remapping | ✔ |
| Multi-Mouse | ✕ |
| Rumble | ✕ |
| Sensors | ✔ |
| Camera | ✕ |
| Location | ✕ |
| Subsystem | ✕ |
| [Softpatching](../guides/softpatching.md) | ✕ |
| Disk Control | ✕ |
| Username | ✕ |
| Language | ✕ |
| Crop Overscan | ✕ |
| LEDs | ✕ |

Games save to the emulated console's memory card under `system/vita3k/ux0/`, not to RetroArch save files. Save states are not supported.

## Directories

The Vita3K core's library name is 'Vita3K'.

**Frontend's System directory**

- `vita3k/PSP2UPDAT.PUP`, `vita3k/PSP2UPDAT_PREINST.PUP`, `vita3k/PSP2UPDAT_FONT.PUP` (firmware packages)
- `vita3k/data/`, `vita3k/shaders-builtin/` (the core's data files)
- `vita3k/ux0/` (the emulated memory card: installed games, updates, DLC and saves)

## Core options

The Vita3K core has the following option(s) that can be tweaked from the core options menu. The default setting is bolded.

#### GPU

- **Backend Renderer** [vita3k_backend_renderer] (**Vulkan**|OpenGL)

Select the graphics backend. Vulkan is recommended.

- **Internal Resolution Multiplier** [vita3k_resolution_multiplier] (**1x (960x544)**|2x (1920x1088)|3x (2880x1632)|4x (3840x2176))

Multiplier for the internal rendering resolution (960x544 base).

- **Screen Filter** [vita3k_screen_filter] (**Bilinear**|Nearest|Bicubic|FXAA|FSR)

Post-processing filter applied to the rendered frame.

- **Anisotropic Filtering** [vita3k_anisotropic_filtering] (**1x (Off)**|2x|4x|8x|16x)

Level of anisotropic texture filtering.

- **V-Sync** [vita3k_v_sync] (**ON**|OFF)

Enable or disable vertical sync.

- **Async Pipeline Compilation** [vita3k_async_pipeline] (**ON**|OFF)

Compile shader pipelines asynchronously to reduce stuttering.

- **Memory Mapping** [vita3k_memory_mapping] (OFF|**Double Buffer**|External Host|Page Table|Native Buffer)

GPU memory mapping method. Higher methods improve performance but require GPU support.

- **High Accuracy Rendering** [vita3k_high_accuracy] (**OFF**|ON)

Enable more accurate but slower rendering techniques.

- **Surface Sync** [vita3k_surface_sync] (**Enabled (more accurate)**|Disabled (faster))

GPU memory optimization. May improve performance by 20-40%.

#### CPU

- **CPU Optimizations (Dynarmic JIT)** [vita3k_cpu_opt] (**ON**|OFF)

Enable Dynarmic JIT for faster CPU emulation.

#### System

- **Game PKG** [vita3k_pkg_mode] (**Run Without Installing**|Install)

How a game's PKG is run. Run Without Installing: the game starts in seconds, and a file is decrypted from the PKG the first time the game reads it, into the system folder; it is all removed when the game is closed. Install: the whole game is decrypted and installed into ux0/app the first time, as Vita3K does, which takes as long as the game is big and uses its size on disk. A game installed already runs from its installation either way. Updates and DLC are always installed.

- **PS TV Mode** [vita3k_pstv_mode] (**OFF**|ON)

Emulate a PlayStation TV instead of a PS Vita.

- **Modules Mode** [vita3k_modules_mode] (**Automatic**|Auto & Manual|Manual)

How system modules are loaded. Automatic is recommended.

- **FPS Hack (30 to 60)** [vita3k_fps_hack] (**OFF**|ON)

Attempt to run 30fps-locked games at 60fps. May cause issues.

- **Confirm Button** [vita3k_sys_button] (Circle|**Cross**)

Which button is used for confirm actions.

- **File Loading Delay** [vita3k_file_loading_delay] (**0 ms**|5 ms|10 ms|15 ms|20 ms|25 ms|30 ms)

Delay in milliseconds for file loading. Helps with timing-sensitive games.

#### Audio

- **Audio Volume** [vita3k_audio_volume] (0%|10%|20%|30%|40%|50%|60%|70%|80%|90%|**100%**)

Master audio volume level.

- **NGS Audio Engine** [vita3k_ngs_enable] (**ON**|OFF)

Enable the NGS audio engine for enhanced audio.

#### Network

- **PSN Signed In** [vita3k_psn_signed_in] (**OFF**|ON)

Pretend to be signed in to PSN. Required by some games.

## Controllers

The PS Vita's own controls are on RetroArch's first port; ports two to four are the extra controllers of PS TV Mode. The touchscreen follows the frontend's pointer (mouse or touchscreen): it touches the front screen, or the rear touch pad while L2 is held. The motion sensors use the frontend's accelerometer and gyroscope where the device has them.

## Joypad

| RetroPad Inputs | PS Vita |
|------------------------------------------------|--------------------|
| ![](../image/retropad/retro_b.png) | Cross |
| ![](../image/retropad/retro_a.png) | Circle |
| ![](../image/retropad/retro_y.png) | Square |
| ![](../image/retropad/retro_x.png) | Triangle |
| ![](../image/retropad/retro_select.png) | Select |
| ![](../image/retropad/retro_start.png) | Start |
| ![](../image/retropad/retro_dpad_up.png) | D-Pad Up |
| ![](../image/retropad/retro_dpad_down.png) | D-Pad Down |
| ![](../image/retropad/retro_dpad_left.png) | D-Pad Left |
| ![](../image/retropad/retro_dpad_right.png) | D-Pad Right |
| ![](../image/retropad/retro_l1.png) | L |
| ![](../image/retropad/retro_r1.png) | R |
| ![](../image/retropad/retro_l2.png) | L2 (PS TV mode) |
| ![](../image/retropad/retro_r2.png) | R2 (PS TV mode) |
| ![](../image/retropad/retro_l3.png) | L3 (PS TV mode) |
| ![](../image/retropad/retro_r3.png) | R3 (PS TV mode) |
| ![](../image/retropad/retro_left_stick.png) | Left stick |
| ![](../image/retropad/retro_right_stick.png) | Right stick |

## External Links

- [Vita3K Core info file](https://github.com/WizzardSK/vita3k-libretro/blob/libretro/vita3k_libretro.info)
- [Vita3K libretro GitHub Repository](https://github.com/WizzardSK/vita3k-libretro)
- [Report Vita3K Core Issues Here](https://github.com/WizzardSK/vita3k-libretro/issues)
- [Upstream Vita3K](https://github.com/Vita3K/Vita3K)
- [Vita3K Website](https://vita3k.org/)
Loading
Loading