# PlayStation Vita port of [fheroes2](https://github.com/ihhub/fheroes2) project

### Vita support was merged into upstream, so [fheroes2 release page](https://github.com/ihhub/fheroes2/releases) is probably the best place to get the latest version. I'm keeping this repo just as a playground for new stuff and latest fixes.

## Install
Install fheroes2.vpk to your Vita.

fheroes2 requires data files from the original Heroes of Might and Magic II.

Copy HEROES2.AGG and HEROES2X.AGG (if you own Price of Loyalty expansion) from the original games "DATA" folder into "ux0:data/fheroes2/data" and everything from "MAPS" folder into "ux0:data/fheroes2/maps".

Music files in OGG format (from GoG release of the game) should be placed into the "ux0:data/fheroes2/music/" folder.

fheroes2 supports ingame cinematics. To play into and/or other videos, make sure that all of "*.SMK" files are placed inside "ux0:data/fheroes2/heroes2/anim/" folder.

[rePatch reDux0](https://github.com/dots-tb/rePatch-reDux0) OR [FdFix](https://github.com/TheOfficialFloW/FdFix) plugin is required for proper suspend/resume support (only use one at a time).

## Building
### Prerequisites
- VitaSDK
- libSDL2
- libSDL2-mixer (optional)
- libSDL2-image (optional)

To build the game just run
```
make -f Makefile.vita
```

## Controls
- Left analog stick - Pointer movement
- Right analog stick - Map scrolling
- × - Left mouse button
- ○ - Right mouse button
- □ - End turn
- △ - Open spellbook
- L1 - Next hero
- R1 - Next castle
- SELECT - System menu
- START - Enter
- D-Pad down - re-visit the field that hero stands on

Text input is done with D-Pad.

- Left - Remove character
- Right - Add new character
- Down - Next character (alphabetically)
- Up - Previous character
- R1, L1 - Switch current character between uppercase/lowercase

## Vita specific options

Pointer movement speed can be changed with 'gamepad_pointer_speed' parameter in "ux0:data/fheroes2/fheroes2.cfg".

Use "fullscreen = on" option to scale game area to native Vita resolution or "fullscreen = off" to keep the game area at the center of the screen.

Native resolution is supported (set "videomode = 960x544" option in config file or just click on the left door in main menu and select resolution manually).


fheroes2
======
[](https://github.com/ihhub/fheroes2/releases) [](https://discord.gg/xF85vbZ) [](https://www.facebook.com/groups/fheroes2) [](https://vk.com/fheroes2) [](https://www.patreon.com/fheroes2)
# fheroes2

**fheroes2** is a recreation of the Heroes of Might and Magic II game engine.

This open source multiplatform project, written from scratch, is designed to reproduce the original game with significant
improvements in gameplay, graphics and logic (including support for high-resolution graphics, improved AI, numerous fixes
and user interface improvements), breathing new life into one of the most addictive turn-based strategy games.

You can find a complete list of all of our changes and enhancements in [**its own wiki page**](https://github.com/ihhub/fheroes2/wiki/Features-and-enhancements-of-the-project).

<p align="center">
<img src="docs/images/screenshots/screenshot_world_map.png?raw=true" width="820">
</p>

<p align="center">
<img src="docs/images/screenshots/screenshot_battle.png?raw=true" width="410"> <img src="docs/images/screenshots/screenshot_castle.png?raw=true" width="410">
</p>

## Download and install

Please follow the [**installation guide**](docs/INSTALL.md) to download and install fheroes2.

[](https://github.com/ihhub/fheroes2/releases)

## Copyright

All rights for the original game and its resources belong to former The 3DO Company. These rights were transferred to Ubisoft.
We do not encourage and do not support any form of illegal usage of the original game. We strongly advise to purchase the original
game on [**GOG**](https://www.gog.com) or [**Ubisoft Store**](https://store.ubi.com) platforms. Alternatively, you can download a
free demo version of the game. Please refer to the [**installation guide**](docs/INSTALL.md) for more information.

## License

This project is licensed under the [**GNU General Public License v2.0**](https://github.com/ihhub/fheroes2/blob/master/LICENSE).

Initially, the project was developed on [**sourceforge**](https://sourceforge.net/projects/fheroes2/).

## Contribution and Development

This repository is a place for everyone. If you want to contribute, please read more [**here**](https://github.com/ihhub/fheroes2/wiki/F.A.Q.#q-how-can-i-contribute-to-the-project).

To build the project from source, please follow [**this guide**](docs/DEVELOPMENT.md).

[](https://github.com/ihhub/fheroes2/actions)
[](https://sonarcloud.io/dashboard?id=ihhub_fheroes2)
[](https://sonarcloud.io/dashboard?id=ihhub_fheroes2)
[](https://sonarcloud.io/dashboard?id=ihhub_fheroes2)

If you would like to help translating the project, please read the [**translation guide**](docs/TRANSLATION.md).

## Donation

We accept donations via [**Patreon**](https://www.patreon.com/fheroes2), [**PayPal**](https://www.paypal.com/paypalme/fheroes2) or [**Boosty**](https://boosty.to/fheroes2). All donations will be used only for the future project development as we do not
consider this project as a source of income by any means.

[](https://www.patreon.com/fheroes2)
[](https://www.paypal.com/paypalme/fheroes2)
[](https://boosty.to/fheroes2)

## Contacts

Follow us on social networks: [**Facebook**](https://www.facebook.com/groups/fheroes2) or [**VK**](https://vk.com/fheroes2).
We also have a [**Discord**](https://discord.gg/xF85vbZ) server to discuss the development of the project.

[](https://www.facebook.com/groups/fheroes2)
[](https://vk.com/fheroes2)
[](https://discord.gg/xF85vbZ)

## FAQ

You can find answers to the most commonly asked questions on our [**F.A.Q. page**](https://github.com/ihhub/fheroes2/wiki/F.A.Q.).