GitHub Vita Lite - Wolff's Store
Code / README | Releases | Issues
WolffsRoom/MC2BPegasus-Vita

MC2BPegasus-Vita

MC2-BP port for PS VITA

TypeFilenameSize
DIRassets—
DIRextras—
DIRlib—
DIRsource—
FILE.gitignore127 B
FILE.gitmodules119 B
FILECMakeLists.txt8572 B
FILELICENSE1167 B
FILEREADME.md9531 B

README

Modern Combat 2: Black Pegasus - PS Vita Port

MC2BPegasus-Vita

Unofficial wrapper/port of Modern Combat 2: Black Pegasus for PlayStation Vita.

The port operates by loading the official Android ARMv7 executable directly into memory, linking its dependencies to native functions, providing the JNI environment expected by the game, and translating OpenGL ES calls through vitaGL. In practice, this creates a lightweight Android-like environment where the original executable can run natively on the PS Vita.

Port by MeninoSung

About the port

This project uses an Android shared-object loader and FalsoJNI to run the original libsandstorm2.so library on the PS Vita. The graphics layer is implemented with VitaGL, while platform-specific replacements provide input, audio, filesystem, lifecycle, and media functionality expected by the Android version.

The target game build uses the Gameloft package namespace com.gameloft.android.GAND.GloftBPHP.ML, the Xperia Play device profile, and game data stored under GloftBPHP/data/. The loader reproduces the JNI initialization sequence used by that build instead of relying on a generic android_main entry point.

This port does not distribute the game's commercial data. Users must provide their own legally obtained, compatible Android copy and extract the required files themselves.

Setup Instructions (For End Users)

In order to properly install the game, follow these steps precisely:

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

Note: Do not install fd_fix.skprx if you are using the rePatch plugin.

Supported Android Build

Property Value
Game Modern Combat 2: Black Pegasus
Version 1.0.0
Architecture ARMv7
Native library libsandstorm2.so
Package namespace com.gameloft.android.GAND.GloftBPHP.ML
Data profile Xperia Play / GloftBPHP

Only data extracted from version 1.0.0 is supported. Files from other versions may use incompatible native code, resources, or data layouts.

How to Prepare the Game Files

  1. Extract your legally obtained Android game package and game data for version 1.0.0.
  2. Locate libsandstorm2.so in the APK's ARMv7 library folder.
  3. Locate the matching GloftBPHP/data directory.
  4. Create a folder named moderncombat2 with the following structure:

text Moderncombat2/ |-- libsandstorm2.so |-- files/ `-- GloftBPHP/ |-- CheckPoint.bin |-- SaveGame.bin `-- data/ |-- Constants.bin |-- 2d.header |-- 2d.pak |-- 3d.header |-- 3d.pak |-- automat.header |-- automat.pak |-- structs.header |-- structs.pak |-- texts.header |-- texts.pak |-- audio/ `-- intro/ `-- logo.mp4

  1. Keep all files from the same version 1.0.0 release together. Do not replace individual files with data from another version.

Installation on PS Vita

  1. Install MC2BPegasus-Vita.vpk on your PS Vita using VitaShell.
  2. Copy the prepared moderncombat2 folder to ux0:data/.
  3. Verify that the files are located at these paths:

text ux0:data/moderncombat2/libsandstorm2.so ux0:data/moderncombat2/GloftBPHP/data/

  1. Launch PegasusVita from the LiveArea.

If startup fails, check ux0:data/moderncombat2/port.log. The loader also creates ux0:data/mc2_boot.log when the application reaches its main entry point.

Language

The supported languages are:

For the best compatibility, set the game to English after the first launch:

Options > Languages > English

Controls

The port supports the front touchscreen, both analog sticks, and the physical PS Vita controls. The physical buttons are exposed to the game using its original Xperia Play mappings.

Control Action
Left analog stickMovement
Right analog stickCamera / aiming
D-padAndroid D-pad directions
CrossD-pad center / confirm
CircleBack
SquareXperia Play X button
TriangleXperia Play Y button
L / RXperia Play L1 / R1
START / SELECTStart / Select
Front touchscreenMenus, touch controls, and on-screen interactions

The exact in-game action of each Xperia Play button can vary by screen and control configuration.

Screenshots

Modern Combat 2 gameplay screenshot 1 Modern Combat 2 gameplay screenshot 2 Modern Combat 2 gameplay screenshot 3 Modern Combat 2 gameplay screenshot 4 Modern Combat 2 running at 60 FPS on PS Vita

The game runs at a stable 60 FPS on standard PS Vita clocks, including the default 333 MHz CPU clock. Overclocking is not required for normal gameplay.

Build Instructions (For Developers)

Requirements:

Compile

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

The current repository includes the distributable as MC2BPegasus-Vita.vpk. A local CMake build generates Pegasus_Vita.vpk with title ID MC2V00001. By default, the loader expects the game files at ux0:data/moderncombat2/. The path can be changed at configure time:

cmake -S . -B build \
  -DDATA_PATH="ux0:data/moderncombat2/" \
  -DGAME_SO_PATH="ux0:data/moderncombat2/libsandstorm2.so"
cmake --build build

Debug builds enable additional loader diagnostics:

cmake -S . -B build-debug -DCMAKE_BUILD_TYPE=Debug
cmake --build build-debug

Known Issues

This is an unofficial, free, non-commercial port. Modern Combat 2: Black Pegasus, Modern Combat, Gameloft, and all related assets and trademarks belong to their respective developers and copyright holders.

This repository must not be used to distribute commercial APKs, native libraries, or game data. Use only files from a copy you obtained legally and support the original developers.

Credits

The loader code is derived from work by Volodymyr Atamanenko and the wider PS Vita Android-porting community. FalsoJNI is distributed in lib/falso_jni under its own license. Rights to Modern Combat 2 and its assets belong to their respective owners.


AI Notice

Artificial intelligence tools (Codex/ChatGPT) were used to assist with code analysis, compatibility investigation, documentation, and the iterative development process.