Difference between revisions of "Installation on Linux"

From VCMI Project Wiki
Jump to: navigation, search
(Installing Heroes III data files)
(Replaced content with "{{Template:MovedToWebpage|https://vcmi.eu/players/Installation_Linux/}}")
 
(2 intermediate revisions by one other user 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/}}
= Binaries installation =
 
== Ubuntu ==
 
'''From Ubuntu repository'''
 
 
 
VCMI stable builds available in "multiverse" repository. Learn how to enable it in [https://help.ubuntu.com/community/Repositories/Ubuntu Ubuntu wiki].
 
 
 
Once enabled, you can install VCMI using following commands:
 
<pre>
 
sudo apt update
 
sudo apt install vcmi
 
</pre>
 
 
 
'''Latest stable build from PPA'''
 
 
 
More up-to-date releases can be found in our PPA here: https://launchpad.net/~vcmi/+archive/ubuntu/ppa
 
 
 
To install VCMI from PPA use:
 
<pre>
 
sudo apt-add-repository ppa:vcmi/ppa
 
sudo apt update
 
sudo apt install vcmi
 
</pre>
 
 
 
'''Unstable testing build from PPA'''
 
 
 
We also provide latest, unstable builds mostly suitable for testing here: https://launchpad.net/~vcmi/+archive/ubuntu/vcmi-latest
 
 
 
In order to install from this PPA use:
 
<pre>
 
sudo add-apt-repository ppa:vcmi/vcmi-latest
 
sudo apt update
 
sudo apt install vcmi
 
</pre>
 
 
 
== Debian ==
 
 
 
Stable VCMI version is available in "contrib" repository. Learn how to enable it in [https://wiki.debian.org/SourcesList Debian wiki].
 
 
 
To install VCMI from repository:
 
<pre>
 
sudo apt-get update
 
sudo apt-get install vcmi
 
</pre>
 
<!-- DISABLED - SNAP PACKAGE IS OUTDATED
 
== Snappy ==
 
It's possible to install daily VCMI builds as distribution-agnostic Snap package:
 
 
 
* Visit [https://snapcraft.io/ snapcraft.io] to learn how to get Snappy on your distribution.
 
* Once it's running install latest VCMI build with:
 
<pre>
 
sudo snap install --edge vcmi
 
</pre>
 
* After you can run VCMI with following commands:
 
<pre>
 
snap run vcmi.vcmilauncher
 
snap run vcmi.vcmiclient
 
snap run vcmi.vcmiserver
 
</pre>
 
* Keep in mind that instead of '''$HOME/.local/share/vcmi/''' you must copy Heroes 3 assets into:
 
<pre>
 
$HOME/snap/vcmi/current/.local/share/vcmi/
 
</pre>
 
* To update to latest version:
 
<pre>
 
sudo snap refresh vcmi
 
</pre>
 
 
 
'''Warning:''' Snap builds are currently in experimental state.
 
 
 
Please give your feedback on forum: [https://forum.vcmi.eu/t/experimental-snap-packages-for-linux/4300 Experimental Snap packages for Linux].
 
-->
 
== Flatpak (distribution-agnostic) ==
 
Latest public release build can be installed via Flatpak.
 
 
 
Depending on your distribution, you may need to install flatpak itself.
 
You can find guide for your distribution here: https://www.flatpak.org/setup/
 
 
 
Once you have flatpak, you can install VCMI package which can be found here: https://flathub.org/apps/details/eu.vcmi.VCMI
 
 
 
== Other distributions ==
 
For other distributions, VCMI can be installed from 3rd-party repositories listed below. <br/>
 
Note that these repositories are not supported by vcmi team and may not be up to date.
 
* Archlinux [https://aur.archlinux.org/packages/vcmi/ vcmi] [https://aur.archlinux.org/packages/vcmi-git/ vcmi-git]
 
* openSUSE [https://software.opensuse.org/download.html?project=games&package=vcmi 1 Click Install]
 
If you are interested in providing builds for other distributions, please let us know.
 
 
 
== Compiling from source ==
 
Please check following developer guide: [[How to build VCMI (Linux)]]
 
 
 
= Installing Heroes III data files =
 
To install VCMI you will need Heroes III: Shadow of Death or Complete edition.
 
 
 
== Install data using vcmibuilder script (recommended for non-Flatpak installs) ==
 
To install Heroes 3 data using automated script you need any of:
 
* Offline Installer downloaded from gog.com (both .exe and .bin files are required)
 
* Directory with preinstalled game
 
* One or two CD's or CD images
 
 
 
Run the script using options appropriate to your input files:
 
<pre>
 
vcmibuilder --cd1 /path/to/iso/or/cd --cd2 /path/to/second/cd
 
vcmibuilder --gog /path/to/gog.com/installer.exe
 
vcmibuilder --data /path/to/h3/data
 
</pre>
 
You should use only one of these commands.
 
 
 
On flatpak install, it's also possible to run the script, but any path seems to be interpreted from within the Flatpak sandbox:
 
<pre>
 
flatpak run --command=vcmibuilder eu.vcmi.VCMI --data /path/to/h3/data`
 
</pre>
 
 
 
== Install data using gog.com offline installer ==
 
 
 
Download both files for the "offline backup game installers" and extract them using innoextract tool
 
<pre>
 
    innoextract --output-dir=~/Downloads/HoMM3 "setup_heroes_of_might_and_magic_3_complete_4.0_(28740).exe"
 
</pre>
 
(note that installer file name might be different)
 
 
 
Once innoextract completes, start VCMI Launcher and choose to copy existing files. Select the ~/Downloads/HoMM3 directory. Once copy is complete, you can delete both offline installer files as well as ~/Downloads/HoMM3.
 
 
 
== Install using existing Heroes III data ==
 
 
 
Copy "Data", "Maps" and "Mp3" from Heroes III to:
 
<pre>$HOME/.local/share/vcmi/</pre>
 
Or, in case of flatpak install to
 
<pre>$HOME/.var/app/eu.vcmi.VCMI/data/vcmi/</pre>
 
On some distributions $XDG_DATA_HOME could differ so instead you may need to use:
 
<pre>$XDG_DATA_HOME/vcmi/</pre>
 
 
 
= Launching game =
 
To start the game type in console:
 
<pre>
 
vcmilauncher
 
</pre>
 
Or, to start game directly avoiding Launcher:
 
<pre>
 
vcmiclient
 
</pre>
 
VCMI should be also available via desktop environment menu or launcher (Games/Strategy/VCMI)
 
 
 
= Reporting bugs =
 
Please report any issues with packages according to
 
[http://wiki.vcmi.eu/index.php?title=Bug_reporting_guidelines Bug reporting guidelines]
 

Latest revision as of 16:15, 16 July 2024

Logo256.png    Page moved to VCMI-Homepage