Find file
Fetching contributors…
Cannot retrieve contributors at this time
136 lines (97 sloc) 4.05 KB
// This file is part of openCaesar3.
// openCaesar3 is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
// openCaesar3 is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// GNU General Public License for more details.
// You should have received a copy of the GNU General Public License
// along with openCaesar3. If not, see <>.
// Copyright 2012-2013 Gregoire Athanase,
// Copyright 2013 Rovanion Luckey,
Installation of openCaesar3 on Linux
Open up a terminal and follow the instructions below. Terminal
commands are denoted with a "$", this character should not be included
with the commands. Depending on which distribution and version you are
running the instructions will differ. To find out what you are
running, run:
$ cat /etc/*-release
If your distribution is not listed in these instructions, feel free
to add instructions for it.
1 Install dependencies
1.a Ubuntu and Debian:
1.a.1 Base dependencies
$ sudo apt-get install build-essential g++ zlib1g-dev \
libsdl1.2-dev libsdl-mixer1.2-dev libsdl-ttf2.0-dev \
qt4-dev-tools ctags libqxt-dev git cmake p7zip-full wget
1.b Fedora:
1.b.1 Base dependencies
$ sudo yum install make automake gcc gcc-c++ \
zlib-devel SDL-devel SDL_mixer-devel SDL_ttf-devel \
qt-devel ctags cmake git p7zip wget libpng12-devel
1.c openSUSE 12.3
$ sudo zypper install libSDL-devel libSDL_ttf-devel \
libSDL_mixer-devel git cmake gcc-c++ libjpeg-devel \
2 Building the game
First move your terminal to where you want openCaesar 3 to be installed, e.g:
$ mkdir games && cd games
We will then download the source code from github and compile it:
$ git clone git://
$ cd opencaesar3
$ cmake ./
$ make
3 Installing resources
These resources are images, videos and sound needed to run the
game. The following commands will download an archive and extract the
needed files into the resources folder:
$ wget
$ 7za x resources.7z
$ rm resources.7z
4 Running the game
In order to start the game, simply execute the caesar3 binary now
located in your opencaesar3 folder:
$ ./caesar3
5 Appendix: SGReader and extracting resources
SGReader is a tool developed to read and extract resources from the
installed Caesar 3 resource files. If you want to extract your own
resources or just explore the resources, compiling and usage will be
outlined in this chapter. Note though that openCaesar 3 requires more
resources than those just on the original Caesar 3 CD.
5.1 Compiling SGReader
Go to the sgreader folder in the folder where you installed openCaesar3,
in this guide it was ~/games/openceasar3/ :
$ cd ~/games/opencaesar3/cgreader
Then compile the code and launch SGReader:
$ cmake ./
$ make
$ ./sgreader
5.2 Extracting resources from Caesar 3 install
Once SGReader has started select File -> Batch Extract.
Select the input folder:
Select the directory where you installed Caesar3 (eg: ~/caesar3_orig)
Choose files to extract:
Select C3.sg2, C3_North.sg2 and C3_south.sg2
Set the output folder:
Use a temporary directory of your choice (eg: ~/caesar3_extract)
Run the extraction...
Images extracted:
you should get approx 26314 extracted images, and 124 skipped images.
In order to move these files into the resource folder run the
following install script:
$ cd ..
$ ./install --pic-dir ~/caesar3_extract --data-dir ~/caesar3_orig
Though note as mentioned above that openCaesar 3 requires more
resources than those just on the original Caesar 3 CD.