Installing the game data under Linux: Difference between revisions

From Arx Libertatis Wiki
Jump to navigation Jump to search
No edit summary
Line 1: Line 1:
Once you have [[Getting the game data|acquired the game data]], you will have to put it in a location searched by arx.
Once you have [[Getting the game data|acquired the game data]], you will have to put it in a location searched by arx.


= Install locations =
This page is written with Linux in mind, but the procedure should be similar for other UNIX-like operating systems like FreeBSD.
 
= Extracting the data =
 
== Install script ==
 
The easiest way to install the Arx Fatalis data for use by Arx Libertatis is by using the install script. The script needs either <b>KDialog</b>, <b>Zenity</b>, <b>Xdialog</b> or a graphical terminal emulator to functions.


Arx Libertatis will look for your data files in multiple directories according to the [http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html XDG Base Directory Specification] - usually <b>/usr/share/games/arx</b> and <b>/usr/local/share/games/arx</b>.
If Arx Libertatis detects that there are missing data files, the installer should automatically be started for you - simply select your source file or directory.


Alternatively, you may put the data files in the user directory at <b>~/.local/share/arx</b>
You might also need some additional programs to extract the data. In that case the installer tell you which ones are needed - install them and try again.


The exact locations depend on the XDG environment variables and may be adjusted when compiling arx - see [[Data directories]].
You can also start the installer manually by running


You can also put the data into any directory you want and then run the game from there.
$ arx-install-data


= Extracting the data =
If you prefer a command-line interface, run


== Wine ==
$ arx-install-data --cli


Like on Windows, the game data can be extracted by installing the game normally under {{Wine}}. If you choose this option, be sure to apply the [http://www.arkane-studios.com/uk/arx_downloads.php 1.21 patch] and then rename all files to lowercase. Also verify that you have all the [[Required data files and checksums|required data files]]. Also see the [[#Already installed data|Already installed data]] section.
Additional options are documented in the help output:


However, Wine is a big dependency just to extract the game data and cannot always be used. Because of that, we provide scripts to extract the game data under linux without Wine.
$ arx-install-data --help


== Install scripts ==
If your installation of Arx Libertatis didn't come with the data install script, you can get it here:


There are three different scripts that need to be used depending depending on where you got arx, all located in the scripts directory of the Arx Libertatis source code.
$ wget http://arx.vg/arx-install-data
$ chmod +x arx-install-data
$ ./arx-install-data


=== Original CD ===
=== Original CD ===
Line 106: Line 114:
If you have the <b>md5sum</b> program installed, the script will verify the output files at the and print "Checksum matched." at the end on success. If everything went well, remove any files that aren't needed anymore:
If you have the <b>md5sum</b> program installed, the script will verify the output files at the and print "Checksum matched." at the end on success. If everything went well, remove any files that aren't needed anymore:
  $ rm install-demo
  $ rm install-demo
== Wine ==
Like on Windows, the game data can be extracted by installing the game normally under {{Wine}}. If you choose this option, be sure to apply the [http://www.arkane-studios.com/uk/arx_downloads.php 1.21 patch] and then rename all files to lowercase. Also verify that you have all the [[Required data files and checksums|required data files]]. Also see the [[#Already installed data|Already installed data]] section.
However, Wine is a big dependency just to extract the game data and cannot always be used. Because of that, we provide scripts to extract the game data under linux without Wine.
= Install locations =
Arx Libertatis will look for your data files in multiple directories according to the [http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html XDG Base Directory Specification] - usually <b>/usr/share/games/arx</b> and <b>/usr/local/share/games/arx</b>.
Alternatively, you may put the data files in the user directory at <b>~/.local/share/arx</b>
The exact locations depend on the XDG environment variables and may be adjusted when compiling arx - see [[Data directories]].
You can also put the data into any directory you want and then run the game from there.

Revision as of 15:05, 31 March 2013

Once you have acquired the game data, you will have to put it in a location searched by arx.

This page is written with Linux in mind, but the procedure should be similar for other UNIX-like operating systems like FreeBSD.

Extracting the data

Install script

The easiest way to install the Arx Fatalis data for use by Arx Libertatis is by using the install script. The script needs either KDialog, Zenity, Xdialog or a graphical terminal emulator to functions.

If Arx Libertatis detects that there are missing data files, the installer should automatically be started for you - simply select your source file or directory.

You might also need some additional programs to extract the data. In that case the installer tell you which ones are needed - install them and try again.

You can also start the installer manually by running

$ arx-install-data

If you prefer a command-line interface, run

$ arx-install-data --cli

Additional options are documented in the help output:

$ arx-install-data --help

If your installation of Arx Libertatis didn't come with the data install script, you can get it here:

$ wget http://arx.vg/arx-install-data
$ chmod +x arx-install-data
$ ./arx-install-data

Original CD

For an Arx Fatalis CD, you need to use the install-cd script, which requires the cabextract, innoextract and md5sum programs.

If you compiled innoextract yourself, you will need to make sure the script finds it by adding the containing directory to your PATH environment variable:

$ export PATH="/path/to/directory/containing/innoextract/:$PATH"

Replace the path with where your innoextract binary is and remember that this will only affect the current shell session.

Fist download the 1.21 patch:

$ wget http://arx.vg/ArxFatalis_1.21_MULTILANG.exe

Now download the install-cd script (and required data files) and make it executable:

$ wget http://arx.vg/scripts/install-verify
$ wget http://arx.vg/scripts/install-cd
$ chmod +x install-cd

To run the script, you will need either fuseiso, isoinfo from cdrkit / cdrtools, give the script root access, or mount/extract the CD/.iso manually.

In case you mounted/extracted the CD / .iso manually, run the script as

$ ./install-cd path/to/mount/point/ ArxFatalis_1.21_MULTILANG.exe ~/.local/share/arx

Otherwise, if you have a physical CD, run

$ ./install-cd /dev/cdrom ArxFatalis_1.21_MULTILANG.exe ~/.local/share/arx

For an .iso file run

$ ./install-cd path/to/arx.iso ArxFatalis_1.21_MULTILANG.exe ~/.local/share/arx

In either case, replace ~/.local/share/arx with the directory where you want to extract the data to (will be created if it doesn't exist).

The script will verify the output files at the and print "Checksum matched." at the end on success. If everything went well, remove any files that aren't needed anymore:

$ rm ArxFatalis_1.21_MULTILANG.exe install-verify install-cd

GOG.com setup

For the setup file downloaded from GOG.com, you need to use the install-gog script, which requires the innoextract program.

If you compiled innoextract yourself, you will need to make sure the script finds it by adding the containing directory to your PATH environment variable:

$ export PATH="/path/to/directory/containing/innoextract/:$PATH"

Replace the path with where your innoextract binary is and remember that this will only affect the current shell session.

First, download the install-gog script (and required data files) and make it executable:

$ wget http://arx.vg/scripts/install-verify
$ wget http://arx.vg/scripts/install-gog
$ chmod +x install-gog

Then run it as

$ ./install-gog path/to/setup_arx_fatalis.exe ~/.local/share/arx

Replace path/to/setup_arx_fatalis.exe with the path to the setup file you downloaded from GOG.com and ~/.local/share/arx with the directory where you want to extract the data to (will be created if it doesn't exist).

If you have the md5sum program installed, the script will verify the input and output files at the and print "Checksum matched." at the end on success. If everything went well, remove any files that aren't needed anymore:

$ rm install-verify install-gog

Already installed data

If you already installed Arx Fatalis including the 1.21 patch (such as the Steam version - it's fully patched), you can use the install-copy script to copy the data, rename files to lowercase and verify checksums.

First, download the install-copy script (and required data files) and make it executable:

$ wget http://arx.vg/scripts/install-verify
$ wget http://arx.vg/scripts/install-copy
$ chmod +x install-copy

Then, run the script as

$ ./install-copy path/to/ArxFatalis/ ~/.local/share/arx

Replace ~/.local/share/arx with the directory where you want to extract the data to (will be created if it doesn't exist) and replace path/to/ArxFatalis/ with the path to your Arx Fatalis installation (containing the .pak files).

Steam installs Arx Fatalis at "path/to/Steam/steamapps/common/arx fatalis/". Remember to either quote the full path or escape the space!

The script will verify the output files at the and print "Checksum matched." at the end on success. If everything went well, remove any files that aren't needed anymore:

$ rm install-verify install-copy

Demo

To extract the Arx Fatalis demo, you need to use the install-demo script, which requires the cabextract program and bsdtar (from libarchive) or unzip.

First, download the install-demo script and make it executable:

$ wget http://arx.vg/scripts/install-demo
$ chmod +x install-demo

Then, run the script as

$ ./install-demo path/to/arx_demo_english.zip ~/.local/share/arx

Replace path/to/arx_demo_english.zip with the path to the demo archive and ~/.local/share/arx with the directory where you want to extract the demo data to (will be created if it doesn't exist).

If you have the md5sum program installed, the script will verify the output files at the and print "Checksum matched." at the end on success. If everything went well, remove any files that aren't needed anymore:

$ rm install-demo

Wine

Like on Windows, the game data can be extracted by installing the game normally under Wine. If you choose this option, be sure to apply the 1.21 patch and then rename all files to lowercase. Also verify that you have all the required data files. Also see the Already installed data section.

However, Wine is a big dependency just to extract the game data and cannot always be used. Because of that, we provide scripts to extract the game data under linux without Wine.

Install locations

Arx Libertatis will look for your data files in multiple directories according to the XDG Base Directory Specification - usually /usr/share/games/arx and /usr/local/share/games/arx.

Alternatively, you may put the data files in the user directory at ~/.local/share/arx

The exact locations depend on the XDG environment variables and may be adjusted when compiling arx - see Data directories.

You can also put the data into any directory you want and then run the game from there.