DevilutionX Documentation

DevilutionX provides three abstracted implementations for low-level gamepad handling:

1. SDL2 controller API: Standard modern controller support.
2. SDL 1&2 joystick API: Used for SDL1 platforms or for mapping additional buttons not covered by standard SDL2 controller mappings (e.g., extra Nintendo Switch arrow buttons).
3. Keyboard keys acting as controller buttons: Used for testing or specialized hardware like RetroFW.

To install DevilutionX on a GKD350h device, follow these steps:

1. Copy the devilutionx-gkd350h.opk file to either /media/data/apps or /media/sdcard/apps/.
2. Copy your diabdat.mpq file (extracted from your Diablo 1 CD or GOG installation) to the following directory: /usr/local/home/.local/share/diasurgical/devilution/diabdat.mpq

To run devilutionX on a PlayStation 5, follow these steps:

1. Prepare Assets: Ensure you have the game assets (either diabdat.mpq from the full Diablo game or spawn.mpq from the shareware version).
2. Transfer Assets: Copy the game assets to the directory /data/homebrew/devilutionX on your PS5 (e.g., via FTP).
3. Launch Web Server: Launch the ps5-payload-websrv homebrew on your console.
4. Run the Game: Access the game through your web browser at http://[PS5-IP]:8080, or use the companion launcher from the PS5 menu system.

To build the PS5 port, you must first install the PacBrew PS5 SDK. Once the SDK is installed, execute the build script from the repository root:

./Packaging/ps5/build.sh

You can extend the game with additional language and voice assets by downloading them from the devilutionx-assets repository and placing them in the DevilutionX folder:

• CJK Text Support (Chinese, Japanese, Korean): Download fonts.mpq from the latest release.
• Polish Voice Pack: Download pl.mpq from the latest release.
• Russian Voice Pack: Download ru.mpq from the latest release.

To access the graphical desktop environment within your Codespace:

1. Navigate to the Ports tab in the VS Code interface.
2. Click on the Browser port.
3. When prompted for a password, use: vscode.

To build the PS4 port from source, you must first install the PacBrew openorbis SDK. Once the SDK is installed, execute the build script from the repository root.

./Packaging/ps4/build.sh