wrath-darkplaces/README.md

49 lines
2.5 KiB
Markdown
Raw Permalink Normal View History

2019-11-25 11:37:03 -08:00
# wrath-darkplaces
This is the fork of [LordHavoc's DarkPlaces Quake engine](https://icculus.org/twilight/darkplaces/) that is used in the game [WRATH: Aeon of Ruin](http://wrath.game/).
It's based on the [13/05/2014 DarkPlaces source snapshot](https://icculus.org/twilight/darkplaces/files/darkplacesengine20140513.zip), with some minor additions and alterations.
## This repository
This repository contains the up-to-date version of the source code used to build the WRATH binaries. It'll be updated with every Steam/GOG update that changes the binaries.
Pull requests to this repository are **not** accepted.
## Building
2019-11-25 11:40:02 -08:00
Currently the only version of the executable on Steam/GOG is the WGL x64 build. SDL/SDL2 builds work on both Windows and Linux, but have some mouse-related issues in the UI. The Linux GLX build has slight sound issues with the ALSA backend.
2019-11-25 11:37:03 -08:00
This has not been built or tested on MacOS X yet, but it might work.
### Dependencies
(or at least what the Steam/GOG binaries are built and shipped with)
* `mingw-w64` / `gcc` (Visual Studio projects/builds are currently somewhat broken);
* `libjpeg` or `libjpeg-turbo`;
* `libogg`, `libvorbis` and `libvorbisfile`;
* `libpng 1.6`;
* `libfreetype`;
* `libd0_blind_id`;
* `libcurl`;
* `libSDL 1.2` or `libSDL 2.0` for the SDL/SDL2 builds.
2020-02-07 11:28:16 -08:00
For example, in MSYS2 you can use the following command to get pretty much everything you need:
```
pacman -S git mingw-w64-{i686,x86_64}-{gcc,make,cmake} mingw-w64-{i686,x86_64}-{libjpeg-turbo,libogg,libvorbis,libpng,freetype,curl,SDL2}
```
2019-11-25 11:37:03 -08:00
### Instructions
1. Install dependencies (if you're using msys2, you can get most of these using pacman; some libraries are loaded dynamically and you can just copy the DLLs from the game folder, or from a DarkPlaces release);
1. `cd` to this directory;
2. Run `make` to get the list of available targets.
3. `make` your desired target.
2020-02-07 11:28:16 -08:00
`make cl-release`/`make cl-debug` will build the WGL executable on Windows and the GLX executable on Linux.
Use `make sdl2-release`/`make sdl2-debug` to build the SDL2 version. Remove the `2` for the SDL1.2 version.
2019-11-25 11:37:03 -08:00
## Running
Rename your binary to `wrath` (or `wrath.exe` on Windows), place it into the game directory and run it.
Alternatively instead of renaming you can pass `-wrath` as a command line parameter: `./darkplaces-sdl -wrath`.
## License
DarkPlaces and this fork are licensed under version 2 of the GNU General Public License. A copy of the license is included in this repository (see [`COPYING`](https://github.com/KillPixelGames/wrath-darkplaces/blob/master/COPYING)).