Hill Climb Racing · PSVita Port

How to install • Controls • How to compile • Credits • License

Hill Climb Racing is a game made by Fingersoft, a Finnish game engine where you can control a vehicle and try to survive as far as possible to get more coins for more upgrades, vehicles and stages! Each stage has a different layout, and different obstacles to overcome. Each vehicle has their own strengths and weaknesses, making certain vehicles excel in certain stages, and their vehicles have overalls.

This repository contains a loader of the Android release of Hill Climb Racing, 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 the PS Vita.

This software does not contain the original code, executables, assets, or other not 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 form of an .apk file.

Minor notes

• Before the game jumps to the loading screen after launching it, or after finishing a play session, don't quit the game immediately.
  • Wait for around 3 seconds and then quit, otherwise your game may crash or your save data may be corrupted.
  • If you still happen to crash/corrupt your save file, there is a backup inside ux0:/data/hcr folder with the name SharedPreferences.bin.bak. Simply remove the .bak by renaming and the game should work again, but some progress may be lost.
• When selecting levels or cars, wait until it responds, because it's loading things in the background.
• There is a moment after lots of gameplay, that when you get to the death screen, the game will start lagging and you will have massive FPS drop. It is yet to be figured out why does this happen.
  • It is recommended to patiently wait until you can proceed to the selection menu, and restart the game.
  • Else, just restart the game in the middle of the laggy sequence, but progress will be lost.

This is currently in its BETA version. Improvements may be made in the future. See Issues for currently know problems.

Setup Instructions (For End Users)

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

• Install kubridge and FdFix by copying kubridge.skprx and fd_fix.skprx to your taiHEN plugins folder (usually ur0:tai) and adding two entries to your config.txt under *KERNEL:

  *KERNEL
  ur0:tai/kubridge.skprx
  ur0:tai/fd_fix.skprx

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

• Make sure you have libshacccg.suprx in the ur0:/data/ folder on your console. If you don't, follow this guide to extract it.

• Legally obtain your copy of Hill Climb Racing for Android in form of an .apk file.

  • Versions supported: 1.18.0, 1.24.0.

• Open the .apk with any zip explorer (like 7-Zip) and extract assets folder from the .apk into ux0:data/hcr. Also, extract libgame.so from lib/armeabi-v7a/ in the same directory.

• Place the .apk itself inside ux0:data/hcr and rename to base.apk.

  Your final folder layout should look like:

   └── hcr/
    ├── assets/
    ├── libgame.so
    └── base.apk
  

• Install hcr.vpk (from Releases).

Controls

Button	Action
/	Brake/Accelerate
	Back

and the touch functionality fully works (if you don't break it somehow).

Build Instructions (For Developers)

In order to build the loader, you'll need a vitasdk build fully compiled with softfp usage. You can get your environment started nicely by following Rocroverss's Vita .so porting guide. Everything that is required should be available after installing your environment by following the instructions in the README.md of the guide.

• Compile vitaGL

  make HAVE_GLSL_SUPPORT=1 CIRCULAR_VERTEX_POOL=2 USE_SCRATCH_MEMORY=1 SOFTFP_ABI=1 HAVE_SHADER_CACHE=1 install -j`nproc`

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

cmake -B build .
cmake --build build

Credits

• Andy "The FloW" Nguyen for the original .so loader.
• Rinnegatamante for VitaGL and lots of help with understanding and debugging the loader.
• PatnosD for giving me the motivation to do this game as my first .so loader port.
• gl33ntwine for the SoLoBoP (.so loader boilerplate), help with the SharedPreferences parsing functions, this README.md as a template copied from Baba is You! port and overall help.
• Everybody who has helped me in Vita Nuova discord while asking questions.

License

This software may be modified and distributed under the terms of the MIT license. See the LICENSE file for details.