Difference between revisions of "Installation on Android"

From VCMI Project Wiki
Jump to: navigation, search
(The game always starts in 800x600 resolution, cannot effectively change it, also there is a lot of blank space on my widescreen device)
(9 intermediate revisions by 2 users not shown)
Line 3: Line 3:
 
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.
 
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.
  
* Release 1.1.0 (recommended): https://github.com/vcmi/vcmi/releases/tag/1.1.0
+
* Latest release on Google Play (recommended): https://play.google.com/store/apps/details?id=is.xyz.vcmi
 +
* Latest release as .apk file: https://github.com/vcmi/vcmi/releases/latest
 
* Daily builds (unstable): https://builds.vcmi.download/branch/develop/Android/
 
* Daily builds (unstable): https://builds.vcmi.download/branch/develop/Android/
* Tested daily build (from 21.07.2019): [https://play.google.com/store/apps/details?id=is.xyz.vcmi on Google Play].
 
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 =
 
= Installing Heroes III data files =
  
* Find a way to unpack Windows Heroes III or GOG installer.
+
* Install Heroes III on your PC or extract Heroes III data files from gog installer
  
 
* Connect your device to PC and enable file transfer.
 
* Connect your device to PC and enable file transfer.
  
* Copy "Data", "Maps" and "Mp3" from Heroes III to:
+
* Copy "Data", "Maps" and "Mp3" from Heroes III to any folder on mobile device, then open VCMI, select Heroes III data import option, then select the folder where you copied Heroes III data.
<pre>
 
<external storage*>/vcmi-data/ or Android/data/is.xyz.vcmi/files/vcmi-data/
 
</pre>
 
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 =
 
= Troubleshooting / well known issues =
Line 28: Line 19:
 
== The game crashes on start ==
 
== The game crashes on start ==
 
'''Please double check that you copied original SoD/Complete game files into your Android Device'''<br/>
 
'''Please double check that you copied original SoD/Complete game files into your Android Device'''<br/>
Another common cause of crash is when users set resolution higher than their device screen resolution.<br/>
 
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 ==
 
== I installed google play version, but have a problem while installing daily builds ==
 
'''Solution:''' Uninstall google play version first, before installing daily build version.
 
'''Solution:''' Uninstall google play version first, before installing daily build version.
  
== I installed play version, but the screen is flashing on its edges ==
+
== I installed play version, but the screen is flashing / blank 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.
+
'''Solution:''' Should be fixed since VCMI 1.3
 +
 
 +
== The game always starts in 800x600 resolution, cannot effectively change it, also there is a lot of blank space on my widescreen device ==
 +
'''Solution:''' Should be fixed since VCMI 1.3 onwards.  
  
== 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 ==
+
If you use version 1.2 or older - please download "VCMI-extras" mod from VCMI Launcher.
'''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.<br/>
 
 
Resolution setting 1024x600 is better than original 800x600 for widescreen mobile phones.
 
Resolution setting 1024x600 is better than original 800x600 for widescreen mobile phones.
  
 
== Other problems ==
 
== Other problems ==
* Please report about gameplay problem on forums: [https://forum.vcmi.eu/c/international-board/help-bugs Help & Bugs]
+
* Please report about gameplay problem on forums: [https://forum.vcmi.eu/c/international-board/help-bugs Help & Bugs] or [https://discord.gg/chBT42V Discord]
  
If your problem is Android-specific: APK not installing of game doesn't start please use following topic:
 
* [https://forum.vcmi.eu/t/vcmi-for-android/784 VCMI for Andoid]
 
 
Make sure to specify your device and used version of Android.
 
Make sure to specify your device and used version of Android.

Revision as of 11:25, 4 August 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.

Installing Heroes III data files

  • Install Heroes III on your PC or extract Heroes III data files from gog installer
  • Connect your device to PC and enable file transfer.
  • Copy "Data", "Maps" and "Mp3" from Heroes III to any folder on mobile device, then open VCMI, select Heroes III data import option, then select the folder where you copied Heroes III data.

Troubleshooting / well known issues

The game crashes on start

Please double check that you copied original SoD/Complete game files into your Android Device

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 / blank on its edges

Solution: Should be fixed since VCMI 1.3

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

Solution: Should be fixed since VCMI 1.3 onwards.

If you use version 1.2 or older - please download "VCMI-extras" mod from VCMI Launcher. Resolution setting 1024x600 is better than original 800x600 for widescreen mobile phones.

Other problems

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