Skip to content

Latest commit

 

History

History
230 lines (153 loc) · 10.7 KB

README.md

File metadata and controls

230 lines (153 loc) · 10.7 KB

title


A fork of The Ur-Quan Masters + HD-mod that remasters the HD graphics with a veritable smorgasbord of extra features, options, QoL improvements, and much more...

SourceForge Downloads (folder) Pull Requests Badge Issues Badge GitHub contributors License Badge
Latest release GitHub commits Stars Badge Forks Badge Watchers

discord


Changes from the original

The changes are too numerous to list here so I've provided a couple of links to help out in this regard...

A full list of changes and features for the current release can be found in the README.

And the full changelog can be found in the root of this repository: Changelog

Install

SourceForge Downloads (folder) SourceForge Downloads (folder) SourceForge Downloads (folder)
Android Download Flathub Download

Compiling

Requirements

Important

After downloading or cloning this repository make sure you install the UQM-MegaMod-Content first before trying to run the compiled binary

UQM-MegaMod Content

This process assumes you've downloaded or cloned this repository already.

Download or clone the UQM-MegaMod-Content repository and copy all the files within the content repository into the UQM-MegaMod/content folder of your downloaded or cloned UQM-MegaMod repository.

It should look like this:

Content Repo Preview

Windows 10+

Visual Studio

I've made this process super easy, as long as you have Visual Studio 2008 or Visual Studio 2015-2022.
For Visual Studio 2008 the solution file is under UQM-MegaMod/build/msvs2008 for Visual Studio 2015-2022 the solution file is under build/msvs2019
Just load up the solution file and compile away.

Once the build is complete you'll either have a UrQuanMasters.exe or UrQuanMastersDebug.exe in the root directory that you can run directly.

If you get a message about missing .dll files they can be found in the UQM-MegaMod/dev-lib/lib directory. Copy them to the root UQM-MegaMod directory.
The .dll are as follows:

libpng16.dll
ogg.dll
OpenAL32.dll
SDL2.dll
vorbis.dll
vorbisfile.dll
wrap_oal.dll
zlib1.dll

MSYS2

Make sure you've installed all the necessary packages by executing these two commands in the MSYS2 bash:

pacman -Syuu

then

pacman -S make pkg-config mingw-w64-i686-gcc mingw-w64-i686-libogg \
	mingw-w64-i686-libpng mingw-w64-i686-libsystre \
	mingw-w64-i686-libvorbis mingw-w64-i686-SDL2 mingw-w64-i686-zlib

Start a MSYS2 MinGW 32-bit bash, cd to the UQM-MegaMod directory, then execute this command:

./build.sh uqm -j

When executing this command for the first time you'll come to a configuration screen where you can select a few developer-centric options. Just hit enter and UQM will start building. It'll take awhile and you'll see a few scary warnings but everything should build fine.

Once the build is complete you'll either have a UrQuanMasters.exe or UrQuanMastersDebug.exe in the root directory that you can run directly.

If you get a message about missing .dll files they can be copied to the root directory via running the msys2-depend.sh bash script like so:

./msys2-depend.sh

Note though that this script does not work for Visual Studio compiled binaries.

Linux

On Debian based distros it's fairly simple, just install the following packages:

sudo apt-get install build-essential libogg-dev libpng-dev \
		libsdl2-dev libvorbis-dev libz-dev

Then when those have finished installing you can either clone the repository or download the source tarball and extract it wherever you like, taking note of where it is.

cd to the UQM-MegaMod directory, then execute this command:

./build.sh uqm -j

When executing this command for the first time you'll come to a configuration screen where you can select a few developer-centric options. Just hit enter and UQM will start building. It'll take awhile and you'll see a few scary warnings but everything should build fine.

Once the build is complete you'll either have a UrQuanMasters or UrQuanMastersDebug binary in the root directory that you can run directly.

macOS

Install Xcode from the App Store, and then when you run it the first time make sure to install "Additional components".
You can then install brew from https://brew.sh and then use it to install your requirements from the Terminal:

brew install libogg libpng libvorbis sdl2

Then when those have finished installing you can either clone the MegaMod repository or download the source tarball and extract it wherever you like, taking note of where it is.

cd to the UQM-MegaMod directory, then execute this command:

./build.sh uqm -j

When executing this command for the first time you'll come to a configuration screen where you can select a few developer-centric options. Just hit enter and UQM will start building. It'll take awhile and you'll see a few scary warnings but everything should build fine.

Once the build is complete you'll either have a UrQuanMasters or UrQuanMastersDebug binary in the root directory that you can run directly.


Warning

Controllers

When using a DualShock 4 controller DO NOT use DS4Windows. UQM and hence, MegaMod, support the DS4 without extra software. The new controller layout options only work properly if you don't use DS4Windows.

Caution

Mod Compatibility

MegaMod is not compatible with any other mods nor are they compatible with MegaMod. MegaMod is completely independant from Core UQM, HD-Mod, HD-Remix, Crazy Mod, Balance Mod, Extended, or any other mods. As such MegaMod has its own packages and add-ons.

For example the HD-Mod add-on package hires4x.zip is not compatible with MegaMod as MegaMod has its own HD package currently named mm-0.8.3-hd-content.uqm.

And as MegaMod is not compatible with any other mods, do not install it over any existing UQM installations.

All MegaMod compatible add-ons and content can be found on the main website's Download page: https://uqm-mods.sourceforge.net/Download


Contributors

Me (JHGuitarFreak), SlightlyIntelligentMonkey, Volasaurus, Ala-lala, Kruzenshtern, Taleden, and Jordan Lo.

The main menu music for the MegaMod is brought to you by Saibuster A.K.A. Itamar.Levy: http://star-control.com/fan/music/Various/saibuster-hyprespace.mp3, Mark Vera A.K.A. Jouni Airaksinen: https://www.youtube.com/watch?v=rsSc7x-p4zw, and Rush AX: http://star-control.com/fan/music/Rush/HSpace%20Rush%20MIX.mp3

And the default Super Melee menu music is by Flashira Nakirov.