Differences

This shows you the differences between two versions of the page.

--- diy-arcade-controls [2026/03/03 03:59] – Misc fixes, updates and corrections. superchooch
+++ diy-arcade-controls [2026/05/29 20:55] (current) – [Gallery] nadenislamarre
@@ Line 29: / Line 29: @@
 {{::homemadecontrollers2.jpg?350|}}
 {{::homemadecontrollers4.png?200|}}
+{{::homemadecontrollers4players.jpg
+?600|}}
 ===== Arcade Cabinet Retailers and License Compliance =====
@@ Line 157: / Line 159: @@
 There are some file samples in ''/usr/share/keyboardToPads/inputs''.
-Example :
+Here is an example of a Rec Room Masters Xtension 2 Player Plus controller:
   # Xtension 2 Player Plus
@@ Line 205: / Line 207: @@
         ["key:c", "key:space"]: "key:1" # player 2 select from combination player 1 start+tl, require batocera 43
-In that example, the controller is split into 3 virtual devices: 2 pads and 1 hotkey device.
+Using the example above, we can determine the following information:
+  * The controller is split into 3 virtual devices: 2 pads and 1 hotkey device.
+  * The ''name'' of the first virtual pad is ''Xtension 2P Player 1''. Rename Xtension 2P Player 1 & 2 to the name of your controller.
+  * Its ''type'' is "joystick". Possible types are "joystick" for pads, and "hotkeys" for hotkeys.
+  * ''mapping'' is a key-value association table to convert each key from the real device into the virtual pad.  You can assign two or more physical keys to a single pad button.
 <WRAP center round important>
@@ Line 273: / Line 279: @@
 Follow these steps :
-- login to your Batocera box locally or through SSH
+  * login to your Batocera box locally or through SSH
-- find your encoder's device name with ''ls /dev/input/by-id''. Usually, there is a trailing kbd in the event name. For example : ''usb-Ultimarc_IPAC_2_Ultimarc_IPAC_2_9-if01-event-kbd''
+  * find your encoder's device name with ''ls /dev/input/by-id''. Usually, there is a trailing kbd in the event name. For example : ''usb-Ultimarc_IPAC_2_Ultimarc_IPAC_2_9-if01-event-kbd''
 **PLEASE NOTE:** a single encoder can have multiple possible names, so try all of them
@@ Line 280: / Line 286: @@
 ''usb-Cypress_I-PAC_Arcade_Control_Interface-if01-event-kbd'' → doesn't work
-- Now remount / as read-write `mount -o remount,rw /`
+  *  Now remount / as read-write ''mount -o remount,rw /''
-- Create an empty file that has the same name of your keyboard device found 2 steps above `touch /usr/share/batocera/datainit/system/configs/xarcade2jstick/devicename`. With the previous example : `touch /usr/share/batocera/datainit/system/configs/xarcade2jstick/usb-Ultimarc_IPAC_2_Ultimarc_IPAC_2_9-if01-event-kbd`
+  * Create an empty file that has the same name of your keyboard device found 2 steps above ''touch /usr/share/batocera/datainit/system/configs/xarcade2jstick/devicename''. With the previous example : ''touch /usr/share/batocera/datainit/system/configs/xarcade2jstick/usb-Ultimarc_IPAC_2_Ultimarc_IPAC_2_9-if01-event-kbd''
-- Edit `batocera.conf` and set `controllers.xarcade.enabled=1` (it should already be set by default but check it)
+  * Edit ''batocera.conf'' and set ''controllers.xarcade.enabled=1'' (it should already be set by default but check it)
-- Save your modifications through SSH `batocera-save-overlay`
+  * Save your modifications through SSH ''batocera-save-overlay''
-- Reboot by typing `reboot`
+  * Reboot by typing ''reboot''
 Now all your keys should be usable, that is for each player : 4 directions joystick, select, start, hotkey, A, B, X, Y, L1 and R1.
@@ Line 291: / Line 297: @@
 You must now configure both the controllers in the Controller Configuration menu and also associate the right controller to player 1 and 2.
-Since Batocera **v34**, [Ultimarc](https://github.com/katie-snow/Ultimarc-linux) has been included. [Read more here.](https://github.com/katie-snow/Ultimarc-linux/blob/master/README.cfg)
+Since Batocera **v34**, [[https://github.com/katie-snow/Ultimarc-linux|Ultimarc]] has been included. [[https://github.com/katie-snow/Ultimarc-linux/blob/master/README.cfg|Read more here.]]