Contributed by Robert Hurst. This guide exists thanks to Robert Hurst, a longtime X-Arcade owner and community member, who worked out this configuration on his own setup and generously shared it — profile file, settings, and notes — so other Tankstick owners could use it too. Thank you, Robert, for giving back to the community.
Applies to: X-Arcade Tankstick MAX (and Tankstick models with the Tri-Mode board) in Mode 4, on Raspberry Pi and other Linux systems running RetroArch — including RetroPie.
The problem in 30 seconds
RetroArch has a long-standing issue where a controller that works in one core gets switched, remapped, or handed to a different player port in another (RetroArch issue #14652 — Core Switching of Controllers). It shows up most with the Tankstick in Mode 4 (gamepad / XInput mode): on Linux, the xpad driver presents the Tankstick as an "Xbox 360 Wireless Receiver", so RetroArch cannot reliably tell it apart from other gamepads — and Player 1 keeps moving.
The fix has two parts: (1) a small autoconfig profile that makes RetroArch recognise the Tankstick by name, and (2) two lines in retroarch.cfg that reserve it as the preferred Player 1 device. Together they take about five minutes.
Why use Mode 4 at all?
Most Linux X-Arcade setups historically used keyboard mode. Mode 4 (gamepad mode) is the better choice when you want the joysticks/buttons and a keyboard and mouse working together at the same time — for example arcade games plus home-computer emulation — without conflicting keymapping codes. That is exactly what this profile is for.
What you need
- Your Tankstick switched to Mode 4
- Access to your RetroArch folders (on the Pi itself, over SSH, or on the SD card / storage from another computer)
- Five minutes to create one small text file (Step 1) and edit one configuration file (Step 2)
Step 1 — Install the autoconfig profile
- Create a file named exactly
X-Arcade Tankstick.cfgand paste in the full profile below. (If you have the contributor'sautoconfig-tankstick.zip, it contains this same file ready-made — just unzip it.) - Copy that file as-is into the top level of RetroArch's
autoconfigfolder — not into a sub-folder such asautoconfig/udev.- RetroPie example path:
/opt/retropie/configs/all/retroarch/autoconfig/X-Arcade Tankstick.cfg - On other setups, the folder is the one RetroArch shows under Settings → Directory → Controller Profiles.
- RetroPie example path:
Why the top level matters: a profile in the parent autoconfig folder takes priority over the profiles RetroArch ships in its sub-folders (like udev). The parent folder is also where RetroArch itself saves a profile when you use "Save Controller Profile", so this is the place it looks first.
# Linux xpad intercepts X-Arcade Tankstick in Tri-Mode 4 input_driver = "udev" input_device = "Xbox 360 Wireless Receiver" input_device_display_name = "X-Arcade Tankstick (Mode 4)" input_vendor_id = "1118" input_product_id = "673" input_up_btn = "11" input_down_btn = "12" input_left_btn = "13" input_right_btn = "14" input_b_btn = "0" input_a_btn = "1" input_y_btn = "2" input_x_btn = "3" input_select_btn = "6" input_start_btn = "7" input_l_btn = "4" input_r_btn = "5" input_l2_axis = "+2" input_r2_axis = "+5" input_l3_btn = "9" input_r3_btn = "10" input_l_y_minus_axis = "-1" input_l_y_plus_axis = "+1" input_l_x_minus_axis = "-0" input_l_x_plus_axis = "+0" input_r_y_minus_axis = "-4" input_r_y_plus_axis = "+4" input_r_x_minus_axis = "-3" input_r_x_plus_axis = "+3" input_b_btn_label = "A" input_a_btn_label = "B" input_y_btn_label = "X" input_x_btn_label = "Y" input_select_btn_label = "SELECT" input_start_btn_label = "START" input_l_btn_label = "LB" input_r_btn_label = "RB" input_l2_axis_label = "LT" input_r2_axis_label = "RT" input_l3_btn_label = "Left Thumb" input_r3_btn_label = "Right Thumb" input_l_y_minus_axis_label = "Left Analog Y-" input_l_y_plus_axis_label = "Left Analog Y+" input_l_x_minus_axis_label = "Left Analog X-" input_l_x_plus_axis_label = "Left Analog X+" input_r_y_minus_axis_label = "Right Analog Y-" input_r_y_plus_axis_label = "Right Analog Y+" input_r_x_minus_axis_label = "Right Analog X-" input_r_x_plus_axis_label = "Right Analog X+" input_menu_toggle_btn = "8" input_menu_toggle_btn_label = "Guide"
Two lines do the important work: input_device_display_name is what makes RetroArch show the pad as "X-Arcade Tankstick (Mode 4)" instead of a generic Xbox pad, and the vendor/product IDs (1118 / 673 — that is 045e:02a1 in hex) are how RetroArch matches your Tankstick to this profile.
Step 2 — Reserve the Tankstick as Player 1
Open retroarch.cfg (in RetroPie: /opt/retropie/configs/all/retroarch.cfg) and add these two lines:
input_player1_device_reservation_type = "1" input_player1_reserved_device = "045e:02a1 X-Arcade Tankstick (Mode 4)"
Reservation type 1 means "preferred device": whenever the Tankstick is connected, RetroArch gives it the Player 1 port first — in every core — instead of whichever pad happened to be detected first.
Step 3 — Restart and check
- Fully restart RetroArch (or reboot the Pi).
- Go to Settings → Input → RetroPad Binds → Port 1 Controls. The device should read X-Arcade Tankstick (Mode 4).
- Launch games from two different cores and confirm Player 1 stays on the Tankstick in both.
That's it. If Port 1 still shows a different pad, work through the short checklist below before changing anything else.
Using a second Tankstick or extra controllers?
- Second Tankstick / second gamepad: a second
xpaddevice binds naturally to Port 2 — nothing extra to set. - Adding wireless pads for Players 3 and 4: to stop the order shuffling further down the device tree, extend the same idea to Player 2 — reserve the second Tankstick profile as the preferred device for Player 2 in
retroarch.cfg(input_player2_device_reservation_type/input_player2_reserved_device), so the extra pads fall in behind the two Tanksticks.
If it doesn't work
- Profile in a sub-folder? Move
X-Arcade Tankstick.cfgup into the top level ofautoconfig. Insideudevit can be overridden by the stock profiles. - Wrong mode? This profile is only for Mode 4. In any other mode the Tankstick presents differently and the profile will not match.
- Device name doesn't match? The reserved-device line must match exactly, including the hex IDs:
045e:02a1 X-Arcade Tankstick (Mode 4). - Old profiles fighting it? If you previously saved your own Tankstick profile, check the
autoconfigfolder for duplicates and keep only this one for the Tankstick. - LT / RT buttons won't map in RetroPie? That is a separate, known Mode 4 quirk — see the article X-Arcade Tankstick LT/RT Buttons Not Mapping in RetroPie (Mode 4 / X-Input) in this knowledge base.
Notes
- Tested by the contributor on a Raspberry Pi 500+ running RetroArch on Linux; the same
xpadbehaviour applies to other Linux RetroArch setups. - New to X-Arcade on the Pi? Start with the article How To Use X-Arcade With Raspberry PI in this knowledge base, then come back here if your controllers keep switching.
- Background reading: RetroArch issue #14652 — Core Switching of Controllers.
Credit & thanks: The configuration, autoconfig profile, and setup guidelines in this article were created and contributed by Robert Hurst, who shared them with X-Arcade (support ticket 32764) for the benefit of the whole retro gaming community, and gave us permission to publish them here. Robert — thank you for your contribution, and for helping fellow Tankstick owners get the most out of their setups.