The Ur-Quan Masters

From WiiBrew
Jump to navigation Jump to search
The Ur-Quan Masters
Author(s)Toys for Bob, The Ur-Quan Masters team
Ported byZared
TypeRole playing game
LicenceGNU GPL v2 (code) Creative Commons Attribution Noncommercial ShareAlike 2.0 (content)
Downloadable via the Homebrew Browser
WiiMote2.svg Nunchuck alternative.svg GameCube Controller Loads files from the Front SD slot

The Ur-Quan Masters is a port of the game Star Control 2, using the SDL. The original team released the source code to the 3DO version under the GPL, and the content under a Creative Commons license, and the Ur-Quan Masters team ported this code to the SDL, so that it can be run on a variety of modern systems.


Just extract the main zip file into your SD card's root directory. Currently, directories are hard-coded into the source, and so it must go on an SD card, and it must be in the apps/uqm directory. It works fine over USB Mass Storage, but changing the directories used requires a recompile, or a command line parameter.

You can also use the 3DO speech and music packs. The binary pack posted is based on the latest SVN version of UQM, and so the packages they have posted will not work (file structure has been changed since last stable release). I have included a packed up version of the SVN speech pack. If you also want 3DO sound, you will have to get it from the SVN, and place it in the content directory yourself. It is highly recommended that you create a .uqm pack for these files. A .uqm file is a standard zip file, only with the .uqm extension).

These .uqm files go in the same directory as the main content .uqm package.

If your screen is cut off, there is an extra setup option controlling the scaling and offset of the image on screen. Adjust the sliders to ensure that all four green borders are visible on screen.


UQM has incredibly simple controls. You can play the entire game with 3 buttons, and a stick or d-pad.

In melee, left/right turn your ship, and forward thrusts. Be careful how you hold your Wiimote if playing horizontal, as the B button is used. In story mode, you can use the hyperdrive to escape from combat (once you get it), using the start/home button.

Text is entered using the d-pad/control sticks. Up and down select letters, left and right move the cursor. OK to accept, Cancel to cancel.

All controls can be modified, in the flight.cfg and keys.cfg files. So it is easy to add support for the Classic Controller, for example. See the SDL Documentation for details on the button mappings.

Action GameCube Controller WiimoteHorizontal.svg Nunchuck alternative.svg
Direction GameCube Control Stick or GameCube D-Pad Wiimote D-Pad Nunchuck Control Stick
OK (Menu)/Fire (Melee) Gamecube A Button Wiimote 1 Button or Wiimote A Button Wiimote 1 Button or Wiimote A Button
Cancel (Menu)/Special (Melee) Gamecube B Button Wiimote 2 Button or Wiimote B Button Wiimote 2 Button or Wiimote B Button
Page up/down, zoom starmap Gamecube C Control Stick Wiimote + Button/Wiimote - Button Wiimote + Button/Wiimote - Button
Emergency Hyperdrive GameCube START Button Wiimote HOME Button Wiimote HOME Button


Building from Source

You'll need to check-out the source from the UQM SVN, as source is provided in the form of a .diff file, using r3185. Includes instructions on setting the correct environment variables.

Additionally, you will need to replace your lwp_config.h file with the one included, as UQM uses many mutexes! You must also place the included pthread.h file into your libogc includes folder, as I could not get UQM working with SDL Threads. (It crashes during some context switches).

You also need specific versions of several libraries.

SDL Wii Use r63, and no later. Later versions have a bizarre screen update bug, or freeze at boot.

"inofficial" libfat fork Forked version is needed because it supports caching, and the main did not. (May have changed).

"inofficial" libogc fork Forked version is needed because the official libogc only uses MEM1, which is not enough memory for UQM.

You also need Tremor and libpng. dhewg has these pre-compiled here, with a few other libraries.

Known Issues

Black dot in the middle of the 3D orbital view of planets.

Net Play support is currently disabled, but should work fine over wifi.

Thank Yous

This port is only possible due to the hard work of many people:

Toys to Bob for making the original, and releasing it to the fanbase for us to play with. The Ur-Quan Masters team for porting to to modern systems. The SDL Team for getting the SDL ported to the Wii. The devkitPro team for libogc.