Difference between revisions of "Installation on Linux"

From VCMI Project Wiki
Jump to: navigation, search
m (Elaborating on the data directory location.)
(Replaced content with "{{Template:MovedToWebpage|https://vcmi.eu/players/Installation_Linux/}}")
 
(92 intermediate revisions by 11 users not shown)
Line 1: Line 1:
VCMI requires data from original Heroes 3: Shadow of Death or Complete editions. Data from native Linux version made by LOKI will not work.
+
{{Template:MovedToWebpage|https://vcmi.eu/players/Installation_Linux/}}
All links are for VCMI 0.88
 
= Binaries installation =
 
== Debian-based distibutives ==
 
Download and install package for your distributive. To install package along with all dependencies:
 
<pre>
 
sudo dpkg -i downloaded_package.deb
 
sudo apt-get -f install
 
</pre>
 
Note: First command most probably will result in errors - this is normal behavior, all of them should be fixed by apt-get
 
 
 
=== Packages ===
 
* [http://dl.dropbox.com/u/22372764/vcmi/packages/vcmi_0.88_oneiric_i386.deb Ubuntu 11.10 (oneiric) 32 bit]
 
* [http://dl.dropbox.com/u/22372764/vcmi/packages/vcmi_0.88_oneiric_amd64.deb Ubuntu 11.10 (oneiric) 64 bit]
 
* [http://dl.dropbox.com/u/22372764/vcmi/packages/vcmi_0.88_sid_i386.deb Debian testing/sid 32 bit]
 
* [http://dl.dropbox.com/u/22372764/vcmi/packages/vcmi_0.88_sid_amd64.deb Debian testing/sid 64 bit]
 
 
 
=== Other Debian-based distibutives ===
 
VCMI requires g++-4.5 and boost-1.46 which are unavailable on Debian stable and Ubuntu 10.10 or lower.
 
If you'll manage to install them you can compile VCMI from source code.
 
 
 
Another (and probably more safe) option is to create chroot enviroment ([https://help.ubuntu.com/community/DebootstrapChroot how-to]). This will allow to install package from another distributive.
 
 
 
== Other Linux distibutives ==
 
Currently VCMI supports generation of .deb packages only. Patches to add support of any other package formats are welcomed.
 
== Compiling from source ==
 
For compiling from source see [https://vcmi.svn.sourceforge.net/svnroot/vcmi/trunk/README.linux README.linux] file.
 
You can get packaged source for current version [http://dl.dropbox.com/u/22372764/vcmi/packages/vcmi_0.88.tar.gz here]
 
 
 
= Preparing data =
 
Install original game and WoG addon. This can be done via Wine or from Windows.
 
 
 
Extract [http://dl.dropbox.com/u/22372764/vcmi/packages/vcmi-data_0.88.tar.gz VCMI data package] into installation directory.
 
 
 
Launch vcmiclient to determine data directory:
 
<pre>
 
vcmiclient -v
 
</pre>
 
 
 
The above command will display something similar to this:
 
<pre>
 
Starting...
 
VCMI 0.88b
 
  data directory:    /usr/share/vcmi
 
  library directory: /usr/lib/vcmi
 
  binary directory:  /usr/bin/vcmi
 
    ...
 
</pre>
 
 
 
Copy installed game to the "data directory". This should give you directory structure similar to this:
 
<pre>
 
/usr/share/vcmi/config/
 
/usr/share/vcmi/Data/
 
/usr/share/vcmi/Maps/
 
/usr/share/vcmi/Mp3/
 
/usr/share/vcmi/picsall/
 
/usr/share/vcmi/Sprites/
 
</pre>
 
Note: Depending on whether you are installing one of the binary packages or compiling from source and how you configured the data directory prefix (--datadir) of your source package it may be e.g. /usr/local/share/vcmi or /opt/games/vcmi or something else. In any case it must end in "vcmi" and contain the sub-directories listed above.
 
 
 
Note: In some Heroes 3 editions these directories may have different case (MP3 vs Mp3). In this case you'll have to rename them to match required directory structure.
 
 
 
 
 
If you also have original Linux version of Heroes 3 by LOKI, you can also install the videos:
 
<pre>
 
cp -a /PATH_TO_CDROM/data/video /usr/share/vcmi/Data
 
</pre>
 
 
 
= Launching game =
 
To start the game:
 
<pre>
 
vcmiclient
 
</pre>
 
= Reporting bugs =
 
Report any issues with packages on our [http://bugs.vcmi.eu bugtracker] or post a message on [http://forum.vcmi.eu/index.php VCMI forums]
 
In report please post:
 
* used distributive, version and architecture (e.g. x86 or x64)
 
* console log as well as log files from ~/.vcmi
 
* steps to reproduce bug
 

Latest revision as of 16:15, 16 July 2024

Logo256.png    Page moved to VCMI-Homepage