Nightly builds	Platform
	Linux 32bit & 64bit, Windows 32bit, Nintendo Switch, SDL1
	macOS 64bit
	Windows 64bit (MSVC)

Discord Chat Channel

How To Play:

• Copy diabdat.mpq from your CD, or GoG install folder, to the DevilutionX install folder or data folder; make sure it is all lowercase. The DeviliutionX install is the one that contains the DevilutionX executable, the data folder path differ depending on OS version and and security setting, but will normally be as following:
  • macOS ~/Library/Application Support/diasurgical/devilution
  • Linux ~/.local/share/diasurgical/devilution/
  • Windows C:\Users[username]\AppData\Roaming\diasurgical\devilution
  • These paths may differ depending on OS version and security setting, so the most reliable recommended location is the directory that contains the DevilutionX executable.
• Download DevilutionX, or build from source
• Install SDL2 (including SDL2_mixer and SDL2_ttf)
• Run ./devilutionx

Please keep in mind that this is still being worked on and is missing parts of UI and some minor bugs, see milestone 1 for a full list of known issues.

Building from Source

Linux

Installing dependencies on Debian and Ubuntu

sudo apt-get install cmake g++ libsdl2-mixer-dev libsdl2-ttf-dev libsodium-dev

Installing dependencies on Fedora

sudo dnf install cmake glibc-devel SDL2-devel SDL2_ttf-devel SDL2_mixer-devel libsodium-devel libasan libubsan

Compiling

cd build
cmake ..
cmake --build . -j $(nproc)

macOS

Make sure you have Homebrew installed, then run:

brew bundle
cd build
cmake ..
cmake --build . -j $(sysctl -n hw.physicalcpu)

FreeBSD

Installing dependencies

pkg install cmake sdl2_mixer sdl2_ttf libsodium

Compiling

cd build
cmake ..
cmake --build . -j $(sysctl -n hw.ncpu)

OpenBSD

Installing dependencies

pkg_add cmake sdl2-mixer sdl2-ttf libsodium gmake

Compiling

cd build
cmake -DCMAKE_MAKE_PROGRAM=gmake ..
cmake --build . -j $(sysctl -n hw.ncpuonline)

Windows via MinGW

Installing dependencies on WSL, Debian and Ubuntu

Download and place the 32bit MinGW Development Libraries of SDL2, SDL2_mixer, SDL2_ttf and Libsodium in /usr/i686-w64-mingw32.

sudo apt-get install cmake gcc-mingw-w64-i686 g++-mingw-w64-i686

Compiling

cd build
cmake -DCMAKE_TOOLCHAIN_FILE=../CMake/mingwcc.cmake ..
cmake --build . -j $(nproc)

Windows via Visual Studio

Installing dependencies

Make sure to install the C++ CMake tools for Windows component for Visual Studio.

• Using vcpkg (recommended)

1. Install vcpkg following the instructions from https://github.com/microsoft/vcpkg#quick-start.

   Don't forget to perform user-wide integration step for additional convenience.

2. Install required dependencies by executing the following command (via cmd or powershell):

   For the 64-bit version of the dependencies please run this command:

   vcpkg install sdl2:x64-windows sdl2-mixer:x64-windows sdl2-ttf:x64-windows libsodium:x64-windows
   

   For the 32-bit version of the dependencies please run this command:

   vcpkg install sdl2:x86-windows sdl2-mixer:x86-windows sdl2-ttf:x86-windows libsodium:x86-windows
   

• Manually

1. Download and place the MSVC Development Libraries of SDL2, SDL2_mixer, SDL2_ttf and Libsodium in %USERPROFILE%\AppData\Local\Microsoft\WindowsApps\.
2. If dependencies are not found or you wish to place them in other location - configure required path variables in "Manage Configurations..." dialog inside Visual Studio or in cmake-gui.

Compiling

• Through Open->CMake in Visual Studio

1. Go to File -> Open -> CMake, select CMakeLists.txt from the project root.
2. Select Build devilution.exe from the Build menu.

• Through cmake-gui

1. Input the path to devilutionx source directory at Where is the source code: field.
2. Input the path where the binaries would be placed at Where to build the binaries: field. If you want to place them inside source directory it's preferable to do so inside directory called build to avoid the binaries being added to the source tree.
3. It's recommended to input Win32 in Optional Platform for Generator, otherwise it will default to x64 build.
4. In case you're using vcpkg select Specify toolchain file for cross-compiling and select the file scripts/buildsystems/vcpkg.cmake from vcpkg directory otherwise just go with Use default native compilers.
5. In case you need to select any paths to dependencies manually do this right in cmake-gui window.
6. Press Generate and open produced .sln file using Visual Studio.
7. Use build/debug etc. commands inside Visual Studio Solution like with any normal Visual Studio project.

Nintendo Switch

Run:

Packaging/switch/build.sh

This will install the Switch devkit and build a DevilutionX Switch package. If you already have the devkit installed, or are on a non-Debian system, pass the the devkit path to the script like this:

DEVKITPRO=<path to devkit> Packaging/switch/build.sh

The nro-file will be generated in the build folder. Test with an emulator (RyuJinx) or real hardware.

Haiku

Installing dependencies on 32 bit Haiku

pkgman install cmake_x86 devel:libsdl2_x86 devel:libsdl2_mixer_x86 devel:libsdl2_ttf_x86 devel:libsodium_x86

Installing dependencies on 64 bit Haiku

pkgman install cmake devel:libsdl2 devel:libsdl2_mixer devel:libsdl2_ttf devel:libsodium

Compiling on 32 bit Haiku

cd build
setarch x86 #Switch to secondary compiler toolchain (GCC8+)
cmake ..
cmake --build . -j $(nproc)

Compiling on 64 bit Haiku

No setarch required, as there is no secondary toolchain on x86_64, and the primary is GCC8+

cd build
cmake ..
cmake --build . -j $(nproc)

OpenDingux / RetroFW

DevilutionX uses buildroot to build packages for OpenDingux and RetroFW.

The build script does the following:

1. Downloads and configures the buildroot if necessary.
2. Builds the executable (using CMake).
3. Packages the executable and all related resources into an .ipk package.

The buildroot uses ~4 GiB of disk space and can take almost an hour to build.

For OpenDingux builds mksquashfs needs to be installed.

RetroFW (RS97, RG300, LDK)

The RetroFW build uses the buildroot at $HOME/buildroot-2018.02.9-retrofw.

Packaging/OpenDingux/build-retrofw.sh

OpenDingux (RG350, GCW0)

This OpenDingux build uses the buildroot at $HOME/buildroot-rg350-devilutionx.

Packaging/OpenDingux/build-rg350.sh

CMake arguments

General

The default build type is Debug. This can be changed with -DBINARY_RELEASE=ON. Independently of this, the debug mode of the Diablo engine is always enabled by default. It can be disabled with -DDEBUG=OFF. Finally, in debug builds the address sanitizer is enabled by default. This can be disabled with -DASAN=OFF. You can also generate 32bit builds on 64bit platforms by setting -DCMAKE_TOOLCHAIN_FILE=../CMake/32bit.cmake (remember to use the linux32 command if on Linux). Network support can be disabled using -DNONET=ON, this also removes the need for the ASIO and Sodium dependencies. You can compile the shareware version with -DSPAWN=ON this will allow you to try the game using spawn.mpq from the original shareware which can still be downloaded for free.

mingw32

Use -DCROSS_PREFIX=/path/to/prefix if the i686-w64-mingw32 directory is not in /usr.

Use SDL v1 instead of SDL v2.

Pass -DUSE_SDL1=ON to build with SDL v1 instead of v2. Note that some features are not yet supported in SDL v1, notably upscaling, and fullscreen.

Multiplayer

• TCP/IP only requires the host to expose port 6112
• UDP/IP requires that all players expose port 6112

All games are encrypted and password protected.

Controller support

DevilutionX supports gamepad controls.

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

• Left analog / DPad: move hero
• Right analog: simulate mouse
• A: attack nearby enemies, talk to towns people and merchants, pickup & place items in the inventory, OK while in main menu
• B: Select spell, cancel while in main menu
• X: pickup gold, potions & equipment from ground, open chests and doors that are nearby, use item when in inventory (useful to read books etc.)
• Y: cast spell, go to previous screen when talking to people and in shops, delete character while in main menu
• R1: inventory
• L1: character sheet
• R2: use mana potion from belt
• L2: use health item from belt
• Left analog click: toggle automap
• Right analog click: left mouse click
• Select: quest log
• Start: game Menu, skip intro

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

Contributing

Guidelines

Modding

Below are a few examples of some simple improvements made to the game. It is planned in the future to create tools for designing dungeons and graphics.

F.A.Q.

Click to reveal

Wow, does this mean I can download and play Diablo for free now?

No, you'll need access to the data from the original game. If you don't have an original CD then you can buy Diablo from GoG.com. Alternatively you can also use spawn.mpq from the http://ftp.blizzard.com/pub/demos/diablosw.exe version and compile the with the SPAWN flag defined.

Cool, so I fired your mod up, but there's no 1080p or new features?

We're working on it.

What about Hellfire?

Hellfire was a bit of a flop on the developer's part. Support may come in the future once the base game is finished.

Credits

• Reverse engineered by GalaXyHaXz in 2018
• sanctuary - extensively documenting Diablo's game engine
• BWAPI Team - providing library API to work with Storm
• Ladislav Zezula - reversing PKWARE library, further documenting Storm
• fearedbliss - being awe-inspiring
• Climax Studios & Sony - secretly helping with their undercover QA :P
• Blizzard North - wait, this was a typo!
• Depression - reason to waste four months of my life doing this ;)

And a special thanks to all the support and people who work on Devilution to make it possible! <3

Changelog

From the beginning until release

Legal

Devilution is released to the Public Domain. The documentation and function provided by Devilution may only be utilized with assets provided by ownership of Diablo.

Battle.net(R) - Copyright (C) 1996 Blizzard Entertainment, Inc. All rights reserved. Battle.net and Blizzard Entertainment are trademarks or registered trademarks of Blizzard Entertainment, Inc. in the U.S. and/or other countries.

Diablo(R) - Copyright (C) 1996 Blizzard Entertainment, Inc. All rights reserved. Diablo and Blizzard Entertainment are trademarks or registered trademarks of Blizzard Entertainment, Inc. in the U.S. and/or other countries.

Devilution and any of its' maintainers are in no way associated with or endorsed by Blizzard Entertainment(R).