PlayStation Vita

This page contains all the information you need to get ScummVM up and running on a PS Vita.

What you’ll need

  • A homebrew-enabled PS Vita console with Vitashell installed. How to enable homebrew is outside the scope of this documentation.

Installing ScummVM

The PS Vita package is available for download on the ScummVM Downloads page.

Copy the .vpk to the PS Vita and install it using VitaShell.

Transferring game files

There are a few ways to transfer game files to the PS Vita.

Use VitaShell to transfer the files by USB or FTP, or use SD2Vita to transfer the files directly to the microSD card.

Folders containing game files can be copied anywhere on the SD card.

ScummVM on the PS Vita supports cloud functionality.

See Handling game files for more information about game file requirements.

Controls

Default control map

These controls can also be manually configured in the Keymaps tab. See the Keyboard shortcuts page for common keyboard shortcuts.

Game Controller Mapping

Button

Action

Left stick

Mouse

Left stick + R button

Slow Mouse

Left mouse click

Right mouse click

Directional buttons

Keypad ‘Cursor’ Keys

Directional buttons + R button

Diagonal Keypad ‘Cursor’ Keys

L button

Game menu (F5)

R button

Shift

Period (.)

R button +

Spacebar

Escape

R button +

Return

START

Global main menu (GMM)

SELECT

Toggle virtual keyboard

SELECT + R button

AGI predictive input dialog

Front Touchscreen Controls, always enabled

Touch

Action

One finger tap

Moves pointer to finger position and left mouse click

Two finger tap

Moves pointer to first finger position and right mouse click

Single finger drag

Moves pointer directly with finger

Two finger drag

Moves pointer while left mouse button is held down (drag-and-drop).

Three finger drag

Moves pointer while right mouse button is held down (drag-and-drop).

Back Touchpad Controls, enabled through settings

Touch

Action

One finger tap

Left mouse button click

Two finger tap

Right mouse button click

Single finger drag

Moves pointer indirectly with finger, pointer speed can be adjusted in control settings

Two finger drag

Moves pointer while left mouse button is held down (drag-and-drop).

Three finger drag

Moves pointer while right mouse button is held down (drag-and-drop).

Keyboard and mouse support

Real bluetooth mice and keyboards work on the Vita and are supported by ScummVM. Go to Settings > Devices on the Vita home screen to pair your devices.

Note

Not all bluetooth keyboards or mice pair successfully with the Vita. The ScummVM team tested the Jelly Bean BT keyboard and mouse combo (ASIN:B06Y56BBYP) and with the standalone Jelly Comb Bluetooth Wireless Mouse (ASIN:B075HBDWCF).

Touch support

For multi-touch gestures, the fingers have to be far enough apart from each other that the Vita will not recognize them as a single finger, otherwise the pointer will jump around.

Touchpad mouse mode

The touch control scheme can be switched in the global settings. Go to Options > Control:

  • When Touchpad mouse mode is off:

    • The touch controls are direct, which means the pointer always jumps to the finger position.

    • The rear touch pad is disabled.

  • When Touchpad mouse mode is on:

    • The touch controls are indirect. The finger can be far away from the pointer and still move it, like on a laptop touchpad.

    • The pointer speed setting in the Control tab affects how far the pointer moves in response to a finger movement.

    • The rear touch pad is enabled.

The front touchscreen uses the direct mode by default, but this can be changed by editing the configuration file with the following keyword:

frontpanel_touchpad_mode

When set to true, the touch controls on the front touchscreen are indirect.

Two finger tap

For a two finger tap, hold one finger down and then tap with a second finger.

Two finger drag

Hold down two fingers to initiate a drag-and-drop feature. The two finger drag simulates the left mouse button being held down.

  • The first finger affects mouse motion during the drag, the second finger can be removed without affecting the drag.

  • When the last finger is removed, the left mouse button is released and the drag is over.

  • The second finger can be anywhere, it doesn’t have to be close to the first finger, and it doesn’t have to be put down simultaneously with the first finger.

Three finger drag

Hold down the three fingers to initiate a drag-and-drop feature. The three finger drag simulates the right mouse button being held down.

Paths

Saved games

ux0:/data/scummvm/saves

Configuration file

ux0:/data/scummvm/scummvm.ini

Settings

For more information, see the Settings section of the documentation. Only platform-specific differences are listed here.

Audio

Supported audio file formats:

  • MP3

  • OGG

  • FLAC

  • Uncompressed audio

Controls

See the Touch support section.

Known Issues

  • MT-32 emulation is not available on the PS Vita.