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

  1. Create a file named exactly X-Arcade Tankstick.cfg and paste in the full profile below. (If you have the contributor's autoconfig-tankstick.zip, it contains this same file ready-made — just unzip it.)
  2. Copy that file as-is into the top level of RetroArch's autoconfig folder — not into a sub-folder such as autoconfig/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.

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

  1. Fully restart RetroArch (or reboot the Pi).
  2. Go to Settings → Input → RetroPad Binds → Port 1 Controls. The device should read X-Arcade Tankstick (Mode 4).
  3. 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 xpad device 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.cfg up into the top level of autoconfig. Inside udev it 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 autoconfig folder 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 xpad behaviour 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.