The Mac build may need attention. If you are interested in helping us test that the build completes and the game runs, please post or subscribe to this ticket: Current Status
-
Getting the code:
-
Dependencies
-
Compiling
If you think you may be contributing to development, we suggest forking and then cloning your forks of these 2 repositories. If you only want to build and test out the game, and have no plans of submitting patches, you don't need to worry about using the fork option (You can fork later if you change your mind).
-
Create a new directory to clone your zetaglest-source and zetaglest-data into e.g. call it
ZetaGlest
. -
Enter (or 'cd') into the new directory (
ZetaGlest
in the example). -
clone zetaglest-source and zetaglest-data using the clone info provided by your fork or the main repos. (Use the "Clone or Download" link, but do select
clone
notDownload Zip
.) Make sure the cloned repo directories are in the same directory, adjacent to each other (and not in a subdirectory).
If you have cloned the repositories using your forks, do not use the
git_update.sh
provided in the source directory. See
syncing
for information on how to sync your repo with the main upstream (no,
you can't juse use merge).
Most people will never have to change the options when running cmake
.
To view all available options, use cmake .. -LH
while in the build directory.
Follow the
instructions
listed in the Windows
directory.
On Debian, Ubuntu, Fedora, Opensuse and even more Linux distributions, after you clone the source repository, you may use
cd mk/linux
sudo ./setupBuildDeps.sh
which will run your package manager and attempt to install the needed packages.
On Windows simply run setup.bat
in \mk\windows
.
(These may vary based on your operating system or Linux distribution; we will attempt to document dependencies in more detail)
Below is a list of most dependencies you will need.
gcc g++ cmake libsdl2-dev libalut-dev libgl1-mesa-dev libglu1-mesa-dev libvorbis-dev libx11-dev liblua5.2-dev libjpeg-dev libpng-dev libcurl4-gnutls-dev libircclient-dev libglew-dev libftgl-dev libfribidi-dev libcppunit-dev libminiupnpc-dev libfreetype6-dev libgnutls28-dev libkrb5-dev libkrb5-dev libnghttp2-dev libopenal-dev libldap2-dev librtmp-dev libwxgtk3.0-dev libwxgtk3.0-dev (wxWidgets)
You can install the dependencies with brew
brew install sdl2 lua fontconfig freetype ftgl libogg glew libvorbis cppunit glib fribidi miniupnpc wxmac
brew outdated cmake || brew upgrade cmake; brew outdated pkgconfig || brew upgrade pkgconfig
brew install Caskroom/cask/xquartz
Below is a list of most of dependencies you will need.
A C++11 compiler is mandatory, so base (or package) eg++ and egcc
You can install the dependencies using pkg_add
:
pkg_add cmake curl freealut ftgl glew gnutls icu4c jpeg lua libircclient libvorbis miniupnpc nghttp2 openal png sdl2 wxWidgets xerces-c
You can install the dependencies using pacman
:
pacman -S curl ftgl glew glu icu libgl libircclient libvorbis libx11 lua51 miniupnpc openal sdl2 wxgtk3 xerces-c cmake ftjam git mesa
(Add other specific operating systems)
Now that you have the source code and the dependencies, you can either compile ZetaGlest and run it without installing, or you can set options to install it. If you plan to install, then you can skip the sections below and read INSTALL.md
./build-zg.bat
From the top of the project source directory:
mkdir build
cd build
(cmake
On Linux or Mac OS)
cmake .. -DINSTALL_DIR_DATA=<absolute-path-to-data>
(cmake
on BSD. Setting the 2 variables before the cmake command tells
cmake to use the correct compiler)
CC=`which egcc` CXX=`which eg++` cmake .. -DINSTALL_DIR_DATA=<absolute-path-to-data>
Now that the build configuration has been set, run make, replacing X
with the number of CPU cores in your computer:
make -jX
The zetaglest binaries will be in the build/
directory. Run
'./zetaglest' to start the game.
See running for detailed information about running a server or hosting a game.
The value for INSTALL_DIR_DATA is written to the game when compiled, therefore if you ever move your data directory, you will have to recompile ZetaGlest.
After you run cmake
for the first time, you won't need to specify any
options unless you want to change previously-used options. Just use
cmake ..
(You'll need to run make
and make install
to rebuild.)
If you want to completely erase your previously-used options, remove
build/CMakeCache.txt
.
If your build doesn't seem to be using the options you gave it, first try removing CMakeCache.txt and rebuilding.