WoWpadX

A high-performance controller mapping utility for ConsolePortLK

What is WoWpadX?

WoWpadX is a ground-up rewrite of the original controller mapping concepts found in WoWmapper and WoWmapperX.
It handles input from modern controllers via SDL3 and converts them into precise button presses and mouse movements. These are then processed by ConsolePortLK to provide a native console-like experience in World of Warcraft. WoWpadX includes advanced features such as rumble feedback, automatic cursor centering, and input assistance utilities aiming to make controller gameplay efficient and responsive in the World of Warcraft environment.

What is the difference between WoWpadX and WoWmapperX?

WoWpadX is a complete architectural rebuild designed aiming better performance and compatibility:

Native C++ Codebase: Built using C++ rather than C#/.NET, eliminating runtime dependencies and (hopefully) increasing it's overall compatibility and performance.
SDL3 Backend: Leverages the latest SDL3 for universal controller support (DualSense, Xbox Series, Switch Pro, etc.).
Qt Framework: Provides a robust, responsive GUI to make the experience closer to WoWmapperX

Command Line Arguments

WoWpadX supports several flags for automation and background execution.

Actions

Modifiers (Used with -l)

| Argument | Description | | :---- | :---- | | -n | Headless Mode: Runs as a background driver with no GUI. | | -m | Minimized Mode: Launches the game and hides WoWpadX in the system tray. | | -k | Keep-Alive: Prevents WoWpadX from closing after the game process exits. |

General

Example Usage:
To launch the game in Headless mode (No GUI) and close WoWpadX automatically when the game finishes:
WoWpadX.exe -l "C:\Games\WoW\Wow.exe" -n

To stop a running background instance:
WoWpadX.exe --stop

Privileges & Process Detection

If the controller is not working inside the game window, it is likely due to a privilege mismatch. If your game launcher requires Administrator privileges, you must also Run WoWpadX as Administrator.
If your game process uses a non-standard name, you can add it to the settings.json file generated upon the first launch:

"GameProcessNames": [  
    "wow",  
    "wow-64",  
    "ascension",  
    "custom-client-goes-here"  
]

Setup & Configuration

WoWpadX and ConsolePortLK are designed to be "Plug-and-Play."

Launch WoWpadX (manually or via -l).
Launch World of Warcraft.
That's it!.

Optional Components: Overlay & Loader

In the project root you will find two extra projects:

WoWpadXOverlay
WoWpadXOverlayLoader

These projects implement a basic Direct3D9 overlay with functionality similar to WoWmapper’s overlay. The overlay displays controller battery status, connection details, and a crosshair showing the mouse position prior to entering mouselook mode.

Please note that while the source code is included, the overlay is not compiled or packaged in the releases. Because it relies on DLL injection, using it could potentially trigger Warden. For this reason, if you want to use or test the overlay, you’ll need to build it yourself.

After building, simply place both WoWpadXOverlay.dll and WoWpadXOverlayLoader.exe inside the WoWpadX executable folder. Once they are in place, the overlay option within WoWpadX settings will become available.

Alternatives

Linux

AntiMicroX
Steam Input

Windows

WoWmapperX (Legacy C# version)
WoWmapper
AntiMicroX
Steam Input

Download Latest Release

WoWpadX

Install / Use

README

WoWpadX

What is WoWpadX?

What is the difference between WoWpadX and WoWmapperX?

Command Line Arguments

Actions

Modifiers (Used with -l)

General

Privileges & Process Detection

Setup & Configuration

Optional Components: Overlay & Loader

Alternatives

Linux

Windows