=========== D2X =========== http://icculus.org/d2x Linux/Unix: =========== Required tools: * GCC 2.95 * SDL 1.1.0 or higher * NASM 0.98 (OPTIONAL but RECOMMENDED for x86) * A thread safe X server. * Make, sed, etc... Build instructions: Install all of the components above. Next, from the d2x directory: ./configure ./configure --help will show you the available options. If you have a 3d graphics card, use --with-opengl VPATH builds also work (i.e., you can put the source in one directory and build in another. Just execute the configure script from the build directory like so: mkdir d2x-build cd d2x-build ../d2x-source/configure make make install see installation.txt for info on where to put your datafiles, etc. Known bugs/issues: * Serial support doesn't work. (UDP and IPX networking does) * Sound glitches (due to stuff I haven't implemented) * The mouse support is at the same level as it was in d1x (as in, it kind of works) (btb: works pretty good for me.) Win32: ====== Required tools: * Cygwin d2x doesn't use Cygwin, but it makes building it easier (to me). You can probably build it with just MinGW, but I haven't tried yet. * SDL 1.1.0 or higher * NASM 0.98 (OPTIONAL but RECOMMENDED) You will probably have to compile SDL from source. Download the source code tarball from http://www.libsdl.org/ tar zxf SDL-x.x.x.tar.gz cd SDL-x.x.x ./configure make make install Note that SDL.dll needs to be in your executable PATH, since that is where windows looks for dlls. I recommend copying or moving it to /usr/local/bin: cp /usr/local/lib/SDL.dll /usr/local/bin If you need to run autogen.sh (e.g. to rebuild the configure scripts, or to build from cvs) sdl.m4 will have to be somewhere where aclocal can find it. You can fix this by setting the ACLOCAL_FLAGS variable like this: export ACLOCAL_FLAGS=/usr/local/share/aclocal You should also install NASM, for compiling assembler files. Download it from http://www.web-sites.co.uk/nasm/where.html and place nasmw.exe somewhere in your path (e.g. /usr/local/bin): unzip nasm-0.98-win32.zip mv nasmw.exe /usr/local/bin Now you can configure d2x as normal. i.e. ./configure or ./configure --with-opengl automake/autoconf in cygwin has a problem with not always putting the .exe extentions where they need to be. So you may have to run make twice, like so: make && make d2x-sdl.exe or make && make d2x-gl.exe Then just copy your executable and SDL.dll into the descent2 directory. MS-DOS: ======= Dos support isn't a high priority right now, so things may be a little messed up. Required tools: * DJGPP v2 The following DJGPP packages are ALL REQUIRED (newer versions are ok)! v2/ djdev203.zip v2gnu/ bnu281b.zip gcc2952b.zip mak3781b.zip bsh1147b.zip sed302b.zip m4-14b.zip acnf213b.zip gwk304b.zip txt20b.zip grep22b.zip dif272b.zip So many packages are needed to support the autoconf build system that d2x uses. (Sorry! =) * NASM v0.98 or better is REQUIRED Build instructions: Install all of the djgpp packages above. Make sure that DJGPP is properly configure (see the DJGPP docs for more information). Make a copy of bash.exe in your djgpp bin/ directory. Call it "sh.exe". This step is VERY IMPORTANT (otherwise all the scripts will fail). Now, run the following from the d2x directory: djgpp.bat make Hopefully things will work out and the package will build correctly for you. Known bugs/issues: * Serial and network support missing. * Sound support missing. Reporting bugs/feedback: ======================== There are two ways to report bugs and give feedback: 1) Get on the descent-source mailing list by sending an email to majordomo@warpcore.org with the body as: "subscribe descent-source ". Discussions about the source code in general are available here, and is the main list that d2x and d1x, a similar project for descent 1 is discussed on. Patches and questions can be posted there, as well. 2) Send feedback directly to me, bradleyb@u.washington.edu. I'll try to get back to you ASAP, depending on real-life concerns =) /* THE OLD README FOLLOWS */ Legal Stuff: THE COMPUTER CODE CONTAINED HEREIN IS THE SOLE PROPERTY OF PARALLAX SOFTWARE CORPORATION ("PARALLAX"). PARALLAX, IN DISTRIBUTING THE CODE TO END-USERS, AND SUBJECT TO ALL OF THE TERMS AND CONDITIONS HEREIN, GRANTS A ROYALTY-FREE, PERPETUAL LICENSE TO SUCH END-USERS FOR USE BY SUCH END-USERS IN USING, DISPLAYING, AND CREATING DERIVATIVE WORKS THEREOF, SO LONG AS SUCH USE, DISPLAY OR CREATION IS FOR NON-COMMERCIAL, ROYALTY OR REVENUE FREE PURPOSES. IN NO EVENT SHALL THE END-USER USE THE COMPUTER CODE CONTAINED HEREIN FOR REVENUE-BEARING PURPOSES. THE END-USER UNDERSTANDS AND AGREES TO THE TERMS HEREIN AND ACCEPTS THE SAME BY USE OF THIS FILE. COPYRIGHT 1993-1999 PARALLAX SOFTWARE CORPORATION. ALL RIGHTS RESERVED. We make no warranties as to the usability or correctness of this code. ============================================ Message from Matt Toschlog & Mike Kulas: Descent fans: Here, finally, is the source for Descent II. We've been so busy with Descent 3, Mercenary, FreeSpace, FreeSpace 2, and several other projects that we haven't given much thought to this old code. But we know that many of you are eager to get it, so here you go. We were amazed and impressed at the cool things people did with the Descent source we released a few years ago. It touches us deeply how devoted some people are to the Descent series, and we look forward to seeing what people can do with this Descent II source. Matt Toschlog Mike Kulas Outrage Entertainment Volition, Inc. ============================================ About the Source Code: Included is almost all the source code to Descent 2, ver. 1.2. We removed all code to which we did not own the copyright. This mainly involved low- level sound and modem code and the movie code. The Descent Network has agreed to provide a list of mirror locations where this code can be downloaded. The location is: http://www.descent2.com/ddn/sources/descent2 The following tools were used in the development of Descent: Watcom C/C++, version 9.5 Microsoft Macro Assembler, version 6.1x Opus Make, version 6.01 Have fun with the code! Parallax Software Corporation 12/14/1999 As Packaged the code currently will not compile. Some code had to be removed to release it, therefore you will get some missing file errors when building. Much of this code is very close to the Descent 1 source code. Many people have put effort into porting that code, so if you are interested in porting D2, you should be able to take advantage of some of that work. A few good web sites to check out are: The D1X Project: http://d1x.warpcore.org The Descent Network: http://www.descent-network.com