The Osirion Project - INSTALL These are the installation instructions for the Osirion Project. A description of the project and general usage information can be found in the README file. Installation To build the Osirion Project from source code you will need the following libraries and their header files: SDL version 1.2 or newer OpenGL, version 1.1 or newer OpenAL version 1.1 or newer I have succesfully compiled it on the following platforms: linux-x86_64 gcc 4.1.2 linux-i686 gcc 4.1.2 mingw32 gcc 4.2.2 In theory, it should compile on any POSIX-compatible platform supported by SDL, reports for other platforms (working or not) are welcome. Compilation on windows32 If you downloaded the zip file containing the windows32 exe files, all the hard work has already been done and the game is ready to run. If you want to build your own exe files, keep on reading. You can use maci's excellent mingw/msys package to install a development environment on windows. You can find the installer here: http://satgnu.net/maci/files/q2wdevenv.exe You can use the Turtoisesvn SubVersion client to access the SVN repositories. You can download it from http://tortoisesvn.tigris.org/ Obtaining the source code Get the latest version of the source code from svn: svn checkout svn://intranifty.no-ip.org/osirion This command will create a new subdirectory 'osirion' and download the source code into it. Compiling the source code Enter the new directory and compile the source code: cd osirion/ autoreconf -fi ./configure make At present, 'make install' is neither tested nor supported. Compiling the dedicated server only The included configure script is not yet capable to compile the dedicated server only. If you want to compile the dedicated server on a system that does not have SDL or OpenGL, you will have to finish the build manually. Start the build in the usual fashion: cd osirion/ autoreconf -fi ./configure make When trying to build the render library, the build will fail with an error message. Proceed by building the game library and the osiriond binary: cd src/game make cd .. make osiriond cd .. Installing game data The game data should be located in the 'data' subdirectory of the main distribution. Get the latest version of the game data from svn: Run the following command from within the main distribution directory: svn checkout svn://intranifty.no-ip.org/osirion-data data Installing gtkradiant 1.5.0 support files (optional) You only need to install these files if you want to create models with gtkradiant. Note that these files where made for gtkradiant 1.5.0, I have not tested the with any other version. You can find precompiled gtkradiant 1.5.0 binaries for linux at http://ingar.soliter.org. These instructions assume gtkradiant is installed in the directory '/usr/local/games/gtkradiant-1.5.0'. If it is installed in a different directory on your system, edit these instructions accordingly. Copy the support files to the gtkradiant folder: cd data cd gtkradiant cp -vr * /usr/local/games/gtkradiant-1.5.0 Open the file '/usr/local/games/gtkradiant-1.5.0/games/osirion.game' in your favourite editor. Look for a line that begins with: enginepath_linux=" Make sure it points to your osirion data directory. For example, if you checked out the source code in '/home/user/games/osirion', then the data will be in '/home/user/games/osirion/data' and the line should look like this: enginepath_linux="/home/user/games/osirion/data" Save the changes. Source data (optional) The .xcf and .svg source files used to create the game data can also be downloaded. Note that you do not need these files to play the game or to create .map models. You only have to download them them if you want to create new game graphics. To download the source data: svn checkout svn://intranifty.no-ip.org/osirion-data-src data-src Executing To run the client program, execute: src/osirion To run the dedicated server, execute: src/osiriond Updating If you downloaded and compiled the game before, there is no need to re-download the entire distribution. Update the game source code with the following commands: cd osirion/ make distclean svn update Rebuild the game: autoreconf -fi ./configure make Update the game data: cd data/ svn update cd ..