docs/installing.md
First, you will need access to the game's MPQ files.
DIABDAT.MPQ on your CD, or in the GoG installation (or extract it from the GoG installer).hellfire.mpq, hfmonk.mpq, hfmusic.mpq, hfvoice.mpq.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.
<details><summary>Android</summary>First install the App via one of these 3 methods:
adb install (if USB debugging is enabled on the device)Then launch the App, this will let it create the folder where you need to place the MPQ files.
Connect the device to your computer via USB cable, and allow data access from your device:
Open the device's internal storage, and navigate to Android/data/org.diasurgical.devilutionx/files, then copy the MPQ-files to this folder.
When the transfer is done you can disconnect your device and press "Check again" in the App to start the game.
Troubleshooting: If you encounter some trouble getting the MPQ files onto your Android device, you can refer to our guide for extracting the MPQ files on the Android device itself. Note that Inno Setup Extractor is only available for Android 8+ and the Import Data feature is only available for Android 7.1.1+.
</details> <details><summary>Windows</summary>Note: if you have the GoG version installed on your Windows machine, you do not need to copy the MPQ files as described in the instructions.
%AppData%\diasurgical\devilutiondevilutionx.exe~/.local/share/diasurgical/devilution/, for flatpak installation the path is ~/.var/app/org.diasurgical.DevilutionX/data/diasurgical/devilution/sudo apt install libsdl2-2.0-0 libsdl2-image-2.0-0sudo dnf install SDL2./devilutionx~/Library/Application Support/diasurgical/devilutiondevilutionx~/.local/share/diasurgical/devilution/cd /usr/ports/games/devilutionX/ && make install cleanpkg install games/devilutionX || pkg install devilutionXdevilutionxCertain sideloading applications exist which can let you install IPA packages to your device such as AltStore (https://altstore.io/) and Sideloadly (https://sideloadly.io/). Using such a sideloading application, install the .ipa file to your iDevice.
Once the App is installed, launch it once. It will say that it cannot find the data file (.MPQ). This is ok. Close the game. Do not skip this step as it will create your Documents folder that you will need to access in later steps.
There are 3 way to get install the MPQs. Make sure to have installed the app and have launched it once before attempting to copy over the MPQ files.
Method 1 (May no longer work): Using the files.app
- Using the files.app, navigate to "On My iPhone / On My iPad"
- Copy the MPQs to the devilutionx directory. Your directory should look like on the picture below
- Go back to your home screen and launch the game
Method 2: Using Finder (MacOS)
On more recent versions of MacOS, iTunes is no more. Instead you can use Finder to directly copy data to and from your iDevices
Connect your iDevice to your computer and click on the "Files" tab.
Drag and drop the MPQ files on the devilutionx directory
Method 3: Using iTunes (Windows and older MacOS)
Connect you iDevice to your computer and launch iTunes
Click on your device and in the files tab drag and drop the MPQ files to the devilutionx directory
devilutionx.nro in into /switch/devilutionx/switch/devilutionx.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.Download devilutionx.cia from the latest release and place it on your SD card.
This file will be used later to install the game on the 3DS console.
Copy the MPQ files to the devilutionx subfolder under the 3ds folder on your SD card (/3ds/devilutionx). The game will read these files from this location.
You do not need a copy of devilutionx.mpq on your SD card to run the game on 3DS.
To avoid errors when you run the game, if you have an old version of devilutionx.mpq in the folder, you should remove it now. Note, all file and folder names should be lowercase, as shown in the example screenshot below.
Put the SD card back into the 3DS console and then power it on.
Use a title manager such as FBI to install devilutionx.cia.
You will no longer need devilutionx.cia after this step, and so it can be removed after the installation.
FBI provides the Remote Install option to download and install a cia in one step by scanning a QR code using the Nintendo 3DS camera.
This is most useful when upgrading from a previous version so that you can perform the installation without removing the SD card from the console.
If you'd like to use this option, scan the QR code below.
View on DevilutionX and select Manage game and add-onsFile info and note FullName/LOCALFOLDER/*FullName*/LocalState/diasurgical/devilution using a FTP-client on your PC/user/data/diasurgical/devilution/ux0:/data/diasurgical/devilution/.__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./home/cpi/.local/share/diasurgical/devilution//media/data/apps or /media/sdcard/apps/./usr/local/home/.local/share/diasurgical/devilution/Requires RetroFW 2.0+.
~/.local/share/diasurgical/devilution~ is your home directory, /home/retrofw by default.
Requires firmware v1.5+
/media/sdcard/APPS/./media/home/.local/share/diasurgical/devilution/ln -sf /media/sdcard/<path_to_MPQ> /media/home/.local/share/diasurgical/devilution/<MPQ>
Requires OnionOS to be installed
/Emu/PORTS/Binaries/Diablo.port/FILES_HERE/