Skip to content

Revise installation instructions for DevilutionX#8340

Open
AJenbo wants to merge 2 commits intomasterfrom
install
Open

Revise installation instructions for DevilutionX#8340
AJenbo wants to merge 2 commits intomasterfrom
install

Conversation

@AJenbo
Copy link
Copy Markdown
Member

@AJenbo AJenbo commented Dec 9, 2025

Also clarify when devilutionx.mpq is needed

Also clarify when devilutionx.mpq is needed
Comment thread docs/installing.md Outdated
Comment thread docs/installing.md
Certain 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.
<details><summary>🍎 MacOS X</summary>
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<details><summary>🍎 MacOS X</summary>
<details><summary>🍎 macOS</summary>

Comment thread docs/installing.md
### Base Game Files (Required)

First install the App via one of these 3 methods:
* Locate **`DIABDAT.MPQ`** from your original Diablo CD or the [GoG installation](https://www.gog.com/game/diablo).
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* Locate **`DIABDAT.MPQ`** from your original Diablo CD or the [GoG installation](https://www.gog.com/game/diablo).
* Locate **`DIABDAT.MPQ`** from your original Diablo CD, [Battle.net](https://shop.battle.net/product/diablo) installation or [GoG](https://www.gog.com/game/diablo) installation.

Comment thread docs/installing.md
2. Copy the MPQ files (from section 1) to **one** of the following locations:
* The folder containing the DevilutionX executable.
* The data folder, which will normally be: `~/.local/share/diasurgical/devilution/`
* *Flatpak Installation Path:* `~/.var/app/org.diasurgical.DevilutionX/data/diasurgical/devilution/`
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* *Flatpak Installation Path:* `~/.var/app/org.diasurgical.DevilutionX/data/diasurgical/devilution/`
* Flatpak Data Path: `~/.var/app/org.diasurgical.DevilutionX/data/diasurgical/devilution/`

Comment thread docs/installing.md

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.
1. Copy the MPQ files (from section 1) to **one** of the following locations:
* The folder containing the DevilutionX application.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This doesn't work. It has to be placed inside the application next to the executable.

@StephenCWills
Copy link
Copy Markdown
Member

I'm happy with the 3DS instructions.

@strich
Copy link
Copy Markdown
Collaborator

strich commented Jan 29, 2026

@AJenbo you wanna just merge this in? You can just make these kinds of edits directly via the GH wiki page in future btw, unless you wanted to use this PR as a form of discussion.

Comment thread docs/installing.md
Comment on lines +79 to +81
1. Copy the MPQ files (from section 1) to **one** of the following locations:
* The folder containing the DevilutionX application.
* The data folder, which will normally be: `~/Library/Application Support/diasurgical/devilution`
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. Copy the MPQ files (from section 1) to **one** of the following locations:
* The folder containing the DevilutionX application.
* The data folder, which will normally be: `~/Library/Application Support/diasurgical/devilution`
1. Copy the MPQ files (from section 1) to the data folder, which will normally be: `~/Library/Application Support/diasurgical/devilution`

@Trihedraf
Copy link
Copy Markdown
Collaborator

There are still outstanding changes requested from the original time of PR.

@AJenbo you wanna just merge this in?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants