Revision as of 15:32, 23 April 2023

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.

• Latest release on Google Play (recommended): https://play.google.com/store/apps/details?id=is.xyz.vcmi (update may get delayed when new release comes)
• Latest release as .apk file: https://github.com/vcmi/vcmi/releases/latest
• Daily builds (unstable): https://builds.vcmi.download/branch/develop/Android/

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:

• VCMI for Andoid

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