Aleph one Troubleshooting Guide

Aleph One Troubleshooting Guide

part of the Marathon Aleph One project (http://source.bungie.org/)

Created: August 24, 2003

Most recent update: August 24, 2003

Document Purpose

Aleph One is a work in progress, and bugs are inevitable. Though we recognize that all bugs should, of course, be fixed, we acknowledge the reality that it can often take quite a while for a given problem to be resolved. This document exists to fill the gap: to acknowledge known bugs and to provide workarounds where possible, so users can best enjoy Aleph One in the present.

Issues

I only have Mac OS 9.

----------

I'm sorry to hear that. We have not officially abandoned Mac OS 9 - indeed, our intention is to continue to support it for some time - but there has not been a Mac OS 9 release build since March 23, 2003. This leaves Mac OS 9 players without the star network protocol, without player motion prediction, without netscripts, and without various other enhancements. We hope to have another Mac OS 9 release soon, but until then, Aleph One will be principally useful to you for single-player games or LAN games (see the Networking User's Guide for information on forcing newer Aleph One builds to use the old ring protocol, a requirement for interoperability with the March 23 Mac OS 9 build).

Aleph One won't start up. I get an alert or command-line message complaining about an XML parsing error.

----------

The most common cause of this behavior is having an old-style Preferences file. A1 migrated from a binary Preferences format to an XML-based format some time ago, but unfortunately did not preserve the ability to read the old format. Delete your "Aleph One Preferences" file (use your OS's file-search capabilities if you're not sure where to find it) and try again.

Aleph One won't start up. I get an alert or command-line message about "Map", "Shapes", "Sounds", and "Images".

----------

The answer to this is probably different depending on whether you're using a Mac-style (Mac OS 9, Mac OS X Carbon) build of A1 or an SDL-style (Windows, Linux, NetBSD, Dreamcast, Mac OS X SDL) build.

SDL-style builds still search for files with those exact names in the directory with A1 (unless custom MML, as with M1A1, tells it to look for other specific names). Be sure that you have the appropriate files and that they are proper SDL-style files (see INSTALL. or make sure you downloaded SDL-style files). Note that Mac OS X SDL can read both SDL-style and Mac-style files, though it finds them the "SDL way" (by name).

Mac-style builds are willing to start up as long as there's an Images file (found by name in A1's directory) and a Map file, a Shapes file, and a Sounds file *somewhere* in A1's directory structure. Mac-style A1's don't care what the names of these latter files are, but they do require that they have the correct Mac OS "type code" to be found. Consider using something like the Macintosh file typing tools (found at http://source.bungie.org/) to make sure your files are properly typed.

Special note: we have received reports that unStuffing Marathon-related files with StuffIt Expander v7.x may cause you to receive this error. Using version 8.0 should help.

I'm having trouble getting a major 3rd-party scenario (EVIL, Red, M1A1, etc.) to work right.

----------

Due to these scenarios' typical reliance on MML, and the way MML currently works, it's generally best to have a completely separate A1 installation for each major scenario. That is, *avoid* dropping the M1A1 files into your A1 structure alongside Marathon Infinity etc. Also, if you're using a Mac, make sure the files have the correct Mac OS "type code". Use the Macintosh file typing tools (found at http://source.bungie.org/) to set the type codes.

There should not be a problem having M2, Marathon Infinity, and add-ons for both all crammed into one big directory tree. As long as there's no MML involved (and there isn't, with these standard scenarios) you can dump them all in together and sort them out via Environment Preferences.

I only have the Marathon Infinity demo (or Marathon 2 demo, or Marathon 2). Will that be a problem in Internet games?

----------

It depends on the game. Marathon 2 is missing a few graphics sets present in Marathon Infinity; each demo is missing several sets of graphics present in the corresponding full version. Levels that use these missing graphics will most likely cause your A1 to quit out, giving an error about an undefined collection. Most Internet players currently assume Marathon Infinity full version unless otherwise specified, since it can play any Marathon 2 or Marathon Infinity level without worries. If you don't have the full Marathon Infinity, it's probably wise to alert the gatherer of this and see if you can work something out.

Aleph One doesn't seem to respect my settings for "Auto-recenter" or "Auto-switch weapons" in network games.

----------

This is intentional; SDL builds of A1 warn you about it specifically. We hope to lift this restriction in the future, but until then, forcing Auto-recenter and Auto-switch weapons on (the way they always were in the original games) is the only way to make sure netgames hold together consistently.

Aleph One doesn't seem to be recording films of my single-player games.

----------

If you are using non-default settings for Auto-recenter or Auto-switch weapons (i.e. either one of those disabled), A1 currently will not record a film of your game. This is intentional; SDL builds of A1 warn you about it specifically. We hope to lift this restriction in the future, but until then, making sure all films have the same idea of the settings for these features is the only way to make sure they consistently play back properly.

Aleph One doesn't play back my old M1/M2/Marathon Infinity

...