Our addons Gamepad
Absolute Controller.
Play World of Warcraft with an Xbox or PS5 DualSense controller. Click a button on a picture of your own controller and pick what it does, with four layers on the triggers. Your old bindings are backed up, and you can share your layout as a string. One download for WoW Forever and Retail.
Version 0.1.4, a test build · one file for both WoW Forever and Retail. Found a problem? Tell us on Discord.

The controller maps
Absolute Controller, in game and on paper
The addon in game, and the printable maps it is built around. Click any picture to see it full size.
Features
What Absolute Controller does
Your controller, on screen
- A picture of your own controller with a dot on every button
- Xbox or PS5 art and button names, picked from the controller you plug in
Four layers
- No trigger, hold LT, hold RT, and both triggers
- LT acts as Shift and RT as Ctrl, the game’s own gamepad modifiers
Every action the game knows
- Read from the game’s own key bindings, by category, with search
- Or type any spell, macro or item name
Your old bindings are safe
- Backed up the first time you apply a layout
- One button puts them back
Share layouts
- Export a layout as a string for Discord, import someone else’s
- Or fill in a PDF form on this page and get a layout file
On-screen buttons
- Optional controller button icons on your action bars
- Off by default; turn it on in settings or with /actrl prompts
Light bar
- Faction colour, your class colour, or off
- On controllers with a light, like the DualSense
One window
- The map, your layouts, settings and about in one window
- Click the minimap button to open it; right-click for settings
One download
- One package for WoW Forever and Retail
- On WoW Forever, keep Blizzard’s gamepad UI (companion) or use your own layout
Set up
From the box to your first pull
Pair the controller first: our guides walk through Bluetooth on Windows 11 and macOS for each controller.
Install it
Unzip the download into
World of Warcraft\_retail_\Interface\AddOnsorWorld of Warcraft\_forever_\Interface\AddOns, so you have anAbsoluteControllerfolder there. The same folder works in both games. It’s also on CurseForge.Try the demo first
Type
/actrl demo(or press DEMO on the map). It tours the starter layout on screen: every button on every layer and what it does. No controller needed, and nothing changes in your game. With a controller plugged in, TEST lights up each button you press and says what it does, without casting anything.Open the map
In game, type
/actrlor click the Absolute Controller button on the minimap. Your controller appears with a dot on every button. SETTINGS at the top right shows the settings and about in the same window.Pick a layer, click a button
Choose No trigger, Hold LT, Hold RT or LT + RT, click a dot, then pick its action from the list on the right. Search the list, or type a spell, macro or item name. Orange dots are bound.
Apply to game
Press APPLY TO GAME. Your layout goes into WoW’s key bindings and gamepad input is switched on. The first time, every gamepad binding you had is backed up; PUT MY OLD BINDINGS BACK restores them.
WoW Forever: pick a mode
WoW Forever has Blizzard’s own gamepad UI. In the addon’s settings, Companion keeps it and adds the light bar; Absolute layout uses your own mapping instead (turn Blizzard’s gamepad UI off under Options › Gameplay › Gamepad).
Commands
/actrlopen or close the window/actrl mapthe controller map/actrl settingssettings and about/actrl applyapply your layout/actrl restoreput your old gamepad bindings back/actrl demotour your layout on screen, no controller needed/actrl testpress buttons to see what each one does/actrl checkdry run of APPLY TO GAME, changes nothing/actrl promptscontroller button icons on your action bars, on or off/actrl cvarslist the game’s gamepad settings/actrl exportand/actrl importshare a layout string/actrl minimapshow or hide the minimap button
Good to know
- Bindings can’t change in combat. Apply during a fight and it happens the moment combat ends.
- Typing in chat still needs a keyboard. Keyboard and mouse keep working alongside the controller.
- Actions a game doesn’t have are skipped. Layouts shared between Retail and WoW Forever list anything skipped in chat, so you can rebind it.
Layout builder
Build your own layout on paper
Fill in the form with what you want on every button, drop it here, and get a layout file for Absolute Controller. Your PDF is read right here in your browser; it is never uploaded to us and nothing is kept.
-
Pick your controller and a starting form
Start from scratch with the blank form, or from our starter layout with the Absolute Gaming map, where every box is filled in and you only change what you don’t like. Each form has all 52 boxes: 13 buttons on each of the four layers (no trigger, hold LT, hold RT, both triggers).
Xbox: Blank form (PDF) Absolute Gaming map (PDF)
PS5 DualSense: Blank form (PDF) Absolute Gaming map (PDF)
-
Fill it in
Open it in Adobe Acrobat Reader, or in Chrome or Edge. Page 2 shows your controller with every button tagged. Click a box and pick an action from the list, or type your own:
Spell: Fireball,Macro: PullorItem: Hearthstoneput a spell, macro or item straight on the button, and a best guess like “nearest enemy” works too. Leave a box empty, or pick Unbound, to leave that button free.The triggers and the Menu / Options button aren’t on the form: they are the layer keys and the game menu.
-
Save the PDF
Use Save (Ctrl+S), not Print, so your choices stay in the file.
-
Drop it below and check the matches
Every box you filled appears in a list. Exact matches are ready. Check this means we matched what you typed to the closest action, so make sure it’s right. Pick one means we couldn’t tell, so choose from the list. You can change any row.
-
Name it, pick your game, download
Name your layout, choose Retail or WoW Forever, and tell us where World of Warcraft is installed (the Battle.net app shows it under the game’s settings). We show the exact folder the file goes in.
-
Put it in the addon folder and apply it
Put the downloaded
Imported.luain yourAbsoluteControlleraddon folder, replacing the one already there. Log in (or type/reload): your layout is added and selected. Open the map with/actrl, check it, and press APPLY TO GAME. Rather not touch files? Copy the layout string instead and paste it into IMPORT on the map.
Check your buttons
| Button | You wrote | Action |
|---|
Name, game and install location
/actrl import)
Then log in or /reload, open /actrl and press APPLY TO GAME. Bindings can’t change in combat, so apply out of combat.
Found a bug in Absolute Controller? Send us a report with screenshots. Every report is reviewed, and fixes ship in the next update.
Report a bugQuestions, tips or ideas? Talk about this addon with other players on our Discord.