|
|
| (5 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.
| |
| − | == Automated install ==
| |
| − | To install Heroes 3 data using automated script you need any of:
| |
| − | * One or two CD's or CD images
| |
| − | * Offline Installer downloaded from gog.com
| |
| − | * Directory with installed game
| |
| − | | |
| − | 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.
| |
| − | | |
| − | === Music on distributions without Mp3 support ===
| |
| − | To have Music support on Fedora it is required to perform a additional step. Fedora doesn't provide Mp3 playback support natively due to patents applied on the Mp3 technique. The SDL_mixer package from the official Fedora repo is compiled without Mp3 support.
| |
| − | | |
| − | To make music work it must be converted into ogg format. This can be done either manually or using vcmibuilder:
| |
| − | <pre>
| |
| − | vcmibuilder --convertMP3
| |
| − | </pre>
| |
| − | This command can be run separately after install or as additional switch during initial vcmibuilder launch
| |
| − | | |
| − | == Manual install ==
| |
| − | | |
| − | * Install Heroes III in Wine or manually unpack GOG installer.
| |
| − | * '''For VCMI 1.2 or newer:''' start VCMI launcher - explained in next step, it will guide you through importing H3 data files
| |
| − | | |
| − | * '''For VCMI older than 1.2:''' 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]
| |
