YoYo Loader Keyboard Re-mapping Instructions: For remapping keyboard inputs to vita gamepad inputs

gistfile1.md

YoYo Loader Keyboard Re-mapping Instructions:

• For remapping keyboard inputs to vita gamepad inputs

Step 1: Create keys.ini file.

• Create a text file called "keys.ini"

Step 2: Populate the keys.ini file, to remap controls for your game.

• Identify the game you would like to remap keyboard controls for.
• As an example, I will be using "Day in the Life of Harpy" https://xysspon.itch.io/day-in-the-life-of-a-harpy
• Identify the keyboard controls used by your game.
• For "Day in the Life of Harpy" this is the "Arrow keys" (LEFT, RIGHT, UP, DOWN), "X" and "Z".
• Using the "REMAPING SYNTAX" at the bottom of this page, map your keyboard controls to the vita gamepad controls.
• For "Day in the Life of Harpy" my keys.ini file looks like this:

CIRCLE=Z  
CROSS=X  
LEFT=LEFT  
RIGHT=RIGHT  
UP=UP  
DOWN=DOWN
 

NOTE: all keys.ini files must terminate in a newline (hit enter after the last typed row of text).

Step 3: Add the keys.ini file to your game in YoYo Loader.

• Each game you want to remap controls for, will need its own keys.ini file.
• Transfer the keys.ini file to your Vita and place it as follows: "ux0:data/gms/[named subfolder of your game]/keys.ini"
• If the keyboard syntax does not produce intended input when mapped, see KEYCODES at the bottom of this page.

Optional Step: Submit a community keys.ini keymap.

• Your keys.ini configurations can be submitted to the YoYo Loader repository as a community keymap.
• Rename your keys.ini with the relevent Game ID. These can be found in the compatibility list as [GAME ID].
• For "Day in the Life of Harpy" my keys.ini will be named Day in the Life of a Harpy.ini.
• Fork the YoYo Loader repository and place your keymaps within the "keymaps" folder.
• Submit a Pull Request to the main YoYo Loader repository.

Remapping Syntax for keys.ini:

VITA GAMEPAD

CIRCLE
CROSS
SQUARE
TRIANGLE
SELECT
START
L1
L2
L3
R1
R2
R3
LEFT
RIGHT
UP
DOWN

VITA ANALOG STICKS
NOTE: Analog mapping is hardcoded. Simply setting to ON will activate the mapping.

RANALOG=ON (Remaps MOUSE input to right stick - snap to centre mode) 
RANALOG=ON2 (Remaps MOUSE input to right stick - cursor mode) 
LANALOG=ON (Remaps DPAD mapping, set by user in keys.ini, to left stick. DPAD mapping still active)

KEYBOARD INPUTS

Letters:
A-Z

Numbers:
0-9

Arrow Keys:
UP
DOWN
LEFT
RIGHT

Common Game Action Keys:
ENTER
SHIFT
CTRL
ALT
ESC
BACKSPACE
TAB
" " (A blank SPACE character, without the quotes)

Function keys:
F1-F12

Numpad:
NUMPAD0-NUMPAD9 

Other Keys:
PRINTSCREEN
HOME
END
DEL
INS
PAGEUP
PAGEDOWN

MOUSE INPUTS

LMOUSE (Left mouse click)
RMOUSE (Right mouse click)

KEYCODES

CODE0-CODE255

NOTE: If the keyboard syntax does not produce intended input, you can try substituting all 250 keycodes. Through trial and error you can identify the correct input code.