Difference between revisions of "The Ur-Quan Masters Technical FAQ"

From Ultronomicon
Jump to navigation Jump to search
m (→‎Where do I get the game?: "with some own" -> "with some of his own")
m (Spelling)
 
(94 intermediate revisions by 45 users not shown)
Line 21: Line 21:
 
For MacOS X, [[User:Nic|Nic]] has developer builds with some of his own patches [http://www.submedia.net/uqm/ here].
 
For MacOS X, [[User:Nic|Nic]] has developer builds with some of his own patches [http://www.submedia.net/uqm/ here].
  
If you frequently build the game yourself from the recent source, you may want to get your files from anonymous CVS. If you're using a command-line CVS client, this is what you type:
+
If you frequently build the game yourself from the recent source, you may want to get your files from SVN. If you're using a command-line SVN client, this is what you type:
:<code>cvs -d:pserver:anonymous:@cvs.sourceforge.net:/cvsroot/sc2 login</code>
+
:<code>svn co https://sc2.svn.sourceforge.net/svnroot/sc2/trunk sc2</code>
:followed by
 
:<code>cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/sc2 co sc2</code>
 
  
Then, read the INSTALL file, and make sure you have the necessary libraries it refers to.
+
Once the SVN checkout is complete (about 200 MB), read the INSTALL file, and make sure you have the necessary libraries it refers to.
  
 
For compiling the source under Windows there's a Microsoft Developer Studio project file in src/msvc++/. For Unix (including Darwin), follow the instructions in doc/users/unixinstall. For MinGW, there's a file INSTALL.mingw in the top dir with some additional information.
 
For compiling the source under Windows there's a Microsoft Developer Studio project file in src/msvc++/. For Unix (including Darwin), follow the instructions in doc/users/unixinstall. For MinGW, there's a file INSTALL.mingw in the top dir with some additional information.
  
 
===How do I install the game on Windows without an internet connection?===
 
===How do I install the game on Windows without an internet connection?===
This is currently more complicated than necessary.
+
Download uqm-0.6.2-win32-installer.exe, uqm-0.6.0-content.uqm, and optionally uqm-0.6.0-voice.uqm and uqm-0.6.0-3domusic.uqm from [http://sc2.sourceforge.net/downloads.php http://sc2.sourceforge.net/downloads.php] on a machine where you do have an internet connection, and put them on a removable medium (CD-ROM, USB drive, etc). Then, on the machine where you want to install the game, start uqm-0.6.2-win32-installer.exe. Do not select any content packages that you haven't downloaded, and when the installer asks where to get the packages from, select the directory on your removable medium. The installer won't try to download any files from the internet then.
Download uqm-0.3-win32-installer.exe, uqm-0.3-content.zip, and optionally uqm-0.3-music.zip and uqm-0.3-3domusic.zip from [http://sc2.sourceforge.net/downloads.php http://sc2.sourceforge.net/downloads.php] on a machine where you do have an internet connection, and burn them to a CD-ROM. Then, on the machine where you want to install the game, start uqm-0.3-win32-installer.exe, but do not select the additional content zip files.
 
  
After the installer is done, copy uqm-0.3-music.zip and uqm-0.3-3domusic.zip (if you downloaded those) to the content/packages directory in the location where you told the installer to put the game.
+
Note: Some defective browsers attach the extension ".zip" to your downloaded files (so you'll end up with files like "uqm-0.6.0-content.uqm.zip"). In this case you'll have to rename the files back, so that the installer will recognise them, lest it will try to download them itself.
 
 
'''Important: do NOT unzip the content files. The game uses them zipped.'''
 
  
 +
===How do I use the 3DO intro and victory movies in the game?===
  
===How do I use the 3DO intro and victory movies in the game?===
+
[[Toys For Bob]] doesn't have the copyright to these files and so we can't distribute them. But if you own the [[3DO]] [[Star Control II]] CD, you can extract them yourself and use them in the game. To do this, you first need to make a .iso file of the CD-ROM (however you will not be able to mount it normally, as in on a Mac or elsewhere), and then run a program called  unCD-ROM to unpack the files from it, which can be found [http://troosh.pp.ru/3do/unCD-ROM14.zip here] (local mirror [http://uqm.stack.nl/files/unCD-ROM/unCD-ROM14.zip here]). It includes a .exe file for Windows and the source code, which will also works on Linux. Just run it on the new .iso file. More detailed instructions can be found [http://www.cahudson.freeserve.co.uk/docs/richs3docdexrtractionguidev2.htm here]. An (untried) alternative for Windows user, CompilFS, which looks a bit more user friendly, can be found [http://altmer.arts-union.ru/3DO/downloads/CompilFS.rar here]. Linux users can also add direct support for the 3DO file system with a kernel module, which can be found [http://www.stack.nl/~svdb/operafs/ here].
[[Toys For Bob]] doesn't have the copyright to these files and so we can't distribute them. But if you own the [[3DO]] [[Star Control II]] CD, you can extract them yourself and use them in the game. To do this, you first need to make a .iso file of the CD-ROM, and then run a program called  unCD-ROM, which can be found [http://troosh.pp.ru/3do/unCD-ROM14.zip here]. It includes a .exe file for Windows and the source code, which will also works on Linux. Just run it on the new .iso file. More detailed instructions can be found [http://www.cahudson.freeserve.co.uk/docs/richs3docdexrtractionguidev2.htm here].
 
  
In the extracted "duckart" directory you will find the videos. The files with extensions .duk, .frm, .hdr, and .tbl go together. At the moment only the intro and victory images can be used in [[The Ur-Quan Masters]]. To do this you create a directory "slides" in the content directory. In that "slides" directory you create an "intro" directory where you put the intro.duk, intro.frm, intro.hdr and intro.tbl files from the 3DO CD-ROM. In the "slides" directory you also create a directory "ending" where you put the victory.duk, victory.frm, victory.hdr and victory.tbl files.
+
In the extracted duckart/ directory you will find the videos. You now need to create a uqm-0.7.0-3dovideo.uqm package:
  
If you haven't installed any add-on packages, your content directory structure should now look like this:
+
* Create a directory named 3dovideo/ with subdirectories of intro/, ending/, and spins/.
 +
* Retrieve [http://sourceforge.net/p/sc2/uqm/ci/master/tree/sc2/content/addons/3dovideo/3dovideo.rmp 3dovideo.rmp] into the 3dovideo/ directory.
 +
* Copy intro* into the intro/ subfolder, victory* into the ending/ subfolder, and ship* into the spins/ subfolder. (It may be the case only .duk and .aif files are required, but it is okay to copy it all, also the ship or spin files may not be used but are referenced by the rmp and so should be copied.)
 +
* Zip the 3dovideo directory recursively, retaining the 3dovideo parent path, into a file uqm-0.7.0-3dovideo.uqm. This must be done with compression 0 (store). The resulting .uqm (renamed .zip) file will look like this inside:
  
  content/packages/uqm-0.3-content.zip
+
  Length    Date  Time    Name
  content/packages/uqm-0.3-3domusic.zip        (optional)
+
  --------    ----  ----    ----
  content/packages/uqm-0.3-voice.zip          (optional)
+
        0 01-04-14 13:56  3dovideo/
content/slides/ending/victory.duk
+
    3237 01-04-14 13:45  3dovideo/3dovideo.rmp
  content/slides/ending/victory.frm
+
        0 01-04-14 13:23  3dovideo/ending/
  content/slides/ending/victory.hdr
+
57853696  01-04-14 13:20  3dovideo/ending/victory.duk
  content/slides/ending/victory.tbl
+
    13604 01-04-14 13:20  3dovideo/ending/victory.frm
  content/slides/intro/intro.duk
+
      48 01-04-14 13:20  3dovideo/ending/victory.hdr
  content/slides/intro/intro.frm
+
    4096 01-04-14 13:20  3dovideo/ending/victory.tbl
  content/slides/intro/intro.hdr
+
        0 01-04-14 13:39  3dovideo/intro/
  content/slides/intro/intro.tbl
+
38723612  01-04-14 13:20  3dovideo/intro/intro.duk
  content/version
+
    9144 01-04-14 13:20  3dovideo/intro/intro.frm
 +
      48 01-04-14 13:20  3dovideo/intro/intro.hdr
 +
    4096 01-04-14 13:20  3dovideo/intro/intro.tbl
 +
        0  01-04-14 13:50  3dovideo/spins/
 +
  100448 01-04-14 13:49  3dovideo/spins/SHIP00.AIF
 +
  2091956  01-04-14 13:49  3dovideo/spins/SHIP00.DUK
 +
      564  01-04-14 13:49  3dovideo/spins/SHIP00.FRM
 +
      48  01-04-14 13:49  3dovideo/spins/SHIP00.HDR
 +
  (and so on)
  
Now just start the game normally and wait a few seconds and the intro movie will show up. You'll see the ending when you complete the game.
+
* Place the new uqm-0.7.0-3dovideo.uqm file into the content/addons/ directory.
 +
* Start The Ur-Quan Masters, go into Setup, Cutscenes, and change the setting to Movie. Exit completely, start The Ur-Quan Masters again, and start a new game. The introduction should play a voice-acted video instead of showing pictures, and the ending video should play if you successfully complete the game.
  
 
==Running the game==
 
==Running the game==
Line 65: Line 72:
  
 
===When trying to start the game, I get a DOS box flashing on my screen, and nothing else (on Windows)===
 
===When trying to start the game, I get a DOS box flashing on my screen, and nothing else (on Windows)===
The DOS box shows some debug information while the game is running. Right click on the icon you used to start the game, chose 'preferences', and select "". Now the box will remain on the screen and you can see what the actual problem is. Look elsewhere in this FAQ for specific information on your problem.
+
The DOS box shows some debug information while the game is running. Right click on the icon you used to start the game, choose 'properties', and add '--logfile logfile.txt' as the first argument in the "Target" field. For example:  <i>"H:\Program Files\The Ur-Quan Masters\uqm.exe" <b>--logfile logfile.txt</b> --res 640x480 --bpp 32 --opengl --scale=bilinear --scroll 3do --audioquality high --addon remix</i> <br><br>In this example, the window will open and close quickly but will put the output into "H:\Program Files\The Ur-Quan Masters\logfile.txt" for later examination via Notepad.  Often the window closes quickly due to an improper argument, i.e. "--bpp32" versus "--bpp 32". Look elsewhere in this FAQ for specific information on your problem.
  
 
+
===The game runs too slowly. What can I do?===
===When trying to start the game, a message "Kernel failed to load!" appears===
 
===When trying to start the game, I get a message "Error: Premature end of central directory."===
 
This happens when the content .zip file file is corrupt. Unfortunately, the current Windows installer doesn't detect when the download of that file was interrupted. Search for the file uqm-0.3-content.zip. It should be 12554418 bytes in length. If it is not, replace that file with a fresh copy from [http://sc2.sourceforge.net/downloads.php the UQM download page].
 
 
 
===The game runs too slow. What can I do?===
 
 
If you're running on a system barely faster than the [[The_Ur-Quan_Masters_Project_FAQ#What are the system requirements?|minimum system requirements]], you may need to disable some eye candy.
 
If you're running on a system barely faster than the [[The_Ur-Quan_Masters_Project_FAQ#What are the system requirements?|minimum system requirements]], you may need to disable some eye candy.
 
*try playing in 320x240 mode, full screen, with no scaling.
 
*try playing in 320x240 mode, full screen, with no scaling.
Line 79: Line 81:
 
If you are running [[The Ur-Quan Masters]] on a modern system, and are still having a slow game experience, try the following:
 
If you are running [[The Ur-Quan Masters]] on a modern system, and are still having a slow game experience, try the following:
 
*(on Windows) make sure your video and sound drivers and DirectX are up-to-date.
 
*(on Windows) make sure your video and sound drivers and DirectX are up-to-date.
*(on Windows) make sure your PC isn't infected with spyware or similar programs. Good free programs to remove these are [http://www.lavasoftusa.com/software/adaware/ Adware Personal] and [http://spybot.info/ Spybot-Search&Destroy].
+
*(on Windows) make sure your PC isn't infected with spyware or similar programs. Good free programs to remove these are [http://www.lavasoftusa.com/software/adaware/ Ad-Aware Personal] and [http://spybot.info/ Spybot-Search&Destroy].
 
*close other programs when you are running the game. This includes programs that are running in the system tray. Some of these programs eat up a lot of resources.
 
*close other programs when you are running the game. This includes programs that are running in the system tray. Some of these programs eat up a lot of resources.
 
*(on Windows) when running the game press <nowiki><CTRL>-<ALT>-<DEL></nowiki>, and select "task manager". There increase the priority of The Ur-Quan Masters.
 
*(on Windows) when running the game press <nowiki><CTRL>-<ALT>-<DEL></nowiki>, and select "task manager". There increase the priority of The Ur-Quan Masters.
Line 86: Line 88:
  
 
===How do I change my settings?===
 
===How do I change my settings?===
In the future, you will be able to change your settings from the in-game setup menu.
+
The settings can nowadays be changed from within the in-game setup menu.
For now, the easiest way to do this is by using a launcher program. There are a few to choose from:
 
*MarkVera's [http://www.spacesynth.net/markvera/uqm-loader/uqmloader-1.1.zip UQM loader] (recommended for Windows)
 
*[[User:Nic|Nic]]'s [http://www.submedia.net/uqm/ java launcher] (any platform, cannot handle add-ons)
 
Note that none of these programs are supported by the [[Ur-Quan Masters developers]].
 
 
 
You can do without these launcher programs by specifying specific parameters to the command that starts UQM.
 
In Windows, this means doing the following:
 
*right-click on the icon you use to start UQM, and select preferences
 
*In the command box, where it says something like ''"c:\Program Files\The Ur-Quan Masters\uqm.exe"'' add your parameters '''after the quotes'''. If you for instance want to use to full-screen mode, you change that line to ''"c:\Program Files\The Ur-Quan Masters\uqm.exe" --fullscreen''.
 
Look at the manual.txt file that accompanies the game for information on the possible switches.
 
  
 +
===How do I use add-on packages?===
  
===How do I use add-on packages?===
+
There is a main content package located in content/packages/uqm-0.7.0-content.uqm. However add-on content packages such as uqm-0.7.0-voice.uqm and uqm-0.7.0-3domusic.uqm (and a user-compiled uqm-0.7.0-3dovideo.uqm) should be placed in the content/addons/ directory instead. In all cases the .uqm files are actually .zip files, renamed so they won't be accidentally unpacked.
Inside the directory where the content is installed, in the content/packages/ directory, there is a directory 'addons/'. In this directory, you can create new directories with .zip files to be used in addition to the standard content .zip files.
 
  
When you specify the command-line option '--addon &lt;addon&gt;', the .zip files inside the directory content/packages/addons/&lt;addon&gt; will be included
+
When you specify the command-line option '--addon &lt;addon&gt;', the .uqm files inside the directory content/addons/&lt;addon&gt; will be included in the game. '--addon' may be specified more than once to enable multiple add-ons.
in the game. '--addon' may be specified more than once to enable multiple add-ons.
 
  
 
Instead of specifying command-line options yourself, you can use a launcher program.
 
Instead of specifying command-line options yourself, you can use a launcher program.
 +
 +
For Mac OSX, assuming you installed the game in Applications:
 +
Open The Terminal (It's in the "Utilities" folder under "Applications")
 +
    * cd /Applications/The\ Ur-Quan\ Masters.app/Contents/MacOS
 +
    * ./The\ Ur-Quan\ Masters -n ../Resources/content --addon ADDONNAME
  
 
See [[#How do I change my settings?|How do I change my settings]] and [[Content Management]] for more information.
 
See [[#How do I change my settings?|How do I change my settings]] and [[Content Management]] for more information.
 
===How do I change my keys?===
 
You'll need to edit the file "keys.cfg" in the settings directory (see [[#Where are my settings stored?|Where are my settings stored?]]).
 
More information is contained in that file itself. Lines starting with "#" are ignored.
 
 
  
 
===How do I use a joystick or game pad?===
 
===How do I use a joystick or game pad?===
You'll need to edit the file "keys.cfg" in the settings directory (see [[#Where are my settings stored?|Where are my settings stored?]]).
+
There are joystick profiles for both the primary and the secondary joystick that can selected in the keys config menu within The Ur-Quan Masters.
 +
If you want to modify these profiles, you'll need to manually edit the file "keys.cfg" in the settings directory (see [[#Where are my settings stored?|Where are my settings stored?]]).
 
More information is contained in that file itself. Lines starting with "#" are ignored.
 
More information is contained in that file itself. Lines starting with "#" are ignored.
  
 +
An added note -- there's a known issue in that starting UQM *without* the controller plugged in will scramble or obliterate the joystick configurations.  You can get the default config back by going up one directory from the savegames (which should be linked in with your Start Menu when using Windows) and deleting keys.cfg.  A fresh copy will be created the next time you start.
  
 
===When I press multiple keys at the same time, some keys won't be recognised===
 
===When I press multiple keys at the same time, some keys won't be recognised===
This is a hardware problem with many keyboards. [http://www.dribin.org/dave/keyboard/one_html/ this page] describes what is going on technically.
+
This is a hardware problem with many keyboards.
  
 
To get around the problem, you could try using another keyboard. Unfortunately, most modern keyboards have problems like this. The exact key combinations that aren't accepted vary per keyboard though.
 
To get around the problem, you could try using another keyboard. Unfortunately, most modern keyboards have problems like this. The exact key combinations that aren't accepted vary per keyboard though.
  
You can also change the keys that give problems. Keys that are usually ok to use are keys that are meant to be used in combination with other keys, such as SHIFT, CTRL, and ALT. For the rest, you'll just have to experiment.
+
Sometimes toggling the num lock or caps lock will resolve the conflict. You can also change the keys that give problems. Keys that are usually ok to use are keys that are meant to be used in combination with other keys, such as SHIFT, CTRL, and ALT. For the rest, you'll just have to experiment. See [[#How do I change my keys?|here]] for information on changing your keys.
See [[#How do I change my keys?|here]] for information on changing your keys.
 
  
 
Another possibility is to use a joystick or game pad. (see [[#How do I use a joystick or game pad?|How do I use a joystick or game pad?]]).
 
Another possibility is to use a joystick or game pad. (see [[#How do I use a joystick or game pad?|How do I use a joystick or game pad?]]).
 
  
 
===I keep getting a popup regarding sticky keys. How do I get rid of it?===
 
===I keep getting a popup regarding sticky keys. How do I get rid of it?===
 
This is a message from Windows, which wonders why you keep pressing that shift key all the time. The next time it comes up, click "settings", and then uncheck "use shortcut".
 
This is a message from Windows, which wonders why you keep pressing that shift key all the time. The next time it comes up, click "settings", and then uncheck "use shortcut".
 
  
 
===How do I exit the game?===
 
===How do I exit the game?===
Press '''F10''', and then confirm. '''F12''' works as an emergency shutdown, but settings won't be saved.
+
Press '''F10''', and then confirm. On MacOS X 10.3 and above, the new Expos&eacute; features intercept '''F10''', so use '''Option-F10''' to quit on such systems (you may also disable the F10 intercept in System Preferences
On certain Apple iBook and Powerbook models, '''F12''' is the "eject CD" key, so on the Mac port of the game, the key has been changed to '''F11'''.  However, the new Expos&eacute; features in Mac OS X 10.3 and above intercept '''F10''' and '''F11''', so use '''Option-F10''' and '''Option-F11''' to quit/abort on such systems.  See also [[#How do I change my keys?|How do I change my keys?]]
+
&#8594; Dashboard & Expos&eacute;.) See also [[#How do I change my keys?|How do I change my keys?]]
  
 
===How do I pause the game?===
 
===How do I pause the game?===
Press F1. It works for unpausing too.
+
Press F1 or the Pause key. It works for unpausing too. See also [[#How do I change my keys?|How do I change my keys?]]
 +
 
 +
===Where do I find out more information about Network Play?===
 +
Our [[Netplay_howto|Netplay How-To guide]] describes how to play [[SuperMelee]] in [[The Ur-Quan Masters]] over a network.
  
 +
==Building the game from source==
  
 +
===Why does the game complain that it can't find my content?===
 +
Possibly you have compiled without zlib support. UQM will not be able to work directly with .uqm files then, but only with unzipped content files.
  
 
==Various==
 
==Various==
Line 149: Line 145:
 
This is usually in one of the following locations:
 
This is usually in one of the following locations:
  
; Windows 95, 98, SE without separate users : <code>"C:\Windows\Application Data\"</code>
+
; Windows 95/98/98SE without separate users : <code>"C:\Windows\Application Data\"</code>
 +
 
 +
; Windows 95/98/98SE with separate users : <code>"C:\Windows\Profiles\YourName\Application Data\"</code>
  
; Windows 95/98/SE with separate users : <code>"C:\Windows\Profiles\YourName\Application Data\"</code>
+
; Windows NT/2000/XP : <code>"C:\Documents and Settings\YourName\Application Data\"</code>
  
; Windows NT/2k/XP : <code>"C:\Documents and Settings\YourName\Application Data\"</code>
+
; Windows Vista/7 : <code>"C:\Users\YourName\AppData\Roaming\"</code>
  
On Unix systems ''(including Darwin/Mac OS X)'' the settings are stored in <code>"~/.uqm/"</code>.
+
; Unix systems (including Darwin/Mac OS X) : <code>"~/.uqm/"</code>
  
 
The <code>"Application Data"</code> folder may be hidden. You can tell Windows to display hidden files and folders in the Folder Options dialog, which you can find in the Tools menu of any folder window.
 
The <code>"Application Data"</code> folder may be hidden. You can tell Windows to display hidden files and folders in the Folder Options dialog, which you can find in the Tools menu of any folder window.
Line 166: Line 164:
  
 
===How do I report a bug?===
 
===How do I report a bug?===
First, make sure you are either running the most recent official release (0.3 at the time of writing), or a recent version from CVS.
+
First, make sure you are either running the most recent official release (currently {{uqmversion}}), or a recent version from SVN.
If your copy is up to date, then look at [[#Specific bugs and not-quite bugs|Specific bugs and not-quite bugs]]. If your bug is not there, then look for it in the bug database at http://uqm.stack.nl/cgi-bin/bugs/index.cgi. If the bug is already there, then see if you have any additional information that may help the developers fix this bug, and if so, add it to the existing bug report.
+
If your copy is up to date, then look at [[#Specific bugs and not-quite bugs|Specific bugs and not-quite bugs]]. If your bug is not there, then look for it in the [http://uqm.stack.nl/cgi-bin/bugs/index.cgi bug database]. If the bug is already there, then see if you have any additional information that may help the developers fix this bug, and if so, add it to the existing bug report.
 
If the bug hasn't been reported, then make a new report. Include as much information as as you can that may be helpful in solving the bug. In particular, it would be of much help if you can tell how to reproduce the bug. If this is your first bug report, please first read the guidelines are given [http://uqm.stack.nl/cgi-bin/bugs/bugwritinghelp.html here].
 
If the bug hasn't been reported, then make a new report. Include as much information as as you can that may be helpful in solving the bug. In particular, it would be of much help if you can tell how to reproduce the bug. If this is your first bug report, please first read the guidelines are given [http://uqm.stack.nl/cgi-bin/bugs/bugwritinghelp.html here].
 +
 +
===I don't want to make a Bugzilla account. Is it ok to let you know about my bug in another way?===
 +
Not really. Look at it from the side of the developers. First of all, when they receive a bug report through any other means, they have the choice of either fixing the bug immediately, putting it in [http://uqm.stack.nl/cgi-bin/bugs/ the Bugzilla database] themselves, or trying to remember it for later. As you're likely to catch them while they're in the middle of something, or just don't have the time that instant, it's not unlikely that your report will be lost.
 +
 +
Second, bug reports sent through other means rarely contain complete information. The Bugzilla forms have fields for things like UQM version and operating system, that may be necessary for solving the problem. A bug reported through other means would often require additional communication just to get all the facts.
 +
 +
Third, the person you would be contacting may not be the one who would normally fix such a bug. The developers each have their specialties. Bugs reported in the Bugzilla database will have a default assignee, and will be seen by all.
 +
 +
Now you may be thinking "I'm doing you a favour, take it or leave it.", but if you like the game and appreciate the work done by the developers, isn't it worth spending a few minutes to help them make the game better? Don't forget they are all volunteers, doing this in their spare time.
 +
 +
But if you enjoy their work ''just enough'' to report a bug through mail, the [http://uqm.stack.nl/cgi-bin/yabb/YaBB.pl UQM forum], or IRC, but not enough to create a Bugzilla account, they'd rather hear about a bug through those means, than not at all.
 +
 +
'''See also:''' [[#Where_can_I_go_for_more_technical_help.3F|Where can I go for more technical help?]].
 +
 +
===Where can I go for more technical help?===
 +
The most appropriate place to ask for help on technical problems is the [http://uqm.stack.nl/cgi-bin/yabb/YaBB.pl?board=Techissues technical issues board] on the [http://uqm.stack.nl/cgi-bin/yabb/YaBB.pl UQM forum].
 +
 +
There's also the [irc://irc.freenode.org/sc2 #sc2 IRC channel] on OPN. You may have to be patient though, as most people that are present in the channel don't actually pay attention to it all the time. It is however the place where the developers hang out, and if you're interested in game internals, this is a good place to ask.
 +
 +
There's also the [http://sourceforge.net/mail/?group_id=59452 sc2-devel mailing list] for development questions. It's hardly used anymore these days, but when it is, people still read it.
 +
 +
Do not mail the developers directly with technical questions.
 +
*a question you ask publicly, along with any answers may help other people too
 +
*you'll reach more people by using the forums or mailing list, so your question will usually be answered sooner
 +
*the developers frequently read the board, and respond to questions there
 +
 +
'''See also:''' [[#I_don.27t_want_to_make_a_Bugzilla_account._Is_it_ok_to_let_you_know_about_my_bug_in_another_way.3F|I don't want to make a Bugzilla account. Is it ok to let you know about my bug in another way?]]
  
 
==Specific bugs and not-quite bugs==
 
==Specific bugs and not-quite bugs==
Line 174: Line 199:
 
===The game does not behave as I expected===
 
===The game does not behave as I expected===
 
Gameplay bugs are listed in the [[Star Control II Gameplay FAQ]].
 
Gameplay bugs are listed in the [[Star Control II Gameplay FAQ]].
 +
  
  
 
[[Category:FAQs]]
 
[[Category:FAQs]]

Latest revision as of 06:31, 4 January 2014

This page is guaranteed to be spoiler free. It is safe for you to read this page even if you have not completed playing The Ur-Quan Masters. Links you follow from this page do not share this guarantee unless they also include this text.


This is the list of frequently asked questions (with answers) about technical issues regarding The Ur-Quan Masters. For gameplay questions or questions about the The Ur-Quan Masters project, check our other FAQs.


If you have any further questions, you can ask them on the technical issues board.

If you think you have found a bug, please report it in the Bugzilla database.



Installing the game[edit]

Where do I get the game?[edit]

You can find the latest official release on http://sc2.sourceforge.net/downloads.php.

You can find source snapshots, content updates, and precompiled Windows binaries for the most recent developers version on http://uqm.stack.nl/files/snapshots.

For MacOS X, Nic has developer builds with some of his own patches here.

If you frequently build the game yourself from the recent source, you may want to get your files from SVN. If you're using a command-line SVN client, this is what you type:

svn co https://sc2.svn.sourceforge.net/svnroot/sc2/trunk sc2

Once the SVN checkout is complete (about 200 MB), read the INSTALL file, and make sure you have the necessary libraries it refers to.

For compiling the source under Windows there's a Microsoft Developer Studio project file in src/msvc++/. For Unix (including Darwin), follow the instructions in doc/users/unixinstall. For MinGW, there's a file INSTALL.mingw in the top dir with some additional information.

How do I install the game on Windows without an internet connection?[edit]

Download uqm-0.6.2-win32-installer.exe, uqm-0.6.0-content.uqm, and optionally uqm-0.6.0-voice.uqm and uqm-0.6.0-3domusic.uqm from http://sc2.sourceforge.net/downloads.php on a machine where you do have an internet connection, and put them on a removable medium (CD-ROM, USB drive, etc). Then, on the machine where you want to install the game, start uqm-0.6.2-win32-installer.exe. Do not select any content packages that you haven't downloaded, and when the installer asks where to get the packages from, select the directory on your removable medium. The installer won't try to download any files from the internet then.

Note: Some defective browsers attach the extension ".zip" to your downloaded files (so you'll end up with files like "uqm-0.6.0-content.uqm.zip"). In this case you'll have to rename the files back, so that the installer will recognise them, lest it will try to download them itself.

How do I use the 3DO intro and victory movies in the game?[edit]

Toys For Bob doesn't have the copyright to these files and so we can't distribute them. But if you own the 3DO Star Control II CD, you can extract them yourself and use them in the game. To do this, you first need to make a .iso file of the CD-ROM (however you will not be able to mount it normally, as in on a Mac or elsewhere), and then run a program called unCD-ROM to unpack the files from it, which can be found here (local mirror here). It includes a .exe file for Windows and the source code, which will also works on Linux. Just run it on the new .iso file. More detailed instructions can be found here. An (untried) alternative for Windows user, CompilFS, which looks a bit more user friendly, can be found here. Linux users can also add direct support for the 3DO file system with a kernel module, which can be found here.

In the extracted duckart/ directory you will find the videos. You now need to create a uqm-0.7.0-3dovideo.uqm package:

  • Create a directory named 3dovideo/ with subdirectories of intro/, ending/, and spins/.
  • Retrieve 3dovideo.rmp into the 3dovideo/ directory.
  • Copy intro* into the intro/ subfolder, victory* into the ending/ subfolder, and ship* into the spins/ subfolder. (It may be the case only .duk and .aif files are required, but it is okay to copy it all, also the ship or spin files may not be used but are referenced by the rmp and so should be copied.)
  • Zip the 3dovideo directory recursively, retaining the 3dovideo parent path, into a file uqm-0.7.0-3dovideo.uqm. This must be done with compression 0 (store). The resulting .uqm (renamed .zip) file will look like this inside:
 Length     Date   Time    Name
--------    ----   ----    ----
       0  01-04-14 13:56   3dovideo/
    3237  01-04-14 13:45   3dovideo/3dovideo.rmp
       0  01-04-14 13:23   3dovideo/ending/
57853696  01-04-14 13:20   3dovideo/ending/victory.duk
   13604  01-04-14 13:20   3dovideo/ending/victory.frm
      48  01-04-14 13:20   3dovideo/ending/victory.hdr
    4096  01-04-14 13:20   3dovideo/ending/victory.tbl
       0  01-04-14 13:39   3dovideo/intro/
38723612  01-04-14 13:20   3dovideo/intro/intro.duk
    9144  01-04-14 13:20   3dovideo/intro/intro.frm
      48  01-04-14 13:20   3dovideo/intro/intro.hdr
    4096  01-04-14 13:20   3dovideo/intro/intro.tbl
       0  01-04-14 13:50   3dovideo/spins/
  100448  01-04-14 13:49   3dovideo/spins/SHIP00.AIF
 2091956  01-04-14 13:49   3dovideo/spins/SHIP00.DUK
     564  01-04-14 13:49   3dovideo/spins/SHIP00.FRM
      48  01-04-14 13:49   3dovideo/spins/SHIP00.HDR
 (and so on)
  • Place the new uqm-0.7.0-3dovideo.uqm file into the content/addons/ directory.
  • Start The Ur-Quan Masters, go into Setup, Cutscenes, and change the setting to Movie. Exit completely, start The Ur-Quan Masters again, and start a new game. The introduction should play a voice-acted video instead of showing pictures, and the ending video should play if you successfully complete the game.

Running the game[edit]

When trying to start the game, I get a DOS box flashing on my screen, and nothing else (on Windows)[edit]

The DOS box shows some debug information while the game is running. Right click on the icon you used to start the game, choose 'properties', and add '--logfile logfile.txt' as the first argument in the "Target" field. For example: "H:\Program Files\The Ur-Quan Masters\uqm.exe" --logfile logfile.txt --res 640x480 --bpp 32 --opengl --scale=bilinear --scroll 3do --audioquality high --addon remix

In this example, the window will open and close quickly but will put the output into "H:\Program Files\The Ur-Quan Masters\logfile.txt" for later examination via Notepad. Often the window closes quickly due to an improper argument, i.e. "--bpp32" versus "--bpp 32". Look elsewhere in this FAQ for specific information on your problem.

The game runs too slowly. What can I do?[edit]

If you're running on a system barely faster than the minimum system requirements, you may need to disable some eye candy.

  • try playing in 320x240 mode, full screen, with no scaling.
  • depending on your graphics card and driver, using OpenGL may slow down or speed up the game.
  • do not run in 24 bits per pixel mode. 16 is fine, 32 is fine, but 24 is an inefficient mode.

If you are running The Ur-Quan Masters on a modern system, and are still having a slow game experience, try the following:

  • (on Windows) make sure your video and sound drivers and DirectX are up-to-date.
  • (on Windows) make sure your PC isn't infected with spyware or similar programs. Good free programs to remove these are Ad-Aware Personal and Spybot-Search&Destroy.
  • close other programs when you are running the game. This includes programs that are running in the system tray. Some of these programs eat up a lot of resources.
  • (on Windows) when running the game press <CTRL>-<ALT>-<DEL>, and select "task manager". There increase the priority of The Ur-Quan Masters.

See also How do I change my settings?.

How do I change my settings?[edit]

The settings can nowadays be changed from within the in-game setup menu.

How do I use add-on packages?[edit]

There is a main content package located in content/packages/uqm-0.7.0-content.uqm. However add-on content packages such as uqm-0.7.0-voice.uqm and uqm-0.7.0-3domusic.uqm (and a user-compiled uqm-0.7.0-3dovideo.uqm) should be placed in the content/addons/ directory instead. In all cases the .uqm files are actually .zip files, renamed so they won't be accidentally unpacked.

When you specify the command-line option '--addon <addon>', the .uqm files inside the directory content/addons/<addon> will be included in the game. '--addon' may be specified more than once to enable multiple add-ons.

Instead of specifying command-line options yourself, you can use a launcher program.

For Mac OSX, assuming you installed the game in Applications: Open The Terminal (It's in the "Utilities" folder under "Applications")

   * cd /Applications/The\ Ur-Quan\ Masters.app/Contents/MacOS
   * ./The\ Ur-Quan\ Masters -n ../Resources/content --addon ADDONNAME

See How do I change my settings and Content Management for more information.

How do I use a joystick or game pad?[edit]

There are joystick profiles for both the primary and the secondary joystick that can selected in the keys config menu within The Ur-Quan Masters. If you want to modify these profiles, you'll need to manually edit the file "keys.cfg" in the settings directory (see Where are my settings stored?). More information is contained in that file itself. Lines starting with "#" are ignored.

An added note -- there's a known issue in that starting UQM *without* the controller plugged in will scramble or obliterate the joystick configurations. You can get the default config back by going up one directory from the savegames (which should be linked in with your Start Menu when using Windows) and deleting keys.cfg. A fresh copy will be created the next time you start.

When I press multiple keys at the same time, some keys won't be recognised[edit]

This is a hardware problem with many keyboards.

To get around the problem, you could try using another keyboard. Unfortunately, most modern keyboards have problems like this. The exact key combinations that aren't accepted vary per keyboard though.

Sometimes toggling the num lock or caps lock will resolve the conflict. You can also change the keys that give problems. Keys that are usually ok to use are keys that are meant to be used in combination with other keys, such as SHIFT, CTRL, and ALT. For the rest, you'll just have to experiment. See here for information on changing your keys.

Another possibility is to use a joystick or game pad. (see How do I use a joystick or game pad?).

I keep getting a popup regarding sticky keys. How do I get rid of it?[edit]

This is a message from Windows, which wonders why you keep pressing that shift key all the time. The next time it comes up, click "settings", and then uncheck "use shortcut".

How do I exit the game?[edit]

Press F10, and then confirm. On MacOS X 10.3 and above, the new Exposé features intercept F10, so use Option-F10 to quit on such systems (you may also disable the F10 intercept in System Preferences → Dashboard & Exposé.) See also How do I change my keys?

How do I pause the game?[edit]

Press F1 or the Pause key. It works for unpausing too. See also How do I change my keys?

Where do I find out more information about Network Play?[edit]

Our Netplay How-To guide describes how to play SuperMelee in The Ur-Quan Masters over a network.

Building the game from source[edit]

Why does the game complain that it can't find my content?[edit]

Possibly you have compiled without zlib support. UQM will not be able to work directly with .uqm files then, but only with unzipped content files.

Various[edit]

Where are my settings stored?[edit]

On Microsoft Windows systems the settings are stored in a folder named 'uqm' in the application data folder for the current user. This is usually in one of the following locations:

Windows 95/98/98SE without separate users
"C:\Windows\Application Data\"
Windows 95/98/98SE with separate users
"C:\Windows\Profiles\YourName\Application Data\"
Windows NT/2000/XP
"C:\Documents and Settings\YourName\Application Data\"
Windows Vista/7
"C:\Users\YourName\AppData\Roaming\"
Unix systems (including Darwin/Mac OS X)
"~/.uqm/"

The "Application Data" folder may be hidden. You can tell Windows to display hidden files and folders in the Folder Options dialog, which you can find in the Tools menu of any folder window. If you can't find the settings directory, use the Windows search functionality to look for a file "keys.cfg".

Where are my saved games stored?[edit]

Saved games are stored in a directory "save" inside the settings directory. See Where are my settings stored?.


How do I report a bug?[edit]

First, make sure you are either running the most recent official release (currently 0.7.0), or a recent version from SVN. If your copy is up to date, then look at Specific bugs and not-quite bugs. If your bug is not there, then look for it in the bug database. If the bug is already there, then see if you have any additional information that may help the developers fix this bug, and if so, add it to the existing bug report. If the bug hasn't been reported, then make a new report. Include as much information as as you can that may be helpful in solving the bug. In particular, it would be of much help if you can tell how to reproduce the bug. If this is your first bug report, please first read the guidelines are given here.

I don't want to make a Bugzilla account. Is it ok to let you know about my bug in another way?[edit]

Not really. Look at it from the side of the developers. First of all, when they receive a bug report through any other means, they have the choice of either fixing the bug immediately, putting it in the Bugzilla database themselves, or trying to remember it for later. As you're likely to catch them while they're in the middle of something, or just don't have the time that instant, it's not unlikely that your report will be lost.

Second, bug reports sent through other means rarely contain complete information. The Bugzilla forms have fields for things like UQM version and operating system, that may be necessary for solving the problem. A bug reported through other means would often require additional communication just to get all the facts.

Third, the person you would be contacting may not be the one who would normally fix such a bug. The developers each have their specialties. Bugs reported in the Bugzilla database will have a default assignee, and will be seen by all.

Now you may be thinking "I'm doing you a favour, take it or leave it.", but if you like the game and appreciate the work done by the developers, isn't it worth spending a few minutes to help them make the game better? Don't forget they are all volunteers, doing this in their spare time.

But if you enjoy their work just enough to report a bug through mail, the UQM forum, or IRC, but not enough to create a Bugzilla account, they'd rather hear about a bug through those means, than not at all.

See also: Where can I go for more technical help?.

Where can I go for more technical help?[edit]

The most appropriate place to ask for help on technical problems is the technical issues board on the UQM forum.

There's also the #sc2 IRC channel on OPN. You may have to be patient though, as most people that are present in the channel don't actually pay attention to it all the time. It is however the place where the developers hang out, and if you're interested in game internals, this is a good place to ask.

There's also the sc2-devel mailing list for development questions. It's hardly used anymore these days, but when it is, people still read it.

Do not mail the developers directly with technical questions.

  • a question you ask publicly, along with any answers may help other people too
  • you'll reach more people by using the forums or mailing list, so your question will usually be answered sooner
  • the developers frequently read the board, and respond to questions there

See also: I don't want to make a Bugzilla account. Is it ok to let you know about my bug in another way?

Specific bugs and not-quite bugs[edit]

The game does not behave as I expected[edit]

Gameplay bugs are listed in the Star Control II Gameplay FAQ.