Table of Contents

[Before v1.5] How to change the default mapping? Case study - update PS5 controller so A ○, B × -> B ○, A × - this will become more natural for PS users.
[After v1.5] How to change the default mapping? Case study - update PS5 controller so A ○, B × -> B ○, A × - this will become more natural for PS users.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

DevilutionX supports most gamepad controls.

Default controller mappings (A/B/X/Y as in Nintendo layout, so the rightmost button is attack; A ○, B ×, X △, Y □):

Left analog or D-Pad: move hero
A: attack nearby enemies, talk to townspeople and merchants, pickup/place items in the inventory, OK while in main menu
B: select spell, back while in menus
X: pickup items, open nearby chests and doors, use item in the inventory
Y: cast spell, delete character while in main menu
L1: use health item from belt
R1: use mana potion from belt
L2: character sheet (alt: Start + L1 or ←)
R2: inventory (alt: Start + L2 or →)
Left analog click: toggle automap (alt: Start + ↓)
Start + Select: game menu (alt: Start + ↑)
Select + A/B/X/Y: Spell hotkeys
Right analog: move automap or simulate mouse
Right analog click: left mouse click (alt: Select + L1)
Select + Right analog click: right mouse click (alt: Select + R1)
Select + L2: quest log (alt: Start + Y)
Select + R2: spell book (alt: Start + B)

For now, they can be re-mapped by changing SourceX/controls or by setting the SDL_GAMECONTROLLERCONFIG environment variable (see SDL_GameControllerDB).

[Before v1.5] How to change the default mapping? Case study - update PS5 controller so `A ○, B ×` -> `B ○, A ×` - this will become more natural for PS users.

Plug in your controller, make sure it works in the game. Close the game. Run the game again with --verbose flag in order to see the current controller mapping:

./devilutionx --verbose
(...)
2023-03-24 18:02:02.143 devilutionx[68996:3791527] INFO: Opened game controller with mapping:
030000004c050000e60c000000016800,*,a:b0,b:b1,back:b4,dpdown:b12,dpleft:b13,dpright:b14,dpup:b11,guide:b5,leftshoulder:b9,leftstick:b7,lefttrigger:a4,leftx:a0,lefty:a1,rightshoulder:b10,rightstick:b8,righttrigger:a5,rightx:a2,righty:a3,start:b6,x:b2,y:b3,touchpad:b15,misc1:b16,platform:Mac OS X

Find out config folder path specific for your OS - you will need to modify diablo.ini file there.
Update diablo.ini with a copy of your current mapping, you can make changes there:

[Controller]
Mapping=030000004c050000e60c000000016800,*,b:b0,a:b1,back:b4,dpdown:b12,dpleft:b13,dpright:b14,dpup:b11,guide:b5,leftshoulder:b9,leftstick:b7,lefttrigger:a4,leftx:a0,lefty:a1,rightshoulder:b10,rightstick:b8,righttrigger:a5,rightx:a2,righty:a3,start:b6,x:b2,y:b3,touchpad:b15,misc1:b16,platform:Mac OS X

Note that a:b0,b:b1 was changed to b:b0,a:b1 versus original. You can also make other changes you need.

Restart the game normally, a new mapping should be in use.

[After v1.5] How to change the default mapping? Case study - update PS5 controller so `A ○, B ×` -> `B ○, A ×` - this will become more natural for PS users.

Will likely be the same for PS4.

Find out config folder path specific for your OS - you will need to modify diablo.ini file there.
Update the following section with Play Station controller mapping:

[Padmapping]
(...)
PrimaryAction=A
SecondaryAction=Y
SpellAction=X
CancelAction=B

🛡️ DevilutionX Wiki

💾 Setup & Installation

⚙️ Configuration & Controls

🛠️ Modding & Community

📜 Development

A project is only as strong as its contributors. Thank you for helping us keep Diablo 1 alive and better than ever!

[Before v1.5] How to change the default mapping? Case study - update PS5 controller so A ○, B × -> B ○, A × - this will become more natural for PS users.