pollymc/BUILD.md
2013-10-10 21:23:00 +02:00

4.5 KiB

Build Instructions

Contents

Linux

Dependencies

Getting set up

git clone git@github.com:MultiMC/MultiMC5.git # get the code
cd MultiMC5
git checkout develop

once that is done, do these commands:

mkdir build
cd build
ccmake ..

A GUI will pop up. press the c key. now set the build prefix. if you are in /home/username/code/MultiMC5/build then put /home/username/code/MultiMC5/build/run as build prefix. if you want you can choose whatever dir you want, but then you need to adjust the path when running it. to edit the value use the up/down keys to select it and hit return to edit it. after you are done hit return again.
Also adjust the paths to your qt install.

Then hit c and g. If the window stays open (and g has no effect) retry c followed by g. sometimes you need to use c twice.
If you get an error make sure you have all dependencies installed and configured the paths properly

continue with the following commands:

cmake ..
make
make translations_target # compiles localization files. you may leave this out if your language is english
make install

now you compiled it (hupefully) successfully.

to launch it:

cd run # or whereever its stored
./MultiMC5

Congrats. Your MMC5 should run

Windows

Getting the project to build and run on Windows is easy if you use Qt's IDE, Qt Creator. The project will simply not compile using VC's build tools as it uses some C++11 features that aren't implemented in it at the time of writing.

Dependencies

Getting set up

Installing Qt

  1. Run the Qt installer
  2. Choose a place to install Qt (C:\Qt is the default),
  3. Choose the components you want to install
    • You need Qt 5.1.1/MinGW 4.8 (32 bit) ticked,
    • You need Tools/Qt Creator ticked,
    • Other components are selected by default, you can untick them if you don't need them.
  4. Accept the license agreements,
  5. Double check the install details and then click "Install"
    • Installation can take a very long time, go grab a cup of tea or something and let it work.

Installing OpenSSL

  1. Run the OpenSSL installer,
  2. It's best to choose the option to copy OpenSSL DLLs to the /bin directory

Installing CMake

  1. Run the CMake installer,
  2. It's easiest if you choose to add CMake to the PATH for all users,
    • If you don't choose to do this, remember where you installed CMake.

Loading the project

  1. Open Qt Creator,
  2. Choose File->Open File or Project,
  3. Navigate to the MultiMC5 source folder you cloned and choose CMakeLists.txt,
  4. Read the instructions that just popped up about a build location and choose one,
  5. If you chose not to add CMake to the system PATH, tell Qt Creator where you installed it,
    • Otherwise you can skip this step.
  6. You should see "Run CMake" in the window,
    • Make sure that Generator is set to "MinGW Generator (Desktop Qt 5.1.1 MinGW 32bit)",
    • Hit the "Run CMake" button,
    • You'll see warnings and it might not be clear that it succeeded until you scroll to the bottom of the window.
    • Hit "Finish" if CMake ran successfully.
  7. Cross your fingers and press the Run button (bottom left of Qt Creator)!
    • If the project builds successfully it will run and the MultiMC5 window will pop up,
    • Test OpenSSL by making an instance and trying to log in. If Qt Creator couldn't find OpenSSL during the CMake stage, login will fail and you'll get an error.

These build instructions worked for me (Drayshak) on a fresh Windows 8 x64 Professional install. If they don't work for you, let us know on IRC (Esper/#MultiMC)!

OS X

There are no build instructions for OS X yet. If you can help with this section please contact us on IRC (Esper/#MultiMC)!