PSP port (upstream-psp)

This branch ports current DevilutionX to the PlayStation Portable. Download the latest PSP release for a ready-to-copy package. The older psp-enhanced releases are from a separate branch; use the latest release for this branch.

Extract the release ZIP so that the following files are directly inside PSP/GAME/DevilutionX/ on the Memory Stick:

PSP/GAME/DevilutionX/
├── EBOOT.PBP
├── assets/
└── mods/
    └── hf/

Supply your own game data in that same DevilutionX folder:

• Diablo: DIABDAT.MPQ from your Diablo installation.
• Hellfire: DIABDAT.MPQ, hellfire.mpq, hfmonk.mpq, hfmusic.mpq, and hfvoice.mpq. Enable the single Hellfire entry under Mods in the game.
• Shareware: use spawn.mpq extracted from Blizzard's original diablosw.exe instead of the retail MPQs. The archive verified on a PSP-3000 is 50,274,091 bytes, SHA-256 ea7de65bd1f12f1d04561c62a68f80eb36341e224974e1d93931fe82dc814e75. The 25,448,219-byte spawn.mpq from the DevilutionX assets download (SHA-256 64427cd7c1ba904eaa2e0031c16a6b136d0ecef9abc888c5ff8344b459356e38) contains MP3 audio and does not currently work with this PSP build on a PSP-3000. A controlled test using the same game data and MPQ layout ran with WAV audio but powered off the PSP when the audio was replaced with MP3. This points to a compatibility issue in the PSP port's MP3 audio path, not evidence that the official DevilutionX download is damaged. Other DevilutionX platforms may use that download normally.

Game MPQs are not included in the PSP download. Keep assets/ and mods/hf/ from the release. The PSP graphics menu offers 640×480 (4:3) and 848×480 (Widescreen) logical resolutions; widescreen shows a wider game view and is presented on the PSP's 480×272 screen without stretching a 4:3 frame. Retail Diablo, Hellfire, and the original Blizzard shareware archive have been tested on a PSP-3000. Performance depends on the scene and settings.

---

_{(The health-bar and XP-bar are off by default but can be enabled in the game settings. Widescreen can also be disabled if preferred.)}

What is DevilutionX

DevilutionX is a port of Diablo and Hellfire that strives to make it simple to run the game while providing engine improvements, bug fixes, and some optional quality of life features.

Check out the manual for available features and how to take advantage of them.

For a full list of changes, see our changelog.

How to Install

Note: You'll need access to the data from the original game. If you don't have an original CD, you can buy Diablo from GoG.com or Battle.net. Alternatively, you can use spawn.mpq from the shareware [2] version, in place of DIABDAT.MPQ, to play the shareware portion of the game. For this PSP build, follow the WAV-archive guidance in the PSP section above.

Download the latest DevilutionX release and extract the contents to a location of your choosing or build from source.

• Copy DIABDAT.MPQ from the CD or Diablo installation (or extract it from the GoG installer) to the DevilutionX folder.
• To run the Diablo: Hellfire expansion, you will also need to copy hellfire.mpq, hfmonk.mpq, hfmusic.mpq, and hfvoice.mpq.

For more detailed instructions: Installation Instructions.

Contributing

We are always looking for more people to help with coding, documentation, testing the latest builds, spreading the word, or simply just hanging out on our Discord server.

Mods

We hope to provide a good starting point for mods. In addition to the full Devilution source code, we also provide modding tools. Check out the list of known mods based on DevilutionX.

Test Builds

If you want to help test the latest development version (make sure to back up your files, as these may contain bugs), you can fetch the test build artifact from one of the build servers:

Note: You must be logged into GitHub to download the attachments!

Building from Source

Want to compile the program by yourself? Great! Simply follow the build instructions.

Credits

• The original Devilution project: Devilution
• Everyone who worked on Devilution/DevilutionX
• Nikolay Popov for UI and graphics
• WiAParker for the Polish voice pack
• And thanks to all who support the project, report bugs, and help spread the word ❤️

Legal

DevilutionX is made publicly available and released under the Sustainable Use License (see LICENSE).

The source code in this repository is for non-commercial use only. If you use the source code, you may not charge others for access to it or any derivative work thereof.

Diablo® - Copyright © 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.

DevilutionX and any of its maintainers are in no way associated with or endorsed by Blizzard Entertainment®.