Installing the game data under Linux: Difference between revisions

From Arx Libertatis Wiki
Jump to navigation Jump to search
mNo edit summary
Tag: Manual revert
 
(43 intermediate revisions by 2 users not shown)
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 =
 
== [[File:Arch_icon.png|24px|]] Arch Linux ==
 
Arch users can use the <b>[https://aur.archlinux.org/packages/arx-fatalis-data-demo/ arx-fatalis-data-demo]</b>, <b>[https://aur.archlinux.org/packages/arx-fatalis-data-gog/ arx-fatalis-data-gog]</b> or <b>[https://aur.archlinux.org/packages/arx-fatalis-data-copy/ arx-fatalis-data-copy]</b> package. There is no package to install from the CD, but you can use the regular [[#Install script|install script]] - either install to a standard location or combine it with <b>[https://aur.archlinux.org/packages/arx-fatalis-data-copy/ arx-fatalis-data-copy]</b>.
 
== [[File:Gentoo_icon.png|24px|]] Gentoo ==
 
Gentoo users can use the <b>[https://gpo.zugaina.org/games-rpg/arx-fatalis-data games-rpg/arx-fatalis-data]</b> (CD or GOG.com installer) or <b>[https://gpo.zugaina.org/games-rpg/arx-fatalis-demo games-rpg/arx-fatalis-demo]</b> package from the [https://github.com/arx/ArxGentoo <b>arx-libertatis</b> overlay]. There is no package to install from an existing Arx Fatalis install such as from Steam, but you can use the regular [[#Install script|install script]].


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>.
== Install script ==


Alternatively, you may put the data files in the user directory at <b>~/.local/share/arx</b>
The easiest way to install the Arx Fatalis data for use by Arx Libertatis is by using the install script. When not run from a terminal, the script needs either <b>KDialog</b>, <b>Zenity</b>, <b>Xdialog</b>, or a graphical terminal emulator to functions.


The exact locations depend on the XDG environment variables and may be adjusted when compiling arx - see [[Data directories]].
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 can also put the data into any directory you want and then run the game from there.
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.


= Extracting the data =
You can also start the installer manually by running


== Wine ==
$ arx-install-data


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.
If you prefer a graphical interface (needs KDialog, Zenity or Xdialog), run


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 --gui


== Install scripts ==
Additional options are documented in the help output:


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.
$ arx-install-data --help


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


For an Arx Fatalis CD, you need to use the <b>install-cd</b> script, which requires the <b>[http://www.cabextract.org.uk/ cabextract]</b>, <b>[http://innoextract.constexpr.org/ innoextract]</b> and <b>md5sum</b> programs.
$ wget https://arx.vg/arx-install-data
$ chmod +x arx-install-data
$ ./arx-install-data


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:
Depending on where you got your Arx fatalis data From, you might need the {{Icon|innoextract}} <b>[https://constexpr.org/innoextract/ innoextract]</b> program so that the installer can extract it. If you didn't install innoextract through the package manager, you might 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"
  $ 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.
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:
=== Original CD ===
$ wget http://download.zenimax.com/arxfatalis/patches/1.21/ArxFatalis_1.21_MULTILANG.exe
<font color=red><b>IMPORTANT:</b></font> <i>install-cd</i> can use the MULTILANG patch only for english, german and italian game data. For other localization you will need to download the correct version of the patch and use that instead. Please update [[Required data files and checksums]] with the checksums for your language, so that it can be included in future versions of the script.


Now download the install-cd script (and required data files) and make it executable:
To install from a retail Arx Fatalis CD, you need
$ wget https://github.com/arx/ArxLibertatis/raw/master/scripts/data-en.md5
* <b>[https://libarchive.org/ bsdtar]</b> with libarchive 3.1+ ''or'' <b>[https://cabextract.org.uk/ cabextract]</b>
$ wget https://github.com/arx/ArxLibertatis/raw/master/scripts/data-de.md5
* {{Icon|innoextract}} <b>[https://constexpr.org/innoextract/ innoextract]</b>
$ wget https://github.com/arx/ArxLibertatis/raw/master/scripts/data-it.md5
$ wget https://github.com/arx/ArxLibertatis/raw/master/scripts/install-cd
$ chmod +x install-cd
You only need the "data-*.md5" file for your language, all other .md5 files can be skipped.


To run the script, you will need either [http://fuseiso.sourceforge.net/ fuseiso], isoinfo from [http://cdrkit.org/ cdrkit] / [http://cdrecord.berlios.de/ cdrtools], give the script root access, or mount/extract the CD/.iso manually.
Then run the install script as described above and use the interactive mode to select the directory where the CD is mounted.


In case you mounted/extracted the CD / .iso manually, run the script as
Alternatively, you can 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 <i>~/.local/share/arx</i> with the directory where you want to extract the data to (will be created if it doesn't exist).
$ arx-install-data /path/to/mount/point


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:
Or you could install Arx Fatalis using Wine and then [[#Already installed data|install from that]].
$ rm ArxFatalis_1.21_MULTILANG.exe data-en.md5 data-de.md5 data-it.md5 install-cd


=== [http://gog.com GOG.com] setup ===
=== [https://www.gog.com/ GOG.com] setup ===


For the setup file downloaded from GOG.com, you need to use the <b>install-gog</b> script, which requires <b>[http://innoextract.constexpr.org/ innoextract]</b> program.
To install from a setup file downloaded from <b>[https://www.gog.com/en/gamecard/arx_fatalis GOG.com]</b>, you need
* {{Icon|innoextract}} <b>[https://constexpr.org/innoextract/ innoextract]</b>


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:
Then run the install script as described above and use the interactive mode to select the <code>setup_arx_fatalis.exe</code> or <code>setup_arx_fatalis_2.0.0.7.exe</code> file.
$ 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:
Alternatively, you can run the script as
$ wget https://github.com/arx/ArxLibertatis/raw/master/scripts/data-en.md5
$ wget https://github.com/arx/ArxLibertatis/raw/master/scripts/install-gog
$ chmod +x install-gog


Then run it as
  $ arx-install-data /path/to/setup_arx_fatalis.exe
  $ ./install-gog path/to/setup_arx_fatalis.exe ~/.local/share/arx
Replace <i>path/to/setup_arx_fatalis.exe</i> with the path to the setup file you downloaded from GOG.com and <i>~/.local/share/arx</i> with the directory where you want to extract the data to (will be created if it doesn't exist).


If you have the <b>md5sum</b> 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:
Or you could install Arx Fatalis using Wine and then [[#Already installed data|install from that]].
$ rm data-en.md5 install-gog


=== Already installed data ===
=== Already installed data ===


If you already installed Arx Fatalis, you can use the <b>install-copy</b> script to copy the data, rename files to lowercase and verify checksums.
If you already installed Arx Fatalis (such as the <b>[https://store.steampowered.com/app/1700/Arx_Fatalis/ Steam]</b> version), you can use the <b><code>arx-install-data</code></b> script to copy the data, rename files to lowercase and verify checksums.
 
Unless the data is already patched, you will need
* {{Icon|innoextract}} <b>[https://constexpr.org/innoextract/ innoextract]</b>
to extract the 1.21 patch. This does not apply to the <b>Steam</b> and <b>GOG.com</b> versions - they are already fully patched.
 
Fot the Japanese version you might also need
* <b>[https://github.com/twogood/unshield unshield]</b>
 
Then run the install script as described above and use the interactive mode to select the directory where Arx Fatalis is installed.


First, download the install-copy script (and required data files) and make it executable:
Alternatively, you can run the script as
$ wget https://github.com/arx/ArxLibertatis/raw/master/scripts/data-en.md5
$ wget https://github.com/arx/ArxLibertatis/raw/master/scripts/data-de.md5
$ wget https://github.com/arx/ArxLibertatis/raw/master/scripts/data-it.md5
$ wget https://github.com/arx/ArxLibertatis/raw/master/scripts/data-demo.md5
$ wget https://github.com/arx/ArxLibertatis/raw/master/scripts/install-copy
$ chmod +x install-copy
You only need the "data-*.md5" file for your version of Arx Fatalis, all other .md5 files can be skipped.


Then, run the script as
  $ arx-install-data /path/to/arx/fatalis/install/directory
  $ ./install-copy path/to/ArxFatalis/ ~/.local/share/arx


Replace <i>path/to/ArxFatalis/</i> with the path to your Arx Fatalis installation (containing the .pak files) and <i>~/.local/share/arx</i> with the directory where you want to extract the data to (will be created if it doesn't exist).
Steam installs Arx Fatalis at <i>"path/to/Steam/<b>steamapps/common/arx fatalis/</b>"</i>.


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:
<span id="Demo"></span>
$ rm data-en.md5 data-de.md5 data-it.md5 data-demo.md5 install-copy


=== Demo ===
=== English Demo ===
 
To install the English demo data, you need
* <b>[https://libarchive.org/ bsdtar]</b> ''or'' <b>[http://infozip.sourceforge.net/ unzip]</b>
* <b>[https://libarchive.org/ bsdtar]</b> with libarchive 3.1+ ''or'' <b>[https://cabextract.org.uk/ cabextract]</b>
 
Then run the install script as described above and use the interactive mode to select the <code>arx_demo_english.zip</code> or <code>arxdemoenglish.zip</code> file.
 
Alternatively, you can run the script as
 
$ arx-install-data /path/to/arxdemoenglish.zip
 
Or you could install the Arx Fatalis demo using Wine and then [[#Already installed data|install from that]].
 
=== Japanese Demo ===
 
To install the Japanese demo data, you need
* <b>[https://github.com/twogood/unshield unshield]</b>
* <b>[https://libarchive.org/ bsdtar]</b> with libarchive 3.1+ ''or'' <b>[https://cabextract.org.uk/ cabextract]</b>
 
Then run the install script as described above and use the interactive mode to select the <code>arx_jpn_demo.exe</code> file.
 
Alternatively, you can run the script as
 
$ arx-install-data /path/to/arx_jpn_demo.exe
 
Or you could install the Arx Fatalis demo using Wine and then [[#Already installed data|install from that]].
 
== Wine ==
 
Like on Windows, the game data can be extracted by installing the game normally under {{Wine}}. Then either see the [[#Already installed data|Already installed data]] section, or manually apply the [https://web.archive.org/web/20180105233341/https://www.arkane-studios.com/uk/arx_downloads.php 1.21 patch] and rename all files to lowercase. Also verify that you have all the [[Required data files and checksums|required data files]].
 
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 =


To extract the [[Getting the game data#Demo|Arx Fatalis demo]], you need to use the <b>install-demo</b> script, which requires the <b>[http://www.cabextract.org.uk/ cabextract]</b> program and <b>bsdtar</b> (from [http://libarchive.github.com/ libarchive]) or <b>[http://www.info-zip.org/ unzip]</b>.
The <code>arx-install-data</code> provides you with a suitable data directory. Simply using the first listed one should be fine.


First, download the install-demo script (and required data files) and make it executable:
Arx Libertatis will look for your data files in multiple directories according to the [https://specifications.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> - [[Data directories|as well as a few others]].
$ wget https://github.com/arx/ArxLibertatis/raw/master/scripts/data-demo.md5
$ wget https://github.com/arx/ArxLibertatis/raw/master/scripts/install-demo
$ chmod +x install-demo


Then, run the script as
Alternatively, you may put the data files in the user directory (usually at <b>~/.local/share/arx</b>).
$ ./install-demo path/to/arx_demo_english.zip ~/.local/share/arx
Replace <i>path/to/arx_demo_english.zip</i> with the path to the demo archive and <i>~/.local/share/arx</i> with the directory where you want to extract the demo data to (will be created if it doesn't exist).


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:
You can also put the data into any directory you want and then point the game to that using the <code>--data-dir</code> command-line option.
$ rm data-demo.md5 install-demo

Latest revision as of 10:47, 29 August 2022

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

Arch icon.png Arch Linux

Arch users can use the arx-fatalis-data-demo, arx-fatalis-data-gog or arx-fatalis-data-copy package. There is no package to install from the CD, but you can use the regular install script - either install to a standard location or combine it with arx-fatalis-data-copy.

Gentoo icon.png Gentoo

Gentoo users can use the games-rpg/arx-fatalis-data (CD or GOG.com installer) or games-rpg/arx-fatalis-demo package from the arx-libertatis overlay. There is no package to install from an existing Arx Fatalis install such as from Steam, but you can use the regular install script.

Install script

The easiest way to install the Arx Fatalis data for use by Arx Libertatis is by using the install script. When not run from a terminal, 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 graphical interface (needs KDialog, Zenity or Xdialog), run

$ arx-install-data --gui

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 https://arx.vg/arx-install-data
$ chmod +x arx-install-data
$ ./arx-install-data

Depending on where you got your Arx fatalis data From, you might need the innoextract program so that the installer can extract it. If you didn't install innoextract through the package manager, you might 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.

Original CD

To install from a retail Arx Fatalis CD, you need

Then run the install script as described above and use the interactive mode to select the directory where the CD is mounted.

Alternatively, you can run the script as

$ arx-install-data /path/to/mount/point

Or you could install Arx Fatalis using Wine and then install from that.

GOG.com setup

To install from a setup file downloaded from GOG.com, you need

Then run the install script as described above and use the interactive mode to select the setup_arx_fatalis.exe or setup_arx_fatalis_2.0.0.7.exe file.

Alternatively, you can run the script as

$ arx-install-data /path/to/setup_arx_fatalis.exe

Or you could install Arx Fatalis using Wine and then install from that.

Already installed data

If you already installed Arx Fatalis (such as the Steam version), you can use the arx-install-data script to copy the data, rename files to lowercase and verify checksums.

Unless the data is already patched, you will need

to extract the 1.21 patch. This does not apply to the Steam and GOG.com versions - they are already fully patched.

Fot the Japanese version you might also need

Then run the install script as described above and use the interactive mode to select the directory where Arx Fatalis is installed.

Alternatively, you can run the script as

$ arx-install-data /path/to/arx/fatalis/install/directory

Steam installs Arx Fatalis at "path/to/Steam/steamapps/common/arx fatalis/".

English Demo

To install the English demo data, you need

Then run the install script as described above and use the interactive mode to select the arx_demo_english.zip or arxdemoenglish.zip file.

Alternatively, you can run the script as

$ arx-install-data /path/to/arxdemoenglish.zip

Or you could install the Arx Fatalis demo using Wine and then install from that.

Japanese Demo

To install the Japanese demo data, you need

Then run the install script as described above and use the interactive mode to select the arx_jpn_demo.exe file.

Alternatively, you can run the script as

$ arx-install-data /path/to/arx_jpn_demo.exe

Or you could install the Arx Fatalis demo using Wine and then install from that.

Wine

Like on Windows, the game data can be extracted by installing the game normally under Wine. Then either see the Already installed data section, or manually apply the 1.21 patch and rename all files to lowercase. Also verify that you have all the required data files.

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

The arx-install-data provides you with a suitable data directory. Simply using the first listed one should be fine.

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 - as well as a few others.

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

You can also put the data into any directory you want and then point the game to that using the --data-dir command-line option.