get rid of compiler warnings
[btb/d2x.git] / installation.txt
1 Installing d2x on Windows
2 -------------------------
3
4 Unzip the binary release (d2x-x.x.x_mingw.zip), placing the files in
5 your descent2 directory (C:\GAMES\DESCENT2 by default)
6
7 You will also need the SDL and SDL_image runtime libraries.
8 Get SDL-1.2.x-win32.zip from here:
9 http://www.libsdl.org/download-1.2.php
10 And get SDL_image-1.2.x-win32.zip from here:
11 http://www.libsdl.org/projects/SDL_image/
12
13 Unzip these files and place the DLLs in your descent2 directory, or
14 you can place them in your system directory if you want to use them
15 with programs other than d2x.
16 See below for data installation.
17
18
19 Installing d2x on MacOS X
20 -------------------------
21
22 I guess we need to figure out the binary distribution first, eh?
23
24
25 Base Data Installation
26 ----------------------
27
28 In addition to d2x, you need some data files to play.
29 In Windows or DOS, they go in the same directory as the d2x binary
30 (C:\GAMES\DESCENT2 by default).
31
32 On unix, these files usually go into a shared data directory
33 (/usr/local/share/games/d2x by default).
34 They can also go in $HOME/.d2x, or in an arbitrary directory specified
35 with the -hogdir option on the d2x command line.
36
37 The base install depends on which version of the datafiles you have.
38 d2x currently supports just about any version of Descent II, and can
39 use almost any version of Descent I as an add-on.
40
41 Place these files into your shared data dir:
42
43 Full Version (PC or Mac):
44 descent2.ham
45 descent2.hog
46 descent2.s11
47 descent2.s22
48 alien1.pig
49 alien2.pig
50 fire.pig
51 groupa.pig
52 ice.pig
53 water.pig
54
55 If you want movies, place the .mvl files in your shared data dir:
56 intro-h.mvl and/or intro-l.mvl
57 other-h.mvl and/or other-l.mvl
58 robots-h.mvl and/or robots-l.mvl
59 The mvl files from the Mac version will not work.  They are in a
60 different format!
61
62 OEM Version (Destination: Quartzon):
63 descent2.ham
64 descent2.hog
65 descent2.s11
66 descent2.s22
67 fire.pig
68 groupa.pig
69 ice.pig
70 water.pig
71
72 If you want movies, place the .mvl files in your shared data dir:
73 intro-l.mvl
74 other-l.mvl
75 robots-h.mvl and/or robots-l.mvl
76
77 PC Shareware:
78 d2demo.ham
79 d2demo.hog
80 d2demo.pig
81
82 Mac Shareware:
83 d2demo.ham
84 d2demo.hog
85 d2demo.pig
86 descent2.s11
87 exit.ham
88 d2.mn2
89
90
91 Add-on Mission Installation
92 ---------------------------
93
94 d2x should be able to play any missions for Descent I or Descent II,
95 including the original Descent I mission (Descent: First Strike)
96
97 In order to play any add-on missions, you need to have a full set of
98 textures.  That is, your base installation above must be the "Full
99 Version", the "OEM Version", or the "Mac Shareware" version.
100
101 To install an additional mission, just place the .hog and the .msn or
102 .mn2 file into your missions directory.  The missions directory can be
103 inside the system-wide data dir, or your $HOME/.d2x dir.  d2x will
104 look in both places.
105
106 To install the original Descent I mission:
107 Place descent.hog into your data dir.
108
109 d2x tries to make Descent I levels look as close to the original as
110 possible, using just Descent II textures. However, if d2x finds
111 a .pig file from Descent I (except PC shareware and 1.0 versions)
112 installed in the data dir, it is able to improve the originality
113 by reading textures from there (except for animated textures).
114
115
116 Vertigo Installation
117 --------------------
118
119 Vertigo consists of both netgame enhancements (codenamed HOARD) and an
120 additional mission.  To install HOARD, place hoard.ham in your data
121 dir.  To play the vertigo mission, place d2x.hog and d2x.mn2 in your
122 mission dir.
123 If you want the movies that go with the vertigo mission, place
124 d2x-h.mvl and/or d2x-l.mvl in your data dir.
125
126
127 Notes
128 -----
129
130 In unix, all filenames must be in _lower case_. It's important.
131
132 It is not necessary to run the D2 setup program to extract the files
133 you need, just use unarj to extract the files from descent2.sow on the
134 cd.
135
136 If you use the mac demo data files, and they are not auto-detected
137 (colors come out wrong), use the -macdata switch.
138
139 If your computer has performance problems playing the movies, you can
140 tell it to play the low resolution versions by setting MovieHires=0 in
141 your descent.cfg file.
142 You can also override this setting by passing the -lowresmovies switch
143 or by deleting all *-h.mvl files.