2008-03-22 04:48:37 +00:00
|
|
|
|
Compiling D2X-Rebirth Sourcecode
|
2007-05-03 15:44:52 +00:00
|
|
|
|
|
|
|
|
|
This file describes how to compile D2X-Rebirth from Source.
|
2008-05-21 14:25:00 +00:00
|
|
|
|
|
2007-05-03 15:44:52 +00:00
|
|
|
|
|
2010-02-23 19:58:19 +00:00
|
|
|
|
Requirements:
|
|
|
|
|
=============
|
|
|
|
|
|
|
|
|
|
1. C/C++ compiler (gcc/g++)
|
|
|
|
|
2. SCons (to compile in *NIX/Win32) / XCode (to compile on MacOS)
|
|
|
|
|
3. SDL(-devel)
|
|
|
|
|
4. PhysFS(-devel)
|
|
|
|
|
5. GLU/GL
|
|
|
|
|
6. NASM (optional for Assembler-based Texture-mapper in non-OpenGL Build)
|
|
|
|
|
7. SDL_mixer(-devel) (+ dependencies) for external music support
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Compiling:
|
|
|
|
|
==========
|
|
|
|
|
|
|
|
|
|
*NIX:
|
|
|
|
|
-----
|
|
|
|
|
Type 'scons' to compile the source.
|
2011-09-13 23:15:32 +00:00
|
|
|
|
You can also give additional options like 'scons use_udp=0'. See 'scons -h' for available options.
|
2010-02-23 19:58:19 +00:00
|
|
|
|
To install, use 'scons install' but remember to use all your options as well or SCons will re-compile and
|
|
|
|
|
install without any options given to prior compiling. However it's STRONGLY recommended NOT to use the
|
|
|
|
|
'install' argument but to create a package for your Linux distribution or operating system. 'install' will
|
2011-01-03 10:42:53 +00:00
|
|
|
|
compile the resulting binary (d2x-rebirth) to /usr/local/bin/ by default so to uninstall, just
|
2010-02-23 19:58:19 +00:00
|
|
|
|
delete the binary.
|
|
|
|
|
|
|
|
|
|
MacOS:
|
|
|
|
|
------
|
|
|
|
|
For Mac OS X, an Xcode project is available (requires Xcode 2.1 or later). Xcode includes the compiler
|
2011-01-03 10:42:53 +00:00
|
|
|
|
and OpenGL. The standard SDL and SDL_mixer libraries from the SDL website may be used, these go in
|
|
|
|
|
/Library/Frameworks or ~/Library/Frameworks. However, to fix MP3 support for the 'Release' build I used
|
|
|
|
|
SDL 1.2.8 with Diedel's modified SMPEG library from his D2X-XL website. To debug these libraries compile
|
|
|
|
|
the frameworks from source as 'Debug' builds, then use these instead. PhysicsFS must be compiled from
|
|
|
|
|
source. Put its enclosing folder 'physfs', renaming if necessary, next to D1X's (typically d1x-rebirth).
|
|
|
|
|
In CMake ensure the build path points to 'build' inside 'physfs'. Specify 'i386;ppc' as the architecture
|
|
|
|
|
for a universal binary. In Xcode, build 'Debug' and 'Release' from the dynamic library target.
|
2010-09-17 10:44:21 +00:00
|
|
|
|
SCons also works on MacOS X, but it's recommended to use XCode instead.
|
2011-01-03 10:42:53 +00:00
|
|
|
|
|
|
|
|
|
For Mac OS 9, an MPW Makefile is available. MPW includes the compiler. As for the shared libraries,
|
|
|
|
|
compile PhysicsFS version 1.0 and the latest SDL and SDL_mixer (as of writing) from source. For SDL_mixer
|
|
|
|
|
1.2.11 you will need to disable MikMod support, from SDL_mixer.make, otherwise use SDL_mixer 1.2.8.
|
|
|
|
|
For any sources to compile, they will need to be made into text files using a typecode changing program,
|
|
|
|
|
if they were downloaded outside of Mac OS 9 (including Mac OS X). This will also need to be done after any
|
2013-08-05 11:17:40 +00:00
|
|
|
|
Terminal command (diff, svn update etc) edits the source files. THIS MAKEFILE IS GROSSLY OUT OF DATE!!
|
2011-01-03 10:42:53 +00:00
|
|
|
|
|
2018-09-02 00:57:29 +00:00
|
|
|
|
Note that there are ready-to-go packages on https://www.dxx-rebirth.com
|
2010-02-23 19:58:19 +00:00
|
|
|
|
|
|
|
|
|
Win32:
|
|
|
|
|
------
|
|
|
|
|
Use the SCons way like described in the *NIX-instructions from an MSYS/MinGW environment. However you will
|
|
|
|
|
not need to use 'install' but just drag the resulting binary to your Descent-folder.
|
2018-09-02 00:57:29 +00:00
|
|
|
|
Note that there are ready-to-go packages on https://www.dxx-rebirth.com
|
2010-02-23 19:58:19 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Needed files:
|
|
|
|
|
=============
|
|
|
|
|
|
|
|
|
|
Since D2X-Rebirth is a Sourceport of the Descent2-Engine you will need the Game-Content data files to run
|
2016-08-30 11:15:55 +00:00
|
|
|
|
the game. You can use your original Floppies, CDs or files from previously bought GOG or Steam versions.
|
2010-02-23 19:58:19 +00:00
|
|
|
|
|
|
|
|
|
Following files are needed to run the game:
|
|
|
|
|
descent2.ham
|
|
|
|
|
descent2.hog
|
|
|
|
|
descent2.s11
|
|
|
|
|
descent2.s22
|
|
|
|
|
alien1.pig
|
|
|
|
|
alien2.pig
|
|
|
|
|
fire.pig
|
|
|
|
|
groupa.pig
|
|
|
|
|
ice.pig
|
|
|
|
|
water.pig
|
|
|
|
|
intro-h.mvl and/or intro-l.mvl
|
|
|
|
|
other-h.mvl and/or other-l.mvl
|
|
|
|
|
robots-h.mvl and/or robots-l.mvl
|
|
|
|
|
|
|
|
|
|
With the PC version, these files - except the Movies (*.mvl) - are archived in the file
|
|
|
|
|
'descent2.sow' on the Descent2 CD-Rom.
|
2019-08-25 17:06:34 +00:00
|
|
|
|
This is an ARJ-archive and can be extracted with an adapted archiver like unarj or by installing the
|
2010-09-17 10:44:21 +00:00
|
|
|
|
game on a Windows/DOS system.
|
2010-02-23 19:58:19 +00:00
|
|
|
|
|
|
|
|
|
Note that the above files must be lowercase if you use an operating system with case-sensitive file management.
|
|
|
|
|
|
2011-05-19 22:14:42 +00:00
|
|
|
|
For the Mac CD-ROM, download The Unarchiver (http://wakaba.c3.cx/s/apps/unarchiver.html) and drag the
|
2016-08-30 11:15:55 +00:00
|
|
|
|
installer program onto it. Alternatively, use a computer with Mac OS 9 to run the installer, then copy over.
|
2019-08-25 17:06:34 +00:00
|
|
|
|
After installing, copy all the files from 'Data' on the CD to the 'data' folder created.
|
2011-05-19 22:14:42 +00:00
|
|
|
|
Unfortunately the movies do not work; if you want the movies consider purchasing Descent 2 for PC
|
|
|
|
|
(e.g. from Good Old Games) and extract that installer with The Unarchiver. Hey, then you'll have
|
2011-04-10 05:34:13 +00:00
|
|
|
|
another license for multiplayer. ;)
|
2010-02-23 19:58:19 +00:00
|
|
|
|
|
2011-05-19 22:14:42 +00:00
|
|
|
|
Of course you can also use the Interactive Demo game content with D2X-Rebirth which you can find here:
|
2018-09-02 00:57:29 +00:00
|
|
|
|
https://www.dxx-rebirth.com/game-content/
|
2011-05-19 22:14:42 +00:00
|
|
|
|
|
2010-02-23 19:58:19 +00:00
|
|
|
|
|
|
|
|
|
Where to put these files:
|
|
|
|
|
=========================
|
|
|
|
|
|
|
|
|
|
*NIX
|
|
|
|
|
----
|
|
|
|
|
The Sharepath (/usr/local/share/games/d1x-rebirth/ by default - if not reconfigured via SCons) or
|
|
|
|
|
~/.d1x-rebirth or
|
|
|
|
|
another directory specified by -hogdir via d1x.ini
|
|
|
|
|
|
|
|
|
|
MacOS
|
|
|
|
|
-----
|
|
|
|
|
Same directory as where the binary is located or
|
|
|
|
|
another directory specified by -hogdir via d1x.ini
|
|
|
|
|
|
|
|
|
|
Win32
|
|
|
|
|
-----
|
|
|
|
|
Same directory as where the binary is located
|
2011-05-19 22:14:42 +00:00
|
|
|
|
another directory specified by -hogdir via d1x.ini
|
2010-02-23 19:58:19 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Optional files:
|
|
|
|
|
===============
|
|
|
|
|
|
|
|
|
|
D2X-Rebirth is expandable. You can add additional content to the game.
|
|
|
|
|
|
|
|
|
|
Vertigo series AddOn
|
|
|
|
|
--------------------
|
|
|
|
|
Can be added by copying the files
|
|
|
|
|
d2x-h.mvl and/or d2x-l.mvl, hoard.ham to your game-directory/Sharepath and
|
|
|
|
|
d2x.hog, d2x.mn2 to 'missions/' subdirectory.
|
|
|
|
|
All these files should be located on the ‘Vertigo Series’ CD-Rom
|
|
|
|
|
|
2010-08-15 06:57:51 +00:00
|
|
|
|
Missions:
|
|
|
|
|
---------
|
2010-02-23 19:58:19 +00:00
|
|
|
|
Those can be found on several websites. Add them to the game by copying them to subdirectory
|
|
|
|
|
‘missions/’. They can also go in subdirectories of 'missions/', unlike with the original version.
|
2011-05-19 22:14:42 +00:00
|
|
|
|
A good place to find additional mission might be the Descent mission Database:
|
2018-09-02 00:57:29 +00:00
|
|
|
|
https://www.dxx-rebirth.com/descent-mission-database/
|
2010-02-23 19:58:19 +00:00
|
|
|
|
|
2010-08-15 06:57:51 +00:00
|
|
|
|
Custom Music (MP3, OGG, AIF, etc.):
|
|
|
|
|
-----------------------------------
|
2013-08-05 11:17:40 +00:00
|
|
|
|
Custom Music can be played via the JUKEBOX options by specifying it in the Sound Options menu.
|
2010-08-15 06:57:51 +00:00
|
|
|
|
Please note that all custom music has to be in 44Khz format. Supported formats depend on the capabilities of SDL_mixer.
|
|
|
|
|
|
|
|
|
|
AddOn Packs:
|
|
|
|
|
------------
|
2013-08-05 11:17:40 +00:00
|
|
|
|
Custom AddOn packs will expand the game in many different ways. These are usually provided as ZIP or 7Z and can easily
|
2010-08-15 06:57:51 +00:00
|
|
|
|
be installed by putting them to where your game content resides (OS-dependent - see above).
|
|
|
|
|
NO EXTRACTION OR ADDITIONAL CONFIGURATION NEEDED.
|
2011-05-19 22:14:42 +00:00
|
|
|
|
You can find all official AddOns here:
|
2018-09-02 00:57:29 +00:00
|
|
|
|
https://www.dxx-rebirth.com/addons/
|
2010-02-23 19:58:19 +00:00
|
|
|
|
|
2007-05-03 15:44:52 +00:00
|
|
|
|
|
|
|
|
|
Launching the program
|
2010-02-23 19:58:19 +00:00
|
|
|
|
=====================
|
2007-05-03 15:44:52 +00:00
|
|
|
|
|
2010-02-23 19:58:19 +00:00
|
|
|
|
*NIX
|
|
|
|
|
----
|
2011-05-19 22:14:42 +00:00
|
|
|
|
After compiling and installing, the program can be launched with the command: d2x-rebirth
|
2007-05-03 15:44:52 +00:00
|
|
|
|
|
2010-02-23 19:58:19 +00:00
|
|
|
|
MacOS
|
|
|
|
|
-----
|
|
|
|
|
Simply double-click "D2X-Rebirth".
|
2007-05-03 15:44:52 +00:00
|
|
|
|
|
2010-02-23 19:58:19 +00:00
|
|
|
|
Win32
|
|
|
|
|
-----
|
2011-05-19 22:14:42 +00:00
|
|
|
|
Doubleclick d2x-rebirth.exe
|
2007-05-03 15:44:52 +00:00
|
|
|
|
|
2010-02-23 19:58:19 +00:00
|
|
|
|
To see a full list of available command-line options append ‘-h’, ‘-?’ to the command or refer file
|
|
|
|
|
d2x.ini
|
2007-05-03 15:44:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Appendix
|
2010-02-23 19:58:19 +00:00
|
|
|
|
========
|
|
|
|
|
http://DXX-Rebirth.com
|