View source for The Ur-Quan Masters

{{Infobox homebrew
| title       = The Ur-Quan Masters
| type        = role playing game
| author      = [http://toysforbob.com Toys for Bob], [http://sc2.sourceforge.net/team.php The Ur-Quan Masters team]
| maintainer  = 
| contributor = 
| portedby    = [[User:Zared|Zared]]
| licence     = [http://www.gnu.org/licenses/gpl-2.0.txt GNU GPL v2] (code) 
[http://creativecommons.org/licenses/by-nc-sa/2.5/ Creative Commons Attribution Noncommercial ShareAlike 2.0] (content)
| website     = http://wiki.uqm.stack.nl/Wii_Port
| downloadraw = [https://archive.org/download/wiibrewgames/The%20Ur-Quan%20Masters%20%28r3185%29.zip Download]
| peripherals = {{Wiimote2}} {{Nunchuk}} {{GCNController}} {{FrontSD}} 
| hbb         = yes
}}
[http://sc2.sourceforge.net/ 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.  

== Installation ==
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.

== Controls == 
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.  

{| class="wikitable"
|-
! Action !! {{GCNController}} !! {{WiimoteHorizontal}} !! {{Nunchuck}}
|-
| Direction || {{GCControlStick}} or  {{GCDPad}} || {{WiimoteDPad}} || {{NunchuckControlStick‎}}
|-
| OK (Menu)/Fire (Melee) || {{GCAButton}}  || {{Wiimote1Button}} or {{WiimoteAButton}} || {{Wiimote1Button}} or {{WiimoteAButton}}
|-
| Cancel (Menu)/Special (Melee) || {{GCBButton}}  || {{Wiimote2Button}} or {{WiimoteBButton}} || {{Wiimote2Button}} or {{WiimoteBButton}}
|-
| Page up/down, zoom starmap || {{GCControlStickC}}  || {{WiimotePlusButton}}/{{WiimoteMinusButton}} || {{WiimotePlusButton}}/{{WiimoteMinusButton}} 
|-
| Emergency Hyperdrive || {{GCStartButton}}  || {{WiimoteHomeButton}} ||  {{WiimoteHomeButton}}
|}


== Media ==
{|
| <youtube valign="top" align="left">H3DO51W_WSA</youtube>
|}

== 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.

[http://code.google.com/p/sdl-wii/source/checkout SDL Wii]  Use r63, and no later.  Later versions have a bizarre screen update bug, or freeze at boot.

[http://repo.or.cz/w/libfat.git "inofficial" libfat fork]  Forked version is needed because it supports caching, and the main did not.  (May have changed).

[http://repo.or.cz/w/libogc.git "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 [http://static.hackmii.com/dhewg/devkitPPC_r16_3rd_libs.tar.bz2 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.