Installation on Android

From VCMI Project Wiki
Revision as of 22:00, 23 December 2022 by Ivan (talk | contribs)
Jump to: navigation, search

Download and install VCMI

This app requires original heroes 3 sod / complete files to operate, they are not supplied with this installer. it is recommended to purchase version from gog.com. Heroes 3 "hd edition" (steam version) files are not supported !!!
Installation is a two step process, at first you need to install game, then you need to upload Heroes3 original data files into your android device.

Please note that Google Play version, while being a tested and proven one, contains bugs and problems that were fixed in later versions.

Installing Heroes III data files

  • Find a way to unpack Windows Heroes III or GOG installer.
  • Connect your device to PC and enable file transfer.
  • Copy "Data", "Maps" and "Mp3" from Heroes III to:
<external storage*>/vcmi-data/ or Android/data/is.xyz.vcmi/files/vcmi-data/

Latest daily build shows exact folder path where it expects to see vcmi-data when it can't locate Heroes III files (You can ignore prefix /Storage/0/emulated because file managers usually do not show it, vcmi-data folder might be absent but the rest of the path will be created automatically after first game start)

<external storage*> is whatever system returns as "external storage directory", so either actual sdcard, or internal memory if sdcard isn’t available.

You are not a tech person, and want a videoguide how to do it? see youtube: https://www.youtube.com/watch?v=zGO1I3asquY

Troubleshooting / well known issues

The game crashes on start

Please double check that you copied original SoD/Complete game files into your Android Device
Another common cause of crash is when users set resolution higher than their device screen resolution.
For android we recommend to set a rather low resolution anyway, such as 1024x600, as high resolution means elements will be small and will be hard to click and read.

I installed google play version, but have a problem while installing daily builds

Solution: Uninstall google play version first, before installing daily build version.

I installed play version, but the screen is flashing on its edges

Solution: This problem is fixed in current daily builds. Either install a current daily build, or wait for a new google play version.

I use newest daily builds. The game always starts in 800x600 resolution, cannot effectively change it, also there is a lot of blank space on my widescreen device

Solution: Please download "VCMI-extras" mod from here https://wiki.vcmi.eu/Mod_list#Utilities, unpack it and copy to Mods folder inside vcmi-data folder where you put original game files.
Resolution setting 1024x600 is better than original 800x600 for widescreen mobile phones.

Other problems

  • Please report about gameplay problem on forums: Help & Bugs

If your problem is Android-specific: APK not installing of game doesn't start please use following topic:

Make sure to specify your device and used version of Android.