diff --git a/README.md b/README.md index d2b85789e..d6e0f1758 100644 --- a/README.md +++ b/README.md @@ -18,102 +18,34 @@ *(The health-bar, and XP-bar are off by default, but can be enabled in the [ini-file](https://github.com/diasurgical/devilutionX/wiki/DevilutionX-diablo.ini-configuration-guide). Widescreen and transparency can also be disabled if preferred)* -# How To Install: - - Download [the latest DevilutionX release](https://github.com/diasurgical/devilutionX/releases), or build from source - - Copy diabdat.mpq from your CD or GoG installation (or [extract it from the GoG installer](https://github.com/diasurgical/devilutionX/wiki/Extracting-the-DIABDAT.MPQ-from-the-GoG-installer)) to the DevilutionX install folder or data folder. The DevilutionX install folder is the one that contains the DevilutionX executable. The data folder path may differ depending on OS version and security settings, but will normally be as follows: - - macOS `~/Library/Application Support/diasurgical/devilution` - - Linux `~/.local/share/diasurgical/devilution/` - - Windows `%AppData%\Roaming\diasurgical\devilution` - - Install [SDL2](https://www.libsdl.org/download-2.0.php), [SDL2_mixer](https://www.libsdl.org/projects/SDL_mixer/) and [SDL2_ttf](https://www.libsdl.org/projects/SDL_ttf/) (included in macOS and Windows releases): - - Ubuntu/Debian/Rasbian `sudo apt-get install libsdl2-ttf-2.0-0 libsdl2-mixer-2.0-0` - - Run `./devilutionx` - -## Installig on Ubuntu via PPA - - - Installing and playing on **Ubuntu** - - Add [DevilutionX stable](https://launchpad.net/~devilutionx/+archive/ubuntu/stable) or [DevilutionX git](https://launchpad.net/~devilutionx/+archive/ubuntu/dev) PPA repository - ``` - sudo add-apt-repository ppa:devilutionx/stable - sudo add-apt-repository ppa:devilutionx/dev - ``` - - Install **DeviliutionX** - ``` - sudo apt update - sudo apt install devilutionx - ``` - - For **Diablo I**: copy diabdat.mpq file to `~/.local/share/diasurgical/devilution/` folder - - - For **Diablo Hellfire**: copy hellfire.mpq, hfmonk.mpq, hfmusic.mpq, hfvoice.mpq files to `~/.local/share/diasurgical/devilution/` folder - - - Additionally for better widescreen support you can copy [devilutionx.mpq](https://github.com/diasurgical/devilutionX/raw/master/Packaging/resources/devilutionx.mpq) file to `~/.local/share/diasurgical/devilution/` folder - - - Run **DevilutionX** or **DevilutionX Hellfire** from menu to start game - -# Building from Source - -Want to compile the program by yourself, great! Simply follow the [build instructions](./docs/building.md); - -# 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; A ○, B ×, X △, Y □): +# What is DevilutionX -- Left analog or D-Pad: move hero -- A: attack nearby enemies, talk to townspeople and merchants, pickup/place items in the inventory, OK while in main menu -- B: select spell, back while in menus -- X: pickup items, open nearby chests and doors, use item in the inventory -- Y: cast spell, delete character while in main menu -- L1: use health item from belt -- R1: use mana potion from belt -- L2: character sheet (alt: Start + L1 or ←) -- R2: inventory (alt: Start + L2 or →) -- Left analog click: toggle automap (alt: Start + ↓) -- Start + Select: game menu (alt: Start + ↑) -- Select + A/B/X/Y: Spell hotkeys -- Right analog: move automap or simulate mouse -- Right analog click: left mouse click (alt: Select + L1) -- Select + Right analog click: right mouse click (alt: Select + R1) -- Select + L2: quest log (alt: Start + Y) -- Select + R2: spell book (alt: Start + B) +DevilutionX is a source port of Hellfire/Diablo that strives to make it simple to run the game while providing engine inprovments, bugfixes, and some optional quality of life features. -For now, they can be re-mapped by changing `SourceX/controls` or by setting the `SDL_GAMECONTROLLERCONFIG` environment -variable (see -[SDL_GameControllerDB](https://github.com/gabomdq/SDL_GameControllerDB)). +For a full list of changes see our [changelog](docs/CHANGELOG.md). -# Contributing -[Guidelines](docs/CONTRIBUTING.md) -# Mods +# How To Install: -[List of known mods based on DevilutionX](docs/mods.md) + - Download [the latest DevilutionX release](https://github.com/diasurgical/devilutionX/releases), or build from source -# F.A.Q. > 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](https://www.gog.com/game/diablo). Alternately you can use `spawn.mpq` from the [shareware](http://ftp.blizzard.com/pub/demos/diablosw.exe) version to play the shareware portion of the game. -> What game changes does DevilutionX provide -DevilutionX's main focus is to make the game work on multiple platforms. An additional goal is to make the engine mod friendly. As such, there are no changes to gameplay, but we will be making some enhancments to the engine itself. For example, the engine now has upscaling, unlocked fps, controller support, and multiplayer via TCP. + - Copy diabdat.mpq from your CD or GoG installation (or [extract it from the GoG installer](https://github.com/diasurgical/devilutionX/wiki/Extracting-the-DIABDAT.MPQ-from-the-GoG-installer)) to the DevilutionX install folder or data folder. The DevilutionX install folder is the one that contains the DevilutionX executable. -For a full list of changes see our [changelog](docs/CHANGELOG.md). +# Contributing -> Is 1080p supported? +We are always looking for more people to help with [coding](docs/CONTRIBUTING.md), [documentation](https://github.com/diasurgical/devilutionX/wiki), testing the [latest builds](https://app.circleci.com/pipelines/github/diasurgical/devilutionX?branch=master), spreading the word, or simply just having out on [the chat](https://discord.gg/YQKCAYQ). -Yes, the game will automatically adjust to your screen. This can be further adjusted in the game ini file. -> What about Hellfire? +# Mods -Yes, you can play both Hellfire, regular Diablo, or the shareware version all from the same installation of DevilutionX. -> Does it work with Battle.net? +We hope to provide a good starting points for mods, in addition to the full Devilution source code we also provide modding tools. Also checkout the list of known [mods based on DevilutionX](https://github.com/diasurgical/devilutionX/wiki/Mods-and-related-projects) -Battle.net is a service provided by Blizzard. We are not associated with them, so we have not worked on intergrating with their service. - +# Building from Source + +Want to compile the program by yourself, great! Simply follow the [build instructions](./docs/building.md); # Credits - The original Devilution project [Devilution](https://github.com/diasurgical/devilution#credits)