Northfear / homm3hd-vita

PS Vita loader for Android version of Heroes of Might and Magic III HD Edition
MIT License
48 stars 3 forks source link
android heroes-of-might-and-magic homm3 psvita

Heroes of Might and Magic III HD Edition wrapper/port for PS Vita

This repository contains a loader of the Android release of Heroes of Might and Magic III HD Edition, based on the Android SO Loader by TheFloW. The loader provides a tailored, minimalistic Android-like environment to run the official ARMv7 game executables on PS Vita.

At the time of writing this readme, the Heroes of Might and Magic III HD Edition was delisted from the major Android storefronts. This loader ("port") is intended to be used only by those people who bought the game prior to the delisting and still can legally access their own copy through the Purchased Apps list on Google Play.

This software does not contain the original code, executables, assets, or other non redistributable parts of the game. The authors do not promote or condone piracy in any way. To launch and play the game on their PS Vita device, users must provide their own legally obtained copy of the game in the form of an .apk file.

Setup Instructions (For End Users)

The port has been tested only with the latest available version of the game (which is v1.1.6)

In order to properly install the game, you'll have to follow these steps precisely:

Note Don't install fd_fix.skprx if you're using the rePatch plugin!

Note 2 libgpu_es4_kernel_ext.skprx plugin is no longer needed since version 1.2.0.

Controls

Original touch controls are supported.

During battle ○ button is used for attack direction selection (when clicked on the enemy unit within attack range). Double × click is used for ranged attack. To view unit info during battle click on the unit with × button, wait 2-3 seconds and then click × again.

You can enable rear touchpad cursor movement in the game configuration utility (GAME OPTIONS on the bottom of the launcher screen). Use double tap to emulate LMB with rear touchpad and second finger tap to emulate RMB.

Left analog stick deadzone can be changed in game configuration utility.

Additional info

You can add custom "Restoration of Erathia" maps by copying them into ux0:data/homm3hd/data/maps/<your_language_folder>/ folder (ux0:data/homm3hd/data/maps/en/ for example). Note that ONLY "The Restoration of Erathia" maps are supported.

Known Issues

Build Instructions (For Developers)

In order to build the loader, you'll need a softfp vitasdk

Dependencies

make HAVE_GLSL_SUPPORT=1 SOFTFP_ABI=1 SINGLE_THREADED_GC=1 HAVE_SHADER_CACHE=1 install

mkdir build && cd build
cmake .. -DCMAKE_TOOLCHAIN_FILE=${VITASDK}/share/vita.toolchain.cmake -DCMAKE_BUILD_TYPE=Release -DVIDEO_VITA_VGL=ON
make install

You may need to rebuild SDL_mixer and SDL_image manually after the installation of the required SDL2 fork.

After all these requirements are met, you can compile the loader with the following commands:

mkdir build && cd build
cmake .. && make

Credits