devilutionX/docs/installing.md

Installing

First, you will need access to the game MPQ files.

• First, locate DIABDAT.MPQ on your CD or in the GoG installation (or extract it from the GoG installer).
• For the Diablo: Hellfire expansion you will also need hellfire.mpq, hfmonk.mpq, hfmusic.mpq, hfvoice.mpq.
• Lastly, DevilutionX comes with devilutionx.mpq which you will also need.

Download the latest DevilutionX release for your system (if available) and extract the contents to a location of your choosing, or build from source. Then follow the system-specific instructions below.

Windows

• Copy the MPQ files to the folder containing the DevilutionX exe, or to the data folder. The data folder path may differ, but will normally be %AppData%\diasurgical\devilution
• Run devilutionx.exe

Linux

• Copy the MPQ files to the folder containing the DevilutionX executable, or to the data folder. The data folder path may differ depending on distro, version, and security settings, but will normally be ~/.local/share/diasurgical/devilution/
• Install SDL2:
• Ubuntu/Debian/Rasbian sudo apt install libsdl2-2.0-0
• Fedora sudo dnf install SDL2
• Run ./devilutionx

Ubuntu PPA

• Add DevilutionX stable

sudo add-apt-repository ppa:devilutionx/stable

• Install DeviliutionX

sudo apt update
sudo apt install devilutionx

• Copy the MPQ files to ~/.local/share/diasurgical/devilution/
• Run DevilutionX or DevilutionX Hellfire from the menu to start the game

MacOS X

• Copy the MPQ files to the folder containing the DevilutionX application, or to the data folder. The data folder path may differ, but will normally be ~/Library/Application Support/diasurgical/devilution
• Double-click devilutionx

Nintendo Switch

• Copy devilutionx.nro in into /switch/devilutionx
• Copy the MPQ files to /switch/devilutionx.
• Launch devilutionx.nro by holding R the installed game. Do not use the album to launch, if you use the album, the homebrew will only have a small amount of memory available, and the touch keyboard won't work. This is true for all homebrew, not just DevilutionX.

Android

• Copy the APK file to device and tap on it on device's file explorer or install via adb install (if USB debugging is enabled on device).
• Place the MPQ-files in /sdcard/Android/data/org.diasurgical.devilutionx/files folder

New Nintendo 3DS

.3dsx installation

• Copy devilutionx.3dsx into sd:/3ds/devilutionx/.
• Copy the MPQ files into sd:/3ds/devilutionx/.
• Launch devilutionx.3dsx with the Homebrew Launcher.
  • Note: When the Hellfire .mpqs are installed you can still launch regular Diablo by passing --diablo to devilutionx.3dsx.

.cia installation

• Copy devilutionx.cia to your SD card.
• Copy the MPQ files to sd:/3ds/devilutionx/.
• Install devilutionx.cia with a title manager (e.g. FBI).
  • devilutionx.cia can be removed after being installed.
• Launch Diablo from your 3DS Homemenu.

Playstation Vita

• Install devilutionx.vpk
• Copy the MPQ files to ux0:/data/diasurgical/devilution/.

ClockworkPi GameShell

• Copy the __init__.py to a newly created folder under /home/cpi/apps/Menu and run it from the menu. The folder then symbolizes the devilutionX icon.
• From this menu, you can press 'X' to clone the git repository for devilutionX and compile the code. Dependencies are installed automatically (cmake and SDL development packages).
• Once installed, 'X' pulls the updated code and does the compiling. Note that any changes made locally to the source are reverted before pulling.
• When the compile is finished, Copy the MPQ files to /home/cpi/.local/share/diasurgical/devilution/
• You can now play the game from the same icon.

GKD350h

• Copy devilutionx-gkd350h.opk to /media/data/apps or /media/sdcard/apps/.
• Copy the MPQ files to /usr/local/home/.local/share/diasurgical/devilution/

RetroFW

Requires RetroFW 2.0+.

• Copy devilutionx-retrofw.opk to the apps directory.
• Copy the MPQ files to ~/.local/share/diasurgical/devilution

~ is your home directory, /home/retrofw by default.

RG350

Requires firmware v1.5+

• Copy devilutionx-rg350.opk to /media/sdcard/APPS/.
• Copy the MPQ files to /media/home/.local/share/diasurgical/devilution/

ln -sf /media/sdcard/<path_to_MPQ> /media/home/.local/share/diasurgical/devilution/<MPQ>