Linux installation

From Avorion Wiki
Jump to: navigation, search

Installation[edit | edit source]

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[edit | edit source]

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[edit | edit source]

Usually you should be able to run the game by typing

sh client.sh 

BumbleBee[edit | edit source]

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[edit | edit source]

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[edit | edit source]

Libraries missing[edit | edit source]

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.