For easy building I recommend using cmake and make,
as it has low overhead when it comes to changes in the code.
Since this repository only contains the engine,
it is highly recommended that you grab some game data packages (we call them mods).
A good place to start would be the official flare-game mods.
Mods may then be copied to the mods/
folder manually,
if you do not wish to install Flare system-wide.
git clone https://github.com/flareteam/flare-engine.git # clone the latest source code
git clone https://github.com/flareteam/flare-game.git # and game data
# remember your dependancies(see below)
cd flare-engine
cmake .
make # build the executable
cd ../flare-game/mods
ln -s ../../flare-engine/mods/default # symlink the default mod
cd ../
ln -s ../flare-engine/flare # symlink the executable
./flare # flame on!
As a side note, I recommend enabling debugging symbols in order to provide more details if you run into a crash. This can be done by changing the cmake command in the block above to:
cmake . -DCMAKE_BUILD_TYPE=Debug
You can also build the engine with just one call to your compiler including all source files at once. This might be useful if you are trying to run a flare based game on an obscure platform, as you only need a c++ compiler and the ported SDL package.
To build Flare you need the 2.0 Development Libraries for SDL: SDL_image, SDL_mixer, and SDL_ttf, with the equivalent 2.0 Runtime Libraries to run the game; or follow the steps below for your Operating System of choice.
Installing dependencies on Arch Linux:
pacman -S --asdeps sdl2 sdl2_image sdl2_mixer libogg libvorbis hicolor-icon-theme python sdl2_ttf
There are also AUR PKGBUILDs available for the latest (engine and game) versions.
Installing dependencies on debian based systems (debian, Ubuntu, Kubuntu, etc):
sudo apt-get install libsdl2-dev libsdl2-image-dev libsdl2-mixer-dev libsdl2-ttf-dev
# for development you'll also need:
sudo apt-get install cmake make g++ git
There is also a flare build in the Ubuntu (universe), which actually is flare-game.
Installing dependencies on Fedora:
sudo dnf install git make cmake gcc-c++ SDL2-devel SDL2_image-devel SDL2_mixer-devel SDL2_ttf-devel
Installing dependencies on openSUSE:
sudo zypper in make cmake gcc-c++ libSDL2-devel libSDL2_image-devel libSDL2_mixer-devel libSDL2_ttf-devel
There is also a flare build at the openSUSE games repo.
Installing dependencies using Homebrew:
brew install cmake libvorbis sdl2 sdl2_image sdl2_mixer sdl2_ttf
We use MSYS2 as our official development environment on Windows.
# install the build environment with SDL2 libraries
# 32-bit
pacman -S git mingw-w64-i686-SDL2 mingw-w64-i686-SDL2_image mingw-w64-i686-SDL2_mixer mingw-w64-i686-SDL2_ttf mingw-w64-i686-cmake mingw-w64-i686-gcc mingw-w64-i686-make
# 64-bit
pacman -S git mingw-w64-x86_64-SDL2 mingw-w64-x86_64-SDL2_image mingw-w64-x86_64-SDL2_mixer mingw-w64-x86_64-SDL2_ttf mingw-w64-x86_64-cmake mingw-w64-x86_64-gcc mingw-w64-x86_64-make
git clone https://github.com/flareteam/flare-engine.git
cd flare-engine
cmake . -DCMAKE_BUILD_TYPE=Release -G "MinGW Makefiles"
mingw32-make
If you want a debug build, simply replace Release
with Debug
as the CMake build type.
It is highly recommended that you add C:\msys64\mingw32\bin
(or C:\msys64\mingw64\bin
for 64-bit) to your Windows PATH variable for running flare.exe outside of the MSYS environment.
To obtain and use the game files, continue from the previous set of commands:
cd ../
git clone https://github.com/flareteam/flare-game.git
cd flare-game
cp -r mods/* ../flare-engine/mods/
If you want to build flare under Microsoft Visual C++,
you should get dirent.h header file
and copy it to $MICROSOFT_VISUAL_CPP_FOLDER\VC\include\
.
To get SDL2 vcpkg can be used. Its an elegant solution to manage C/C++ dependencies in a central place.
Use Windows PowerShell or Git Bash and change to a directory where you want to store the dependencies:
#get the vcpkg code
git clone https://github.com/Microsoft/vcpkg.git
cd vcpkg
#bootstrap vcpkg
./bootstrap-vcpkg.bat
#install the dependencies (for 64bit builds, you can use x86-windows triplet instead if you want 32bit)
./vcpkg install sdl2:x64-windows sdl2-image:x64-windows sdl2-mixer:x64-windows sdl2-ttf:x64-windows
After that the dependencies have been downloaded and build. You can use them in your cmake projects by adding the path of the
toolchain file to your cmake configuration command line options: -DCMAKE_TOOLCHAIN_FILE=[vcpkg root]\scripts\buildsystems\vcpkg.cmake
The executable is called flare
in this repository or in the flare-game repository,
but it is subject to change if you're running another game based on the engine (such as polymorphable).
If you want the game installed system-wide, as root, install with:
make install
The game will be installed into /usr/local
by default.
You can set different paths in the cmake step, like:
cmake -DCMAKE_INSTALL_PREFIX:STRING="/usr" .
If you prefer building directly with C++, the command will be something like this:
GNU/Linux (depending on where your SDL includes are):
g++ -I /usr/include/SDL src/*.cpp -o flare -lSDL2 -lSDL2_image -lSDL2_mixer -lSDL2_ttf
Windows plus MinGW:
(Note: Due to an issue with compilers that aren't VC++, it is recommended to use SDL_image 2.0.4)
g++ -I C:\MinGW\include\SDL src\*.cpp -o flare.exe -lmingw32 -lSDLmain -lSDL2 -lSDL2_image -lSDL2_mixer -lSDL2_ttf
Flare is intended to be able to run on a wide range of hardware. Even on very low end hardware, such as handhelds or old computers. To run on low end hardware smooth, we need get the best compile output possible for this device. The following tips may help improving the the compile output with respect to speed. However these compiler switches are not supported on some platforms, hence we do not include it into the default compile settings.
- Make sure the compiler optimizes for exactly your hardware. (g++, see -march, -mcpu)
- Enable link time optimisation (g++: -flto) This option inlines small get and set functions accross object files reducing overhead in function calls.
- More aggressive optimisation by telling the linker, it's just this program. (g++: -fwhole-program)
- to be continued.
If the game fails to start, some of the following tips might help:
-
Open your
settings.txt
file. The location of this file is specified in README.md. In that file, sethwsurface=0
andvsync=0
. -
Older computers might have CPUs that don't support SSE. The default binaries for SDL 2 require SSE. To disable SSE instructions, it is necessary to download the SDL 2 source and build SDL 2 library from source.
In case of Windows plus MinGW/MSYS run the following commands from SDL 2 source folder using MSYS terminal:
./configure --disable-sse mingw32-make
Then use produced libraries to build flare. In case of Linux use:
./configure --disable-sse make make install
Last command will install built libraries system-wide.
If you want to build SDL2 from Visual C++ project, open SDL2 project in Visual Studio, go to
Project Properties -> C/C++ -> Code Generation -> Enable Enhanced Instruction Set
and select No Enhanced Instructions (/arch:IA32). You might really need to rebuild also SDL2_mixer, SDL2_image and SDL2_ttf when you want to use libraries, built with Visual Studio.
If you want to build using cmake, use cmake-gui, and uncheck SSE checkbox after executing Configure command.