|
|
| (49 intermediate revisions by 8 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 can be installed from PPA:
| |
| − | | |
| − | * stable version (recommended): https://launchpad.net/~saven-ivan/+archive/vcmi
| |
| − | * daily builds (for testing only): https://launchpad.net/~vcmi/+archive/ppa
| |
| − | | |
| − | To use it type in Terminal:
| |
| − | <pre>
| |
| − | sudo apt-add-repository ppa:saven-ivan/vcmi
| |
| − | sudo apt-get update
| |
| − | sudo apt-get install vcmi
| |
| − | </pre>
| |
| − | | |
| − | == Debian ==
| |
| − | Download and install package for your distribution. Install can be done using any GUI managers or using command line:
| |
| − | <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 second one.
| |
| − | | |
| − | {| | |
| − | |'''Debian Wheezy'''
| |
| − | |[http://download.vcmi.eu/vcmi_0.94~wheezy1_i386.deb 32 bit]
| |
| − | |[http://download.vcmi.eu/vcmi_0.94~wheezy1_amd64.deb 64 bit]
| |
| − | |}
| |
| − | | |
| − | == Fedora ==
| |
| − | Download and install package for your distribution. There are two ways to install package along with all dependencies:
| |
| − | | |
| − | Option A) Double-click the package. A package management window should appear with instructions to guide you through the process.
| |
| − | | |
| − | Option B) Open a terminal window, and type
| |
| − | <pre>
| |
| − | sudo rpm -i package_location_and_name(e.g. vcmi-0.9.4-1.fc16.x86_64.rpm)
| |
| − | </pre>
| |
| − | | |
| − | {| | |
| − | |'''Fedora 19'''
| |
| − | |[http://download.vcmi.eu/vcmi-0.9.4-1.fc19.i686.rpm 32 bit]
| |
| − | |[http://download.vcmi.eu/vcmi-0.9.4-1.fc19.x86_64.rpm 64 bit]
| |
| − | |} | |
| − | | |
| − | == 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-svn/ vcmi-svn]
| |
| − | | |
| − | == Compiling from source ==
| |
| − | * [http://download.vcmi.eu/vcmi-0.94.tar.gz Packaged source]
| |
| − | * [http://svn.code.sf.net/p/vcmi/code/trunk/README.linux Readme] (available as README.linux in source package)
| |
| − | | |
| − | = Installing Heroes III data files =
| |
| − | To install VCMI you will need:
| |
| − | * Heroes III: Shadow of Death or Complete edition
| |
| − | * Unnoficial WoG addon: http://download.vcmi.eu/WoG/wog.zip
| |
| − | * VCMI data files: http://download.vcmi.eu/core.zip
| |
| − | == 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 --download
| |
| − | vcmibuilder --gog /path/to/gog.com/installer --download
| |
| − | vcmibuilder --data /path/to/h3/data --download
| |
| − | </pre>
| |
| − | You should use only one of these commands.
| |
| − | | |
| − | === Offline install ===
| |
| − | Normally vcmibuilder script will autodownload WoG and VCMI data packages. For offline install you need to download this packages manually and replace download switch with this:
| |
| − | <pre>
| |
| − | vcmibuilder <h3 data commands> --wog /path/to/wog/archive --vcmi /path/to/vcmi/package
| |
| − | </pre>
| |
| − | Where '''h3 data commands''' stands for described earlier option(s) needed to install H3 data (path to data, Install CD or gog.com installer)
| |
| − | | |
| − | === Fedora music 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
| |
| − | * Extract WoG addon http://download.vcmi.eu/WoG/wog.zip
| |
| − | * Extract VCMI data files: http://download.vcmi.eu/core.zip
| |
| − | | |
| − | Launch vcmiclient to determine data directory (output may differ)
| |
| − | <pre>
| |
| − | $vcmiclient -v
| |
| − | Starting...
| |
| − | VCMI 0.91
| |
| − | data directory: /usr/share/vcmi
| |
| − | library directory: /usr/lib/vcmi
| |
| − | binary directory: /usr/games
| |
| − | </pre>
| |
| − | Copy your data to data directory. This should result in directory structure similar to this:
| |
| − | <pre>
| |
| − | /usr/share/vcmi/config/
| |
| − | /usr/share/vcmi/Data/
| |
| − | /usr/share/vcmi/Maps/
| |
| − | /usr/share/vcmi/Mods/WoG/
| |
| − | /usr/share/vcmi/Mods/vcmi/
| |
| − | /usr/share/vcmi/Mp3/
| |
| − | </pre>
| |
| − | | |
| − | = Launching game =
| |
| − | To start the game type in console:
| |
| − | <pre>
| |
| − | vcmiclient
| |
| − | </pre>
| |
| − | VCMI should be also available via desktop environment menu or launcher (Games/Strategy/VCMI)
| |
| − | = 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 (for example "Ubuntu 11.10 32 bit"). For distributives that use rolling releases please post versions of all used libraries (boost, ffmpeg, SDL)
| |
| − | * console log as well as log files from ~/.vcmi
| |
| − | * steps to reproduce bug
| |
