Installation - Revision history

Ingar: The data package is a zip instead of a tar.bz2 now.

2021-10-30T17:31:18Z

The data package is a zip instead of a tar.bz2 now.

Ingar: Grammar

2020-06-27T11:51:20Z

Grammar

Ingar: /* Source data */

2020-05-02T20:53:30Z

‎Source data

Ingar at 20:40, 2 May 2020

2020-05-02T20:40:15Z

Ingar: /* Building from source code */ Updated build instructions, git usage.

2020-05-02T20:36:33Z

‎Building from source code: Updated build instructions, git usage.

Ingar: Removed Bullet section.

2020-05-02T20:18:50Z

Removed Bullet section.

Ingar: /* Building on Windows */ Replaced section with a note on MSYS2.

2020-05-02T20:16:03Z

‎Building on Windows: Replaced section with a note on MSYS2.

Ingar: /* Installing the latest release */ Updated to reflect the single archive installation.

2020-05-02T20:10:51Z

‎Installing the latest release: Updated to reflect the single archive installation.

Mega: /* Dependencies */

2016-03-21T19:17:56Z

‎Dependencies

Mega at 19:17, 21 March 2016

2016-03-21T19:17:00Z

@@ Line 112: / Line 112: @@
 You can also download the game data from the website:
-* [http://osirion.org/files/osirion-latest-data.tar.bz2 osirion-latest-data.tar.bz2]
+* [http://osirion.org/files/osirion-latest-data.zip osirion-latest-data.zip]
-   wget http://osirion.org/files/osirion-latest-data.tar.bz2
+   wget http://osirion.org/files/osirion-latest-data.zip
-   tar jxf osirion-latest-data.tar.bz2
+   unzip osirion-latest-data.zip
-The data subdirectory should be inside the osirion directory.
+The data subdirectory should be inside the osirion directory, you can check if it's there:
 === Configuring the source code ===

@@ Line 27: / Line 27: @@
 * Linux 32-bit and 64-bit: [http://osirion.org/files/osirion-latest-linux.tar.bz2 osirion-latest-linux.tar.bz2]
-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 depend on the version number).
+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

@@ Line 191: / Line 191: @@
 == 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.
-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

@@ 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,
-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.
 == Installing the latest release ==

@@ Line 80: / Line 80: @@
 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:
@@ Line 90: / Line 90: @@
    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://osirion.org/files/osirion-latest-src.tar.bz2 osirion-latest-src.tar.bz2]
 === 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:
-* [http://osirion.org/files/osirion-latest-src.tar.bz2 osirion-latest-src.tar.bz2]
+* [http://osirion.org/files/osirion-latest-data.tar.bz2 osirion-latest-data.tar.bz2]
 The data subdirectory should be inside the osirion directory.
@@ Line 116: / Line 120: @@
 === Configuring the source code ===
-Create the configure script:
+If you cloned the git repository you need to create the configure script:
    autoreconf -i
@@ Line 122: / Line 126: @@
 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
@@ Line 163: / Line 167: @@
 === 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:
@@ Line 169: / Line 173: @@
    cd osirion
    make clean
-   svn update
+   git pull
 Update the game data:
    cd data
-   svn update
+   git pull
    cd ..

@@ Line 62: / Line 62: @@
 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 (As root) in a terminal window:
@@ Line 73: / Line 73: @@
 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 from source code ==
@@ Line 101: / Line 78: @@
 === 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]

@@ Line 71: / Line 71: @@
 === 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.
 === Building the Bullet physics library ===

@@ Line 5: / Line 5: @@
 == Installing the latest release ==
-The quickest and easiest way to install Project::OSiRiON is by downloading the most recent development release. In general, you will need to download and extract 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.
 === 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.
 * Windows 32-bit: [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]
-Unzip the package to an approriate location, a new folder will automaticly be created.
+Unzip the package to an aproriate location, a new folder will automaticaly be created.
-Next you will have to download the game data.
+Run ''Osirion.exe'' to start the game.
 === Linux ===
-To run the game, you will need to have SDL installed. This is a fairly common
+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.
 * Linux 32-bit and 64-bit: [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).
+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 depend on the version number).
    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
 To run the 32-bit version:

@@ Line 69: / Line 69: @@
 * libjpeg
 * libpng
-* libSDL 1.2
+* libSDL 2
 * OpenGL
 * [http://connect.creativelabs.com/openal/Downloads/Forms/AllItems.aspx OpenAL] or [http://kcat.strangesoft.net/openal.html OpenAL Soft]

@@ Line 81: / Line 81: @@
 by running the following commands (As root) in a terminal window:
-   apt-get install build-essential
+   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 ===
@@ Line 96: / Line 89: @@
 === Building the Bullet physics library ===
 The engine uses the [http://www.bulletphysics.com/ Bullet Physics library] for physics support. You can download the bullet source code here: