|
|
(14 intermediate revisions by 4 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/}} |
− | = Binaries installation =
| |
− | == Ubuntu ==
| |
− | | |
− | VCMI stable builds available in "multiverse" repository. Learn how to enable it in [https://help.ubuntu.com/community/Repositories/Ubuntu Ubuntu wiki].
| |
− | | |
− | VCMI daily builds can be installed from PPA:
| |
− | * For testing only: https://launchpad.net/~vcmi/+archive/ppa
| |
− | | |
− | To add PPA type in Terminal:
| |
− | <pre>
| |
− | sudo apt-add-repository ppa:vcmi/ppa
| |
− | </pre>
| |
− | | |
− | To install VCMI from repository:
| |
− | <pre>
| |
− | sudo apt-get update
| |
− | sudo apt-get 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>
| |
− | | |
− | == 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].
| |
− | | |
− | == Other distributions ==
| |
− | For other distributions, VCMI can be installed from 3rd-party repositories listed below.
| |
− | * Gentoo https://github.com/qdii/qdiilay/tree/master/games-strategy/vcmi
| |
− | * Archlinux [https://aur.archlinux.org/packages/vcmi/ vcmi] [https://aur.archlinux.org/packages/vcmi-git/ vcmi-git]
| |
− | 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
| |
− | * gog.com installer
| |
− | * 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
| |
− | 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.
| |
− | | |
− | * Copy "Data", "Maps" and "Mp3" from Heroes III to:
| |
− | <pre>/home/$USER/.local/share/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]
| |