Debian
From UFO:AI
Contents |
Prerequisites
For Debian and Debian-based distributions (Ubuntu etc.), you first need to install the standard GNU gcc stuff and SVN. Open your favourite console and type:
$ sudo apt-get install make gcc subversion
You also need the following development packages (hope I didn't forget any - if make fails, that's probably the reason):
$ sudo apt-get install \ libsdl1.2-dev libsdl-ttf2.0-dev libvorbis-dev zlib1g-dev gettext libtheora-dev \ libjpeg62-dev libpng12-dev libncurses5-dev libcurl3-dev libsdl-mixer1.2-dev \ libxml2-dev libopenal-dev
You need these development packages if radiant should be built. This can be disabled via './configure --enable-uforadiant=no'.
$ sudo apt-get install \ libglib2.0-dev libgtk2.0-dev libgtkglext1-dev libgtksourceview2.0-dev
If you plan to compile version prior to 2.2 you maybe also need libxxf86vm-dev and libxxf86dga-dev.
If you have issues with finding 'GL/gl.h' (later in the build) the following may also help
$ sudo apt-get --reinstall install mesa-common-dev
Note: You also need to install gettext to compile languages (following the standard procedure on Ubuntu without that results in almost no texts in game). Wrwrwr 03:04, 7 December 2007 (CET)
Note: You may also need libxvidcore4-dev for the ./configure requirement of xvid.h. Also libtheora-dev for the ./configure requirement of theora.h. Blattengel 03:32, 19 May 2009 (MST)
For Ubuntu 8.04 LTS users, simply use the following: (--Stmok 02:18, 14 October 2009 (UTC))
$ sudo apt-get install \ make gcc subversion libsdl1.2-dev libsdl-ttf2.0-dev libvorbis-dev zlib1g-dev gettext libtheora-dev libjpeg62-dev libpng12-dev libncurses5-dev \ libcurl4-openssl-dev libsdl-mixer1.2-dev libxml2-dev libopenal-dev libglib2.0-dev libgtk2.0-dev libgtkglext1-dev mesa-common-dev gettext \ libxvidcore4-dev libgtksourceview2.0-dev
Download the latest SVN version
Create a new directory and grab the latest SVN version:
$ mkdir ufoai $ cd ufoai $ svn co https://ufoai.svn.sourceforge.net/svnroot/ufoai/ufoai/trunk $ cd trunk
This might take a while as the whole trunk package (including all the models, maps, all the textures etc.) is approximately 500MB+.
WARNING: Some music is not included in SVN trunk (because of their license restrictions). You have to download it manually from the UFOAI homepage and decompress it to base/music folder.
You can also get a specific 'stable' version instead of the most recent (often unstable) code. See Releases/SVN for more info on how to do that.
Compile
Compile the game with:
$ ./configure $ make $ make lang
Now compile the maps (see also Mapping/Compile):
$ make maps
WARNING: Compiling maps takes some time (even a couple of hours! - for example more than 6 hours on Athlon64 3000+, 6.3120075 hours on Athlon64 3500+, around 16 hours on Pentium IV 1.5GHz).
NOTE: the modification of PATH above is needed to include the ufo2map executable in our path. ufo2map is usually found in the ufoai root (trunk) directory although on some systems it might be located in releasei386 or releasex86_64 or debugi386 or debugx86_64. If this is the case on your system you may need to replace the PATH modification statement above with: PATH=$PATH:../../releasei386 (or similar)
NOTE: If you have multiple cpus/cores you might want to use the -j option to make. The number of jobs should be cpus/cores + 1, so if you have a dual-core cpu use make -j 3. You could also use -j 2 on single core/single cpu machines to speed things a little bit.
Running
In trunk run the ufo executable:
$ ./ufo
The Debugging section also provides useful advice if something goes wrong.
Updating the SVN version
To update to the latest SVN version:
$ cd trunk $ svn up
Then re-compile.
Then rebuild the maps (only new or updated maps will be rebuilt so it won't take forever!).
Problems
If a black screen occurs and if you previously have installed the game : remove the ufoai directory (~/.ufoai) in your home directory:
$ rm -R ~/.ufoai
Building Debian packages
Just type:
$ make deb
This will build all maps and compile the game (if not already done) and create deb packages (you need the devscripts package, too). If you want to build the maps with this command, make sure, that you already have ufoai-tools installed. To install them before creating the maps you can type:
$ make debbinary
and install the ufoai-tools package via:
$ dpkg -i ufoai-tools[...].deb
You also have the ability to create only the data packages by typing:
$ make debdata
