Difference between revisions of "Installation"

From Project::OSiRiON wiki

(Import from backup)
 
(The data package is a zip instead of a tar.bz2 now.)
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
While there is still a lot of work to be done before there will be a  final release of the game, there are packages with development builds available to serve as a platform for developers and contributers, or for those who are just curious about the current state of affairs.
+
There are packages with development builds available to serve as a platform for developers and contributors,  
 +
or for those who are just curious about the current state of affairs.
  
The package are usually lagging somewhat behind on actual development. If you feel courageous you can download the latest and greatest development revision from the subversion repository and build your own binaries.
+
The packages are usually lagging somewhat behind on actual development.  
 +
If you feel courageous you can clone the git repository with the latest and greatest development revision and build your own binaries.
  
== Using packages ==
+
== Installing the latest release ==
  
Installing the packages is the fastest and easiest way to try the latest development build. You will need two packages: one packages with binaries for your operating system (the ''exe'' files), and the package with the game data (textures, sounds, models, ...)
+
The quickest and easiest way to install Project::OSiRiON is by downloading the most recent development release.
 +
In general, you only need to download the release package and run the program.
  
 
=== Windows ===
 
=== Windows ===
  
First of all you need to download the exe files. There's a package for 32-bit windows and a package for 64-bit windows, you only need to download one of them. If you don't know which one to pick, the 32-bit is a safe choice, as it will also work on 64-bit windows systems.
+
Download the release package: there's a package for 32-bit windows and a package for 64-bit windows, you only need to download one of them. If you don't know which one to pick, the 32-bit is a safe choice, as it will also work on 64-bit windows systems.
  
Download for 32-bit windows:
+
* Windows 32-bit: [http://osirion.org/files/osirion-latest-win32.zip osirion-latest-win32.zip]
[http://osirion.org/files/osirion-latest-win32.zip osirion-latest-win32.zip]
+
* Windows 64-bit: [http://osirion.org/files/osirion-latest-win64.zip osirion-latest-win64.zip]
  
Download for 64-bit windows:
+
Unzip the package to an aproriate location, a new folder will automaticaly be created.  
[http://osirion.org/files/osirion-latest-win64.zip osirion-latest-win64.zip]
 
  
Unzip the package to an approriate location, a new folder will automaticly be created. Next you will have to download the game data.
+
Run ''Osirion.exe'' to start the game.
 
 
Download for the game data:
 
[http://osirion.org/files/osirion-latest-data.zip osirion-latest-data.zip]
 
 
 
Unzip the game data into the Project::Osirion directory, a new subfolder ''data'' will be created. The file ''Osirion.exe'' and the ''data'' subfolder should end up in the same folder.
 
 
 
Click on ''Osirion.exe'' to start the game.
 
  
 
=== Linux ===
 
=== Linux ===
  
Note:
+
To run the game, you need a working OpenGL installation and the SDL and openal-soft libraries. Most likely, you already have these installed on your system. The package contains binaries for both 32-bit and 64-bit systems.
''The binaries where made for Ubuntu 12 and might not run on your distribution.
 
''If they don't, you can try building from source code.
 
  
To run the game, you will need to have SDL installed. This is a fairly common
+
* Linux 32-bit and 64-bit: [http://osirion.org/files/osirion-latest-linux.tar.bz2 osirion-latest-linux.tar.bz2]
library and chances are high you already have it installed. Besides SDL, you will need working OpenGL drivers. The package contains both 32-bit and 64-bit binaries.
 
  
Download for linux (32-bit and 64-bit):
+
Extract the package to a suitable location, for example, ''/usr/local/games''. A new directory called ''osirion-version-linux'' will automaticaly be created, the actual directory name depends on the version number.
[http://osirion.org/files/osirion-latest-linux.tar.bz2 osirion-latest-linux.tar.bz2]
 
 
 
Extract the binaries to a suitable location, for example, ''/usr/local/games''. A new directory called ''osirion-version-linux'' will automaticly be created. (The actual directory name depend on the version number).
 
  
 
   cd /usr/local/games
 
   cd /usr/local/games
   sudo tar jxvf /where/you/downloaded/osirion-latest-linux.tar.bz2
+
   tar jxvf /where/you/downloaded/osirion-latest-linux.tar.bz2
 
   cd osirion-version-linux
 
   cd osirion-version-linux
 
Download for the game data:
 
[http://osirion.org/files/osirion-latest-data.zip osirion-latest-data.zip]
 
 
Download the game data and extract it into the osirion directory. A new subdirectory ''data'' will be created.
 
 
  sudo unzip /where/you/downloaded/osirion-latest-data.zip
 
  
 
To run the 32-bit version:
 
To run the 32-bit version:
Line 59: Line 41:
 
   ./osirion.x86_64
 
   ./osirion.x86_64
  
=== MacOS ===
+
== Building Prerequisites ==
  
While it is possible to build Project::OSiRiON on MacOS, no official build for MacOS is currently available. Contact the Development Team if you are a MacOS user interested in trying the game.
+
To build Project::OSiRiON from source code you need a working C++ compiler and have the necessary libraries and header files installed. The official binaries are compiled with gcc on linux, and mingw on windows.
  
== Building from source code ==
+
=== Dependencies ===
 
 
To build Project::OSiRiON from source code you need a working C++ compiler and have the necessary libraries and header files installed. The official binaries are compiled with gcc on linux, and mingw on windows
 
 
 
=== Requirements ===
 
  
 
The following packages are required to build the the dedicated server:
 
The following packages are required to build the the dedicated server:
Line 79: Line 57:
 
* libjpeg
 
* libjpeg
 
* libpng
 
* libpng
* libSDL 1.2
+
* libSDL 2
 
* OpenGL
 
* OpenGL
 
* [http://connect.creativelabs.com/openal/Downloads/Forms/AllItems.aspx OpenAL] or [http://kcat.strangesoft.net/openal.html OpenAL Soft]
 
* [http://connect.creativelabs.com/openal/Downloads/Forms/AllItems.aspx OpenAL] or [http://kcat.strangesoft.net/openal.html OpenAL Soft]
Line 86: Line 64:
 
You will also need gcc, GNU make, automake and libtool.
 
You will also need gcc, GNU make, automake and libtool.
  
=== Building on Ubuntu ===
+
=== Building on Debian ===
  
To build the game on Ubuntu, you can install the required tools and dependencies
+
To build the game on Debian-based distributions, you can install the required tools and dependencies
by running the following commands in a terminal window:
+
by running the following commands (As root) in a terminal window:
  
  sudo su -
+
   apt-get install build-essential autoconf automake libtool libjpeg-dev libpng12-dev libvorbis-dev libglu1-mesa-dev libopenal-dev libsdl2-dev libbullet-dev
   apt-get install autoconf automake libtool subversion
 
  apt-get install libjpeg8 libjpeg8-dev  
 
  apt-get install libpng3 libpng3-dev  
 
  apt-get install libvorbisfile3 libvorbis-dev
 
  apt-get install libglu1-mesa-dev  
 
  apt-get install libopenal1 libopenal-dev
 
  apt-get install libsdl1.2debian libsdl1.2-dev
 
  
 
=== Building on Windows ===
 
=== Building on Windows ===
  
You can build the game on windows using a MinGW/MSYS environment. You can use the instructions in [http://ingar.satgnu.net/devenv/mingw32/ this document] to create a complete environment, capable of building the Project::OSiRiON source code. You need to install the base system described in part one, and the following packages described in part two: pkg-config, DirectX development files, zlib, SDL, libpng, libjpeg, OpenAL Soft, libogg, libvorbis, pdcurses and bullet.
+
You can build the game on windows using an MSYS2 environment.
 +
You can find more information on the [https://www.msys2.org/ MSyS2 homepage].
  
=== Building the Bullet physics library ===
+
== Building from source code ==
 
 
The engine uses the [http://www.bulletphysics.com/ Bullet Physics library] for physics support. You can download the bullet source code here:
 
 
 
* [http://code.google.com/p/bullet/downloads/list http://code.google.com/p/bullet/downloads/list]
 
 
 
To download and install the library:
 
  wget http://bullet.googlecode.com/files/bullet-2.81-rev2613.tgz
 
  tar zxvf bullet-2.81-rev2613.tgz
 
  cd bullet-2.81-rev2613
 
  ./autogen.sh
 
  ./configure --prefix=/usr/local --disable-demos
 
  make
 
  sudo make install
 
  cd ..
 
 
 
If you do not want to install bullet in /usr/local, you can edit the --prefix option here.
 
Edit the the --with-bullet option when configuring the Project::OSiRiON source code accordingly.
 
 
 
It is recommended you use this specific version of the library,
 
physics behaviour could be different in other versions.
 
  
 
=== Obtaining the source code ===
 
=== Obtaining the source code ===
  
You can get the latest source code from the subversion repository:  
+
You can get the latest source code from the git repository:  
  
* [svn://osirion.org/osirion svn://osirion.org/osirion]
+
* [http://osirion.org/git/osirion-src/ http://osirion.org/git/osirion-src]
  
On linux, you can use the Subversion command line client tool. The following command will create a new subdirectory osirion and download the source code into it.
+
Use the git command line tool to clone the repository:
  
   svn co svn://osirion.org/osirion osirion
+
   git clone http://osirion.org/git/osirion-src osirion
  
 
Enter the new subdirectory:
 
Enter the new subdirectory:
Line 140: Line 92:
 
   cd osirion
 
   cd osirion
  
On windows, you can use Turtoisesvn to access the SVN repositories. You can download it here:
+
You can also download the source code package from the website:
 
 
* [http://tortoisesvn.tigris.org http://tortoisesvn.tigris.org]
 
 
 
You can also download the source package from the website:
 
 
   
 
   
 
* [http://osirion.org/files/osirion-latest-src.tar.bz2 osirion-latest-src.tar.bz2]
 
* [http://osirion.org/files/osirion-latest-src.tar.bz2 osirion-latest-src.tar.bz2]
 +
 +
  wget http://osirion.org/files/osirion-latest-src.tar.bz2
 +
  tar jxf osirion-latest-src.tar.bz2
 +
  cd osirion
  
 
=== Obtaining the game data ===
 
=== Obtaining the game data ===
  
Get the latest game data from the subversion repository:
+
Get the latest game data from the git repository:
  
* [svn://osirion.org/osirion svn://osirion.org/osirion-data]
+
* [http://osirion.org/git/osirion-data/ http://osirion.org/git/osirion-data]
  
The following command will create a new subdirectory data and download the game data into it:
+
The following command will clone the gama data into the data subdirectory:
  
   svn co svn://osirion.org/osirion-data data
+
   git clone http://osirion.org/git/osirion-data data
  
 
You can also download the game data from the website:
 
You can also download the game data from the website:
 
   
 
   
* [http://osirion.org/files/osirion-latest-src.tar.bz2 osirion-latest-src.tar.bz2]
+
* [http://osirion.org/files/osirion-latest-data.zip osirion-latest-data.zip]
 +
 
 +
  wget http://osirion.org/files/osirion-latest-data.zip
 +
  unzip osirion-latest-data.zip
 +
 
 +
The data subdirectory should be inside the osirion directory, you can check if it's there:
  
The data subdirectory should be inside the osirion directory.
+
  ls -l data
  
 
=== Configuring the source code ===
 
=== Configuring the source code ===
  
Create the configure script:
+
If you cloned the git repository you need to create the configure script:
  
 
   autoreconf -i
 
   autoreconf -i
Line 172: Line 129:
 
Run the script to configure the source code:  
 
Run the script to configure the source code:  
  
   ./configure --with-bullet=/usr/local --enable-static-bullet
+
   ./configure
  
If you do not need the client and want to build the dedicated server only you can pass the --without-client option to configure:  
+
If you only want to build the dedicated server:
  
./configure --with-bullet=/usr/local --enable-static-bullet --without-client  
+
  ./configure --without-client  
  
If configure finds ncurses or pdcurses, the dedicated server will use this library and a have a curses console. To disable curses detection, pass the --without-curses option to configure.
+
To build a portable dedicated server:
  
  ./configure --with-bullet=/usr/local --enable-static-bullet --without-client --without-curses
+
./configure --without-client --enable-static-bullet --enable-static-stdlib --without-curses
  
You can use the --help option to get a list of all available options:
+
Use the --help option to get a list of all available options:
  
 
   ./configure --help
 
   ./configure --help
Line 213: Line 170:
 
=== Updating ===
 
=== Updating ===
  
If you used the subversion repository to build the game, there is no need to re-download the entire distribution when there are updates available. You can update your local copy and rebuild it.  
+
If you cloned the git repository to build the game, there is no need to re-download the entire distribution when there are updates available. You can update your local copy and rebuild it.  
  
 
Update the source code:  
 
Update the source code:  
Line 219: Line 176:
 
   cd osirion
 
   cd osirion
 
   make clean
 
   make clean
   svn update
+
   git pull
  
 
Update the game data:  
 
Update the game data:  
  
 
   cd data
 
   cd data
   svn update
+
   git pull
 
   cd ..  
 
   cd ..  
  
Line 235: Line 192:
 
== Source data ==
 
== Source data ==
  
There is a seperate SVN repository with files that are used to create game data,
+
There is a seperate repository with files that are used to create game data.
but are not necessary to run the game. These files include blender models, gimp files and scalable vector graphics. You do not need these filese of you want to try the game or run a dedicated server, but they can be of interest to contributers.
+
These files include blender models, gimp files and scalable vector graphics.  
 +
You do not need these of you just want to try the game or run a dedicated server,
 +
but they can be of interest to contributers.
  
To download the source data subversion repository:
+
To clone the source data git repository:
  
   svn checkout svn://osirion.org/osirion-data-src data-src
+
   git clone http://osirion.org/git/osirion-data-src data-src

Latest revision as of 17:31, 30 October 2021

There are packages with development builds available to serve as a platform for developers and contributors, or for those who are just curious about the current state of affairs.

The packages are usually lagging somewhat behind on actual development. If you feel courageous you can clone the git repository with the latest and greatest development revision and build your own binaries.

Installing the latest release

The quickest and easiest way to install Project::OSiRiON is by downloading the most recent development release. In general, you only need to download the release package and run the program.

Windows

Download the release package: there's a package for 32-bit windows and a package for 64-bit windows, you only need to download one of them. If you don't know which one to pick, the 32-bit is a safe choice, as it will also work on 64-bit windows systems.

Unzip the package to an aproriate location, a new folder will automaticaly be created.

Run Osirion.exe to start the game.

Linux

To run the game, you need a working OpenGL installation and the SDL and openal-soft libraries. Most likely, you already have these installed on your system. The package contains binaries for both 32-bit and 64-bit systems.

Extract the package to a suitable location, for example, /usr/local/games. A new directory called osirion-version-linux will automaticaly be created, the actual directory name depends on the version number.

 cd /usr/local/games
 tar jxvf /where/you/downloaded/osirion-latest-linux.tar.bz2
 cd osirion-version-linux

To run the 32-bit version:

 ./osirion.x86

To run the 64-bit version:

 ./osirion.x86_64

Building Prerequisites

To build Project::OSiRiON from source code you need a working C++ compiler and have the necessary libraries and header files installed. The official binaries are compiled with gcc on linux, and mingw on windows.

Dependencies

The following packages are required to build the the dedicated server:

Additionally, the client requires:

You will also need gcc, GNU make, automake and libtool.

Building on Debian

To build the game on Debian-based distributions, you can install the required tools and dependencies by running the following commands (As root) in a terminal window:

 apt-get install build-essential autoconf automake libtool libjpeg-dev libpng12-dev libvorbis-dev libglu1-mesa-dev libopenal-dev libsdl2-dev libbullet-dev

Building on Windows

You can build the game on windows using an MSYS2 environment. You can find more information on the MSyS2 homepage.

Building from source code

Obtaining the source code

You can get the latest source code from the git repository:

Use the git command line tool to clone the repository:

 git clone http://osirion.org/git/osirion-src osirion

Enter the new subdirectory:

 cd osirion

You can also download the source code package from the website:

 wget http://osirion.org/files/osirion-latest-src.tar.bz2
 tar jxf osirion-latest-src.tar.bz2
 cd osirion

Obtaining the game data

Get the latest game data from the git repository:

The following command will clone the gama data into the data subdirectory:

 git clone http://osirion.org/git/osirion-data data

You can also download the game data from the website:

 wget http://osirion.org/files/osirion-latest-data.zip
 unzip osirion-latest-data.zip

The data subdirectory should be inside the osirion directory, you can check if it's there:

 ls -l data

Configuring the source code

If you cloned the git repository you need to create the configure script:

 autoreconf -i

Run the script to configure the source code:

 ./configure

If you only want to build the dedicated server:

  ./configure --without-client 

To build a portable dedicated server:

./configure --without-client --enable-static-bullet --enable-static-stdlib --without-curses

Use the --help option to get a list of all available options:

 ./configure --help

Building the binaries

Compile the source code:

 make 

The binaries will be built in the src subdirectory of the main distribution.

Important: make install is not supported. Results are unpredictable.

Running

The client and the dedicated server will look for game data in the data subdirectory of the current working directory. Since the binaries have been built in the src subdirectory, you will have start them with the src/ prefix.

To start the client:

 src/osirion 

If the client opens a new window and immediatly close it again, it probably could not find the game data and exited. Check your installation.

To start the dedicated server:

 src/osiriond 

If you are using windows, the binaries will be called osirion.exe and osiriond.exe.

Updating

If you cloned the git repository to build the game, there is no need to re-download the entire distribution when there are updates available. You can update your local copy and rebuild it.

Update the source code:

 cd osirion
 make clean
 git pull

Update the game data:

 cd data
 git pull
 cd .. 

Build the binaries again:

 autoreconf
 ./configure
 make

Source data

There is a seperate repository with files that are used to create game data. These files include blender models, gimp files and scalable vector graphics. You do not need these of you just want to try the game or run a dedicated server, but they can be of interest to contributers.

To clone the source data git repository:

 git clone http://osirion.org/git/osirion-data-src data-src