Linux installation

## Installation

The following tutorial was tested on a **SAMSUNG 300V5Z x64 Ubuntu 13.04 with Intel i5 2.50 GHz, 6GB DDR3 RAM and nVidia GeForce GT 520MX** running high graphics with **Bumblebee**.

The process may differ based on your linux distro and your machine! For any inquiries contact Koonschi or Akagetsu

### Basic Install and Run

*Assuming you want to download the file into your Downloads folder, unpack it and directly play it from there, follow the next steps:*

* Download **the most recent linux archive** from the Avorion Downloads Section.
* Open up terminal and go to the folder where you have downloaded the game using the command **cd**.
For example

```
cd Downloads/
```

* Now to unpack archive, write:

```
tar -vzxf Avorionv0.7.tar.gz
```

* Now you want to go into the folder that has been created, by writing in the terminal

```
cd Avorion/
```

#### Default

Usually you should be able to run the game by typing

```
sh client.sh
```

#### BumbleBee

If you have bumblebee installed on your system, you will have to type this in the terminal to run the game:

```
optirun client.sh
```

### Advanced Install, Run and Shortcut

*Assuming you want to download the file, move it to /opt/, unpack it, create executable for it in /bin/ and then make a dash icon for it, follow the next steps:*

* Download **Avorion0.5.tar.gz** from the Avorion Downloads Section.
* Now, move the downloaded archive to **/opt/**

```
sudo mv Downloads/Avorionv0.5.tar.gz /opt/
```

* Now, move to the **/opt/** folder

```
 cd /opt/
```

* Now, unpack the archive

```
 sudo tar -vzxf Avorionv0.5.tar.gz
```

* *(This step is optional)* If you want to remove the archive

```
 sudo rm Avorionv0.5.tar.gz
```

* Go back to your desktop and create a file by the name of **Avorion**

```
 cd
 cd Desktop
 touch Avorion

```

* Use your favourite text editor to open the file

```
 gedit Avorion
```

* Inside the file write the following:

```
#!/bin/bash

cd /opt/Avorion/ && optirun ./client.sh
```

* **(Attention!)** You only have to write **optirun** if you are running **Bumblebee**!

* Save and exit the file
* Move the file in **/bin/**

```
sudo mv Avorion /bin/
```

* Change the access permissions on the file

```
sudo chmod a+x /bin/Avorion
```

* ***(Important!)*** At this stage you can simply type *Avorion* in your terminal and the game will run.

* In order to create a dash Icon you should first choose an image (any format)
* For this example I will be using this Open Source image I have found on the internet.
* After you download the image, assuming you are still in your Desktop folder, **cd** to your Downloads folder by using

```
 cd
 cd Downloads
```

* Now you want to add the image to your game folder

```
 sudo mv hal_9000.png /opt/Avorion/
```

* Now you have to create a file called '*avorion.desktop* in the folder you are currently in

```
 touch avorion.desktop
```

* Open it up using your favourite text editor

```
 gedit avorion.desktop
```

* And add the following inside the file

```
 [Desktop Entry]
 Name=Avorion0.5
 Type=Application
 Exec=Avorion
 Terminal=false
 Icon=/opt/Avorion/hal_9000.png
 Comment=Space Sandbox Computer Game
 NoDisplay=false
 Categories=Game
 Name[en]=Avorion
```

* Save, then move the file to your **/usr/share/applications/** folder

```
 sudo mv avorion.desktop /usr/share/applications/
```

* Now press the **Super** key or click on the dash icon and type **Avorion** and the file should be there for you to click on or drag to your launchbar.

## Troubleshooting

### Libraries missing

Avorion requires several additional libraries to run.
Avorion mainly needs the following libraries to run properly:

* SDL2
* SDL2\_mixer
* SDL2\_image
* png
* freetype
* GLEW
* sndfile

Those libraries have been included in the downloadable .tar.gz archive for the user's convenience.
Basically, Avorion should run out-of-the-box, without having to install additional libraries.

In case you get an error like

```
error while loading shared libraries: libXXXXX.so.**: cannot open shared object file: No such file or directory
```

Then you don't have libraries installed that are required by the above libraries.

To solve this,

* Install the missing library from your official repos, if you haven't already.

If this library isn't available or it still won't work after installing it, then one of more of the packaged libraries (most likely one of the SDL2 libs) is incompatible with your linux distro.
To solve this,

* **Install** the libraries required by the game from your official repos one by one, and **delete** its counterpart that is packaged with the game from the Avorion/bin/ folder.
	+ **Example:** On my **Arch Linux** install, I had to **remove** the **libSDL2.so** **libSDL2\_mixer.so** **libSDL2\_image.so**, **libfreetype.so** and **libsndfile.so** from the Avorion/bin/ folder.
	+ I **installed** those via the package and **left** **libpng.so** and **libGLEW.so** in the Avorion/bin/ folder.
	+ After that I could run the game without problems.