Skip to content

Controllers

codingncaffeine edited this page Jun 22, 2026 · 1 revision

Controllers

Plug in an Xbox-compatible controller and it works in your games — no setup.

How it works

EmuDOS reads your controller through XInput (built into Windows) and hands it to the DOS emulator as a gamepad. DOSBox Pure then translates that gamepad into what the DOS game actually understands:

  • Keyboard — most DOS games are keyboard-controlled, so the pad's buttons drive sensible default keys. Many well-known games have built-in per-game mappings that apply automatically.
  • Gameport joystick — flight sims, space sims, and other joystick-aware games use an emulated analog joystick.

So for the large majority of games you just pick up the pad and play.

Fine-tuning the mapping

Press F10 in-game to open the emulator menu / on-screen keyboard, then the Pad Mapper, to bind any button to the keys (or joystick axis) a particular game uses. Your mapping is saved per game.

Controller recognition (names)

By default a controller works but is labelled generically. Install the optional Controller names (SDL3) component from Preferences → Downloads and EmuDOS will identify your pad by name (e.g. "Xbox Wireless Controller", "DualSense"), showing " connected" / " disconnected" in the status bar as you plug controllers in or unplug them.

Notes

  • Up to four controllers are supported.
  • The left stick doubles as the d-pad; triggers act as the L2/R2 buttons.
  • XInput covers Xbox and most modern pads in their XInput mode. (DirectInput-only devices aren't read yet.)
  • If a game ignores the pad, open its SETUP (right-click → Open in DOS) and enable joystick/gamepad control, or remap with the Pad Mapper.

Clone this wiki locally