Installing the game data under Linux: Difference between revisions

From Arx Libertatis Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
Tag: Manual revert
 
(30 intermediate revisions by 2 users not shown)
Line 4: Line 4:


= Extracting the data =
= 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]].


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


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.
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.
Line 17: Line 25:
  $ arx-install-data
  $ arx-install-data


If you prefer a command-line interface, run
If you prefer a graphical interface (needs KDialog, Zenity or Xdialog), run


  $ arx-install-data --cli
  $ arx-install-data --gui


Additional options are documented in the help output:
Additional options are documented in the help output:
Line 27: Line 35:
If your installation of Arx Libertatis didn't come with the data install script, you can get it here:
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
  $ wget https://arx.vg/arx-install-data
  $ chmod +x arx-install-data
  $ chmod +x arx-install-data
  $ ./arx-install-data
  $ ./arx-install-data
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"
Replace the path with where your innoextract binary is and remember that this will only affect the current shell session.


=== Original CD ===
=== Original CD ===


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>, {{Icon|innoextract}} <b>[http://constexpr.org/innoextract/ innoextract]</b> and <b>md5sum</b> programs.
To install from a retail Arx Fatalis CD, you need
* <b>[https://libarchive.org/ bsdtar]</b> with libarchive 3.1+ ''or'' <b>[https://cabextract.org.uk/ cabextract]</b>
* {{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 directory where the CD is mounted.
  $ 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.
Alternatively, you can run the script as
 
  $ arx-install-data /path/to/mount/point
 
Or you could install Arx Fatalis using Wine and then [[#Already installed data|install from that]].
 
=== [https://www.gog.com/ GOG.com] setup ===
 
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>


Fist download the 1.21 patch:
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.
$ wget http://arx.vg/ArxFatalis_1.21_MULTILANG.exe


Now download the install-cd script (and required data files) and make it executable:
Alternatively, you can run the script as
$ 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 [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.
$ arx-install-data /path/to/setup_arx_fatalis.exe


In case you mounted/extracted the CD / .iso manually, run the script as
Or you could install Arx Fatalis using Wine and then [[#Already installed data|install from that]].
$ ./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).
=== Already installed data ===


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 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.
$ rm ArxFatalis_1.21_MULTILANG.exe install-verify install-cd


=== [http://gog.com GOG.com] setup ===
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.


For the setup file downloaded from {{Icon|gog}} GOG.com, you need to use the <b>install-gog</b> script, which requires the {{Icon|innoextract}} <b>[http://constexpr.org/innoextract/ innoextract]</b> program.
Fot the Japanese version you might also need
* <b>[https://github.com/twogood/unshield unshield]</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 directory where Arx Fatalis is installed.
$ 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.
Alternatively, you can run the script as


First, download the install-gog script (and required data files) and make it executable:
  $ arx-install-data /path/to/arx/fatalis/install/directory
  $ wget http://arx.vg/scripts/install-verify
$ wget http://arx.vg/scripts/install-gog
$ chmod +x install-gog


Then run it as
Steam installs Arx Fatalis at <i>"path/to/Steam/<b>steamapps/common/arx fatalis/</b>"</i>.
$ ./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:
<span id="Demo"></span>
$ rm install-verify install-gog


=== Already installed data ===
=== English Demo ===


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


First, download the install-copy script (and required data files) and make it executable:
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.
$ wget http://arx.vg/scripts/install-verify
$ wget http://arx.vg/scripts/install-copy
$ chmod +x install-copy


Then, run the script as
Alternatively, you can run the script as
$ ./install-copy path/to/ArxFatalis/ ~/.local/share/arx


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) and replace <i>path/to/ArxFatalis/</i> with the path to your Arx Fatalis installation (containing the .pak files).
$ arx-install-data /path/to/arxdemoenglish.zip


Steam installs Arx Fatalis at <i>"path/to/Steam/<b>steamapps/common/arx fatalis/</b>"</i>. Remember to either quote the full path or escape the space!
Or you could install the Arx Fatalis demo using Wine and then [[#Already installed data|install from that]].


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:
=== Japanese Demo ===
$ rm install-verify install-copy


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


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>.
Then run the install script as described above and use the interactive mode to select the <code>arx_jpn_demo.exe</code> file.


First, download the install-demo script and make it executable:
Alternatively, you can run the script as
$ wget http://arx.vg/scripts/install-demo
$ chmod +x install-demo


Then, run the script as
  $ arx-install-data /path/to/arx_jpn_demo.exe
  $ ./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:
Or you could install the Arx Fatalis demo using Wine and then [[#Already installed data|install from that]].
$ rm install-demo


== Wine ==
== 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.
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.
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.
Line 123: Line 127:
= Install locations =
= 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>.
The <code>arx-install-data</code> provides you with a suitable data directory. Simply using the first listed one should be fine.


Alternatively, you may put the data files in the user directory at <b>~/.local/share/arx</b>
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]].


The exact locations depend on the XDG environment variables and may be adjusted when compiling arx - see [[Data directories]].
Alternatively, you may put the data files in the user directory (usually at <b>~/.local/share/arx</b>).


You can also put the data into any directory you want and then run the game from there.
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.

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.