NameDateSize

..16-Mar-201612 KiB

Aleph One Classic SDL.mcp24-Mar-2014685.6 KiB

aleph.dsp24-Mar-201427.1 KiB

aleph.dsw24-Mar-2014504

aleph.vcproj24-Mar-201457.8 KiB

AlephOne-m2-demo.spec24-Mar-20141.4 KiB

AlephOne-minf-demo.spec24-Mar-20141.7 KiB

AlephOne.mcp24-Mar-2014213 KiB

AlephOne.spec.in24-Mar-20142.4 KiB

AUTHORS29-Jun-20151,011

autogen.sh24-Mar-20141.9 KiB

carb.r24-Mar-2014392

changelogs/24-Mar-20144 KiB

Cheats/24-Mar-20144 KiB

configure.ac07-Apr-201510.8 KiB

COPYING24-Mar-201434.3 KiB

COPYING.SDL24-Mar-201422.7 KiB

data/20-Apr-20154 KiB

docs/24-Jun-20154 KiB

examples/24-Mar-20144 KiB

Expat/24-Mar-20144 KiB

Extra OpenGL Docs/24-Mar-20144 KiB

Extras/24-Mar-20144 KiB

FaderClassic.mcp24-Mar-2014115.2 KiB

INSTALL.BeOS24-Mar-20142.6 KiB

INSTALL.MacOSX24-Mar-20144.2 KiB

INSTALL.MacOSX.Carbon24-Mar-20147.4 KiB

INSTALL.Unix24-Mar-20144.3 KiB

INSTALL.Windows24-Mar-20145.9 KiB

Lua.mcp24-Mar-201475.2 KiB

m4/09-Mar-20154 KiB

Makefile.am19-Mar-20158.3 KiB

Makefile.BeOS24-Mar-20148.9 KiB

marathon.dtd24-Mar-20147.1 KiB

MML Scripts/24-Mar-20144 KiB

PBProjects/07-Apr-20154 KiB

Pfhormz Instructions.txt24-Mar-20142.7 KiB

Pfhormz.mcp24-Mar-2014303.4 KiB

Pfhortran_Release/24-Mar-20144 KiB

Prefix/24-Mar-20144 KiB

README24-Mar-201416.2 KiB

Resources/24-Mar-20144 KiB

SDL_Net_Carbon.sit24-Mar-2014216.2 KiB

Source_Files/29-Jun-20154 KiB

Speex.mcp24-Mar-201475.1 KiB

THANKS18-Mar-2015679

tools/16-Mar-20154 KiB

README

1
2  Aleph One/SDL
3  An Open Source 3D action game
4
5  Copyright (C) 1995 Bungie Software Corporation
6  Portions Copyright (C) 2000-2005 Christian Bauer, Loren Petrich,
7    Chris Pruett, Rhys Hill, Ben Thompson, Woody Zenfell, Mihai Pararita,
8    Bo Lindbergh et al.
9  Expat XML Library Copyright (C) 1998, 1999 James Clark
10
11
12License
13-------
14
15Aleph One is available under the terms of the GNU General Public License.
16See the file "COPYING" that is included in the distribution for details.
17
18The BeOS version of Aleph One is statically linked against SDL which is
19provided to you under the terms of the GNU Library General Public License.
20See the file "COPYING.SDL" that is included in the distribution for details.
21The source code for the version of SDL used is available on
22
23  http://alephone.cebix.net
24
25
26What is Aleph One?
27------------------
28
29Aleph One is an Open Source 3D first-person shooter game, based on the game
30Marathon 2 by Bungie Software. It is set in a Sci-Fi universe dominated by
31deviant computer AIs and features a well thought-out plot.
32
33
34System Requirements
35-------------------
36
37Aleph One/SDL runs on all Unix systems supported by SDL (which includes
38Linux, FreeBSD, Solaris and IRIX), on BeOS R4.5 or later versions, and on
39Windows 9x/NT/2000. It does not currently run on MacOS.
40
41Successfully tested systems include:
42 - Linux/i386
43 - Linux/alpha
44 - Linux/x86_64
45 - FreeBSD/i386
46 - Solaris/sparc
47 - BeOS/x86 R5
48 - BeOS/ppc R4.5
49 - Windows 95
50 - Windows 98/SE
51 - Windows NT 4
52 - Windows 2000
53
54To compile Aleph One/SDL, you need an up-to-date C++ compiler. Using GCC 3.x
55should give the best results. Users of pre-ISO C++ compilers need not apply.
56
57Aleph One/SDL supports, but doesn't require, OpenGL for rendering.
58
59
60Installing Aleph One
61--------------------
62
63See the files "INSTALL.Unix", "INSTALL.BeOS" and "INSTALL.Windows".
64
65Aleph One/SDL needs Marathon data files which are not included in the
66distribution, so you should read the installation instructions even if
67you have downloaded an executable version of Aleph One/SDL.
68
69
70Playing Aleph One
71-----------------
72
73Unix:
74  To start Aleph One, type
75
76   $ alephone
77
78  If you have installed the Marathon Demo data RPM packages, start Aleph One
79  like this
80
81   $ /usr/share/AlephOne_m2_demo/start
82  or
83   $ /usr/share/AlephOne_minf_demo/start
84
85BeOS:
86  To start Aleph One, double click the "AlephOne" application icon. If you want
87  to specify arguments or see error messages, you will have to start it from the
88  shell, however.
89
90Windows:
91  To start Aleph One, double click the "AlephOne" application icon. If you want
92  to specify arguments or see error messages, you will have to start it from an
93  MS-DOS window, however.
94
95The program can take a number of command line arguments. Here is a complete
96list:
97
98  [-h | --help]          Display the help message
99  [-v | --version]       Display the game version
100  [-d | --debug]         Allow saving of core files (disable SDL parachute)
101  [-f | --fullscreen]    Run the game fullscreen
102  [-w | --windowed]      Run the game in a window
103  [-g | --nogl]          Do not use OpenGL
104  [-s | --nosound]       Do not access the sound card
105  [-m | --nogamma]       Disable gamma table effects (menu fades)
106
107If Aleph One complains about missing data files, and you are sure that you
108have installed them, try setting the ALEPHONE_DATA environment variable to
109the path of the data file directory. This variable can also specify a colon-
110separated (Windows: semicolon-separated) list of directories which are
111searched for data files in the given order.
112
113The background story of the game and the keyboard controls are explained in
114the manual or README file on your Marathon CD or in the Demo archive.
115Here is a rundown of the default keyboard configuration (assuming a US
116keyboard; all keys are mapped by position):
117
118  On the menu screen:
119    N - Begin new game
120    O - Continue saved game
121    P - Preferences
122    R - Replay saved film
123    C - Show game credits
124    Q - Quit
125
126  In-game:
127    KP8     - Walk forward
128    KP5     - Walk backward
129    KP4     - Turn left
130    KP6     - Turn right
131
132    Z       - Sidestep left
133    X       - Sidestep right
134
135    D       - Look up
136    C       - Look down
137    V       - Look ahead
138
139    A       - Glance left
140    S       - Glance right
141
142    Space   - Fire weapon, primary trigger
143    Alt     - Fire weapon, secondary trigger (e.g. grenades)
144    KP7     - Select previous weapon
145    KP9     - Select next weapon
146
147    Tab     - Action (open doors, flip switches, log in to computer terminals)
148
149    Shift   - Sidestep
150    Ctrl    - Walk slowly/swim
151    Meta    - Keyboard look
152
153    M       - Overhead map
154
155  Other keys (not configurable):
156    -       - Zoom overhead map out
157    =       - Zoom overhead map in
158
159    \       - Toggle FPS display
160
161    Esc     - Quit game/leave terminal
162    Alt-Q   - Quit game
163    Alt-C   - Quit game (use this under BeOS because Alt-Q will quit
164              the whole Aleph One application without warning)
165    Alt-P   - Pause game (press Alt-P again to resume)
166
167    F1      - Decrease screen size
168    F2      - Increase screen size
169    F3      - Toggle high/low resolution
170    F4      - Reset OpenGL textures
171    F5      - Make the chase cam switch sides
172    F6      - Toggle chase cam
173    F7      - Toggle tunnel vision
174    F8      - Toggle crosshairs
175    F9      - Screen dump (saved in ~/.alephone/Screenshot_*.bmp files)
176    F10     - Toggle position display
177    F11     - Decrease gamma level
178    F12     - Increase gamma level
179
180    ,       - Decrease sound volume
181    .       - Increase sound volume
182    [ and ] - Scroll player inventory view
183
184    Backspace - Switch player view in replays
185    [ and ] - Adjust film replay speed
186
187If you click on "Defaults" in the keyboard configuration menu when mouse
188control has been turned on you will get a different keyboard layout, more
189suited to mouse play.
190
191
192Playing third-party maps with Aleph One
193---------------------------------------
194
195(If the following instructions are too technical for you, see the "Map
196installation for dummies" section, below)
197
198Aleph One can be extended with custom map, physics, shape and sound files
199which can be selected in the "Environment" section of the preferences menu.
200Aleph One/SDL looks for these files in two places:
201
202Unix:
203  /usr/local/share/AlephOne
204 and
205  ~/.alephone
206
207BeOS:
208  The Aleph One application directory
209 and
210  /boot/home/config/settings/Aleph One
211
212Windows:
213  The Aleph One application directory
214 and
215  The directory "Prefs\<user name>" in the Aleph One application directory
216
217Aleph One looks in both of these directories (and in all subdirectories) for
218map, shape and sound files it recognizes and shows a list of them in the
219"Environment" preferences menu when clicking on one of the "Map", "Physics",
220"Shapes" or "Sounds" items. So, for example, under Unix you could create a
221directory ~/.alephone/maps and place all map files you downloaded in there.
222
223Most 3rd-party maps for Marathon 2 and Marathon Infinity you can find on the
224internet, for example in the Marathon HyperArchive
225
226  http://www.marathon.org/hyperarchive/
227
228do in principle work out-of-the box with Aleph One/SDL. I said "in principle",
229because these maps are usually stored in BinHex (.hqx) and/or StuffIt (.sit)
230format, which is difficult to unpack on non-Mac systems.
231
232Fortunately, for Linux there is a beta version of "StuffIt Expander" which
233can handle such files:
234
235  http://www.aladdinsys.com/expander/expander_linux.html
236
237(when unpacking a ".sit.hqx" archive, you will need to run "unstuff" twice,
238first for de-BinHexing and a second time for unstuffing).
239
240The other problem with Marathon map files is that terminal pictures,
241chapter screens and chapter screen sounds are stored in the resource fork
242on the Mac. If a map doesn't have a resource fork with these things (most
243Net maps don't), it is sufficient to just copy the entire map file over
244to a place where Aleph One can find it (see above).
245
246If the map does have a resource fork (most single-player maps do), you
247have three options:
248 a) Extract the data and resource forks into separate files, as I did with
249    the map file in the installation instructions above. If the file
250    containing the data fork has the name "foo", the resource file must be
251    called "foo.rsrc" or "foo.resource" and kept in the same directory as
252    the data file. Splitting files into data and resource forks is easy
253    to do when copying unpacked files from Mac CD-ROMs (see above) or when
254    unpacking downloaded map files under MacOS with my Basilisk II Mac
255    emulator (copy the unpacked map to the external file system where the
256    resource fork will be stored in a ".rsrc" directory).
257 b) Convert the dual-forked Mac map file into a single "AppleSingle" encoded
258    file. This is the preferred option because it will combine the data and
259    resource forks into a single file which is easier to move around than
260    two separate files. The "tools" directory of the Aleph One/SDL source
261    archive contains two utilities for handling AppleSingle files.
262 c) Convert the dual-forked Mac map file into a single "MacBinary II" encoded
263    file. This will also leave you with a single map file. The Linux "unstuff"
264    program will produce MacBinary files when giving it the "-m=auto" option.
265
266The shape and sound files don't require special treatment to work under
267Aleph One/SDL. Some shape files, however, come in the form of a "patcher"
268application that only runs under MacOS. Such files cannot be used with
269Aleph One/SDL.
270
271
272Map installation for dummies under Linux
273----------------------------------------
274
275First, download and install the "StuffIt Expander" beta for Linux:
276
277  http://www.aladdinsys.com/expander/expander_linux.html
278
279Now, suppose that you downloaded a file "CoolMap.sit.hqx" which contains
280a Marathon 2 or Infinity map.
281
2821. De-BinHex the file:
283
284     $ ls
285     CoolMap.sit.hqx
286     $ unstuff CoolMap.sit.hqx
287     Scanning CoolMap.sit.hqx
288     Expanding CoolMap.sit.hqx
289     /home/cbauer/downloads/CoolMap.sit ............
290     done
291     $ ls
292     CoolMap.sit   CoolMap.sit.hqx
293
2942. Unstuff the file:
295
296     $ unstuff -m=auto CoolMap.sit
297     Scanning CoolMap.sit
298     Expanding CoolMap.sit
299     /home/cbauer/downloads/Cool Map Folder/Cool Map ............
300     /home/cbauer/downloads/Cool Map Folder/Read Me
301     done
302     $ ls
303     'Cool Map Folder/'   CoolMap.sit  CoolMap.sit.hqx
304     $ cd "Cool Map Folder"
305     $ ls
306     'Cool Map'  'Read Me'
307
308   The "Read Me" file may be unreadable but you can ignore it.
309
3103. Copy the map file to the right place:
311
312     $ cp "Cool Map" ~/.alephone
313
3144. The map should now show up in the list when clicking on the "Map" item of
315   the Environment preferences section of Aleph One.
316
317
318Films and saved games
319---------------------
320
321Saved games and films are stored in
322
323Unix:
324  ~/.alephone/Saved Games
325 and
326  ~/.alephone/Recordings
327
328BeOS:
329  /boot/home/config/settings/Aleph One/Saved Games
330 and
331  /boot/home/config/settings/Aleph One/Recordings
332
333Windows:
334  Directories "Prefs\<user name>\Saved Games" and "Prefs\<user name>\Recordings"
335  in the Aleph One application directory
336
337If you want to restore games or replay films you have downloaded (or copied
338from another computer), you have to copy them into these directories or
339they won't show up when clicking on "Continue Saved Game" or "Replay Saved
340Film" on the main menu.
341
342
343Themes
344------
345
346Aleph One/SDL supports selectable user interface themes which determine the
347look of the game's dialog boxes (but not the title menu which is a fixed
348picture). The themes are stored in
349
350Unix:
351  /usr/local/share/AlephOne/Themes
352 and
353  ~/.alephone/Themes
354
355BeOS:
356  The "Themes" directory in the Aleph One application directory
357 and
358  /boot/home/config/settings/Aleph One/Themes
359
360Windows:
361  The "Themes" directory in the Aleph One application directory
362 and
363  The directory "Prefs\<user name>\Themes" in the Aleph One application
364  directory
365
366There is one subdirectory for each theme and you can install new themes by
367unpacking them into the "Themes" directory. Additional themes can be found
368on the Aleph One/SDL home page (see below).
369
370
371File compatibility
372------------------
373
374This section gives a summary of the cross-platform compatibility of the
375various data files used by Aleph One and the original Marathon games:
376
377  "Images" - on Aleph One/SDL this is a data file and not a resource file
378    as on the MacOS versions of Aleph One and Marathon, but the file format
379    is exactly the same, and compatible across all platforms supported by
380    Aleph One/SDL
381  "Shapes" - fully compatible across all versions of Aleph One/Marathon 2/
382    Marathon Infinity
383  "Sounds" - fully compatible across all versions of Aleph One/Marathon 2/
384    Marathon Infinity
385  Map files - maps without resource forks are fully compatible across all
386    versions of Aleph One/Marathon 2/Marathon Infinity; maps with resource
387    forks need to be in one of three formats:
388      a) data and resource forks in separate files, <name> and <name>.rsrc/
389         <name>.resources
390      b) an AppleSingle encoded file containing data and resource fork
391      c) a MacBinary II encoded file containing data and resource fork
392    All of these formats are fully compatible across all platforms supported
393    by Aleph One/SDL.
394  Saved games - fully compatible across all versions of Aleph One/
395    Marathon 2/Marathon Infinity (but the MacOS versions save a small picture
396    of the map at the current player's position in the resource fork of
397    saved games, which is not preserved or used by Aleph One/SDL)
398  Films - fully compatible across all versions of Aleph One/Marathon 2/
399    Marathon Infinity
400  "Aleph One Preferences" - platform-specific, not compatible with the MacOS
401    versions of Aleph One/Marathon nor across the platforms supported by
402    Aleph One/SDL
403  Themes - fully compatible across all versions of Aleph One/SDL; the MacOS
404    versions of Aleph One and Marathon don't support themes
405
406
407Marathon Markup Language (MML)
408------------------------------
409
410The Marathon Markup Language (MML) is a subset of the Extensible Markup
411Language (XML). MML scripts can be used to configure some aspects of
412Aleph One. These scripts are stored in
413
414Unix:
415  /usr/local/share/AlephOne/MML
416  /usr/local/share/AlephOne/Scripts
417 and
418  ~/.alephone/MML
419
420BeOS:
421  The "MML" and "Scripts" directories in the Aleph One application directory
422 and
423  /boot/home/config/settings/Aleph One/MML
424
425Windows:
426  The "MML" and "Scripts" directories in the Aleph One application directory
427 and
428  The directory "Prefs\<user name>\MML" in the Aleph One application
429  directory
430
431Upon startup, Aleph One reads and parses all scripts found in these
432directories, in alphabetical order. For a description of their contents and
433what you can do by writing your own MML scripts, please consult the file
434"docs/MML.html" that comes in the Aleph One/SDL distribution archive.
435
436
437Bug Reports
438-----------
439
440If you find a bug that's not already in the list above, please submit it
441using the bug database on SourceForge:
442
443  http://sourceforge.net/bugs/?group_id=1997
444
445
446Tips
447----
448
449You can start the game at any level by holding the Shift and Control keys
450while clicking on the "Begin New Game" button on the main menu.
451
452To activate the cheat codes, see the file "docs/Cheat_Codes" that is included
453in the Aleph One archive. But remember: Winners don't cheat and cheaters
454don't usually win! :-)
455
456If you're stuck in the game, there's an excellent walkthrough at
457
458  http://pinky.wtower.com/marathon/
459
460
461Troubleshooting
462---------------
463
464If the game runs very slowly, try running it in 8 bit mode. Under Linux,
465using XFree86 4.0 instead of 3.x may also greatly increase the speed. If you
466don't have hardware accelerated OpenGL, you should specify the "-g" argument
467to enable software rendering (unless you configured Aleph One with the
468"--disable-opengl" option). If Aleph One crashes or performs poorly when
469using OpenGL, disable the "Static Effect" option in the Graphics/OpenGL
470preferences menu.
471
472
473Support
474-------
475
476Aleph One is not officially supported by Bungie Software, so don't bother
477contacting them about it.
478
479The official Aleph One home page is at
480
481  http://source.bungie.org/
482
483My home page for the SDL port is at
484
485  http://alephone.cebix.net
486
487The Aleph One pages on SourceForge
488
489  http://www.sourceforge.net/projects/marathon/
490
491provide discussion forums, a database of bugs and feature requests and much
492more.
493
494If you have questions about Marathon in general, you should post them to
495the established marathon forums, such as alt.games.marathon.
496
497
498Happy carnage!
499Christian Bauer <www.cebix.net>
500