THE IMPOSSIBLE GAME — PS Vita Port

<p align="center"> <img src="extras/livearea/pic0.png" width="700" alt="The Impossible Game PS Vita Banner" /> </p> <p align="center"> <b>Native port of The Impossible Game (FlukeDude) for PlayStation Vita and PlayStation TV.</b> </p> <p align="center"> <img src="https://img.shields.io/badge/Platform-PS%20Vita%20%7C%20PS%20TV-003791.svg?style=flat-square&logo=playstation" alt="Platform PS Vita" /> <img src="https://img.shields.io/badge/Title%20ID-PSVTIG001-ff69b4.svg?style=flat-square" alt="Title ID PSVTIG001" /> <img src="https://img.shields.io/badge/Engine-FlukeDude%20(proprietary)-brightgreen.svg?style=flat-square" alt="Engine" /> <img src="https://img.shields.io/badge/Renderer-vitaGL%20%28GLES%201.1%20fixed--function%29-orange.svg?style=flat-square" alt="Renderer" /> <img src="https://img.shields.io/badge/Status-Playable-success.svg?style=flat-square" alt="Status: Playable" /> </p>

---

📖 Description

The Impossible Game is FlukeDude's rhythm-platformer, originally released for Android as 05133-the-impossible-1.5.2.apk (package com.flukedude.impossiblegame). This port runs the compiled native library (libimpossible.so — a small, self-contained proprietary engine that handles cube physics, collisions, procedural level generation, and rendering) directly on the PS Vita's ARM Cortex-A9 processor, using a dynamic loader (soloader) and an Android environment emulation layer (FalsoJNI). The UI and audio layers, which were Java on Android, have been fully reimplemented natively in C (menu.c, audio.c, texture.c, save.c) for zero-latency input and native performance.

libimpossible.so makes zero callbacks into Java/JNIEnv — it only imports standard math (cosf, sinf, round, truncf, lrand48), clock_gettime, and OpenGL ES 1.1 fixed-function calls (glVertexPointer, glTexCoordPointer, glDrawArrays, ...), rendered via vitaGL. See PORTING_PLAN.md for the full engine-detection write-up and the confirmed native lifecycle (initLibrary → initGame → drawFrame).

🎮 Current Status: Playable

The game boots to the main menu and all 5 levels are fully playable: the 2 base levels (Fire Aura, Original Xbox Level) plus the 3 levels from the official Level Pack add-on (Chaoz Fantasy, Heaven, Phazd) — graphics, audio, touch and physical-button input, and save data (12 medals, per-level progress across all 5 levels) all confirmed working on real hardware. See port_progress.md for the full bug-by-bug diagnosis log (every fix is backed by a real console log — no guessing).

✨ What Works

• Native ARM Execution: libimpossible.so (armeabi-v7a) runs directly on the Vita's CPU via the soloader — no interpretation/emulation of game code.
• Full Native UI: all 7 menu states (main menu, level select, pause, how-to-play, stats, medals, victory) reimplemented in C, with dual touch + D-Pad/face-button navigation.
• vitaGL Graphics Pipeline: OpenGL ES 1.1 fixed-function rendering (vertex arrays, ortho projection, blending) at native 960×544, built from source as a vendored submodule (see Building from Source below — this was required to fix a persistent black-screen bug).
• Full Audio: dedicated multithreaded SceAudioOut mixer (44.1kHz stereo), streaming BGM (menu/gameplay/practice tracks) and preloaded, latency-free SFX, all decoded from Ogg Vorbis via stb_vorbis.
• Complete Input Mapping: Cross/D-Pad-Up to jump, Triangle/R1 to place a practice flag, Square/L1 to remove it, Start/Circle to pause — plus full front-touch-panel support, mapped 1:1 to both menu navigation and in-game touch-to-jump.
• Persistent Save Data: jumps, attempts, 12 unlocked medals, and per-level/per-mode progress across all 5 levels saved to ux0:data/theimpossiblegame/save.dat, synced bidirectionally with the native library's own getters/setters.
• Incremental File Logging: every run writes a fresh logs/log_NNN.log, used throughout triage on real hardware (see source/utils/logger.c).
• Level Pack support (5 levels total): the official add-on APK (05133-Impossible-Level-Pack.apk, package com.flukedude.impossiblegamelevelpack) is supported by swapping in its libimpossible.so (same 11 JNI exports, different symbol prefix) and merging its extra assets — see Level Pack Installation below. Level select, stats, and medals menus scale from 2 to 5 levels / 3 to 6 subpages automatically.

⚠️ Known Issues / Pending Work

• None currently open. If FlukeDude ever ships further add-on content beyond the Level Pack, it would need the same kind of analysis (see PORTING_PLAN.md §6) before it could be integrated.

---

📋 Prerequisites

To run this port on your PS Vita or PS TV, you will need:

1. A PS Vita / PS TV console running Custom Firmware (HENkaku or Enso), firmware 3.60/3.65 or later recommended.
2. kubridge installed as a kernel plugin (ur0:tai/config.txt under *KERNEL).
3. libshacccg.suprx installed in ur0:data/ (required by vitaGL's fixed-function shader compiler).
4. A legally obtained copy of The Impossible Game for Android (05133-the-impossible-1.5.2.apk, package com.flukedude.impossiblegame).
5. (Optional, for 3 extra levels) A legally obtained copy of the Level Pack add-on for Android (05133-Impossible-Level-Pack.apk, package com.flukedude.impossiblegamelevelpack).

---

📦 Installation Instructions

1. Install the theimpossiblegame.vpk file on your console using VitaShell.
2. On your PC, place 05133-the-impossible-1.5.2.apk in the project root (or extract it into theimpossiblegame_extract/).
3. Use psvita-port-toolkit (the standalone tool this port is managed with) to extract libimpossible.so from the APK and prepare the asset files — open the toolkit and select "Continuar con un port existente" pointing at this folder.
4. Transfer the resulting game data to ux0:data/theimpossiblegame/ via FTP or USB using VitaShell.

Final File Structure in ux0:data/theimpossiblegame/

ux0:data/theimpossiblegame/
├── libimpossible.so   <- Native library extracted from the APK
├── res/               <- Textures (drawable/) and audio (raw/, .ogg)
├── assets/            <- Fonts and other packaged assets
├── logs/              <- Incremental debug logs (log_NNN.log)
└── save.dat           <- Created at runtime (jumps, attempts, medals, progress)

---

🎁 Level Pack Installation (5 levels, optional)

This VPK (v1.2.0+) supports both the base game (2 levels) and the Level Pack (5 levels) dynamically. If you only have 05133-the-impossible-1.5.2.apk, simply extract it and copy its files; the game will boot in 2-level mode. If you own 05133-Impossible-Level-Pack.apk, you can add its content on top of the base install to unlock all 5 levels:

1. Unzip 05133-Impossible-Level-Pack.apk (it's a standard zip archive) on your PC.

2. Back up the base .so first (optional but recommended, to be able to revert to 2 levels):

   ux0:data/theimpossiblegame/libimpossible.so → libimpossible.so.base-2level.bak
   

3. Copy the following files from the unzipped Level Pack into ux0:data/theimpossiblegame/ on your console, overwriting/merging with the existing folder:

   From the Level Pack APK	To ux0:data/theimpossiblegame/
   lib/armeabi-v7a/libimpossible.so	libimpossible.so (overwrite)
   res/raw/soundtrack2.ogg, soundtrack3.ogg, soundtrack4.ogg	res/raw/
   res/drawable/menustartlevel2button.png (+pressed), menustartlevel3button.png (+pressed), menustartlevel4button.png (+pressed)	res/drawable/
   res/drawable/statspage4.png, statspage5.png, statspage6.png	res/drawable/
   res/drawable/medalspage4.png, medalspage4l.png, medalspage5.png, medalspage5l.png, medalspage6.png, medalspage6l.png	res/drawable/

4. Relaunch the game. The game will automatically detect the Level Pack .so: Level select expands to all 5 levels, and Stats and Medals scale to 6 subpages.

Notes:

• The Level Pack's .so exports the same 11 JNI functions as the base game under a different symbol prefix (impossiblegamelevelpack instead of impossiblegame) — this port resolves both automatically at runtime with zero user intervention.
• If you run with the base game's .so, the menu automatically stays in 2-level mode and 3 subpages, avoiding missing texture errors.
• statspage4/5/6.png only ship at the pack's original mdpi resolution (no landscape crop) — this port already accounts for that, it's a minor, cosmetic sharpness difference only.
• Your existing save.dat will be reset the first time you launch with the new .so (the save layout grows from 6 to 12 medals and from 2 to 5 levels of progress) — this is expected, not a bug.
• See PORTING_PLAN.md §6 for the full technical write-up (symbol verification, asset diffing, risk analysis).

---

🛠️ Building from Source

This port does not keep a local copy of porting_tools/ — all build, deploy, log, and LiveArea workflows are handled by psvita-port-toolkit, a standalone tool kept outside this repository.

vitaGL is vendored as a git submodule (lib/vitagl) and compiled from source by CMakeLists.txt itself, instead of linking the prebuilt libvitaGL.a from the global VitaSDK install — a hand-patched copy of that global library was the confirmed root cause of a persistent, silent black-screen bug (audio and game logic ran fine; the framebuffer itself was never written to). Building vitaGL from source, pinned by this project, avoids depending on that shared, mutable state. See port_progress.md for the full diagnosis.

Build Prerequisites

• VitaSDK, fully compiled with softfp usage (vitasdk-softfp/vdpm).
• VitaSDK libraries: vitashark, kubridge, pthread.
• CMake and Make.
• Run git submodule update --init before the first build (fetches lib/vitagl).

Build Steps

git submodule update --init
cmake -Bbuild .
cmake --build build

This produces build/theimpossiblegame.vpk. For day-to-day development (build + deploy + log fetching), use psvita-port-toolkit instead of raw cmake/make.

---

🏗️ Project Structure

• source/: Native C loader — lifecycle (main.c), and the native reimplementations of the Android UI/audio/persistence layers (menu.c, audio.c, texture.c, save.c).
• source/utils/: Loader plumbing — SO relocation/init (init.c), vitaGL setup (glutil.c), incremental file logger (logger.c), fatal-error dialogs (dialog.c).
• lib/: Auxiliary libraries (so_util, falso_jni, vitagl — git submodule, built from source, see above —, libc_bridge, fios, sha1, stb_image.h, stb_vorbis.c).
• extras/: LiveArea assets (icon0.png, bg0.png, pic0.png, startup.png, template.xml).
• PORTING_PLAN.md: Living plan — engine findings, JNI export table, checklist.
• port_progress.md: Bug-by-bug diagnosis log, one confirmed bug at a time, backed by real console logs.

---

⚖️ Disclaimer

The Impossible Game is a registered trademark of FlukeDude. The work presented in this repository is not "official" or produced or sanctioned by FlukeDude or any other registered trademark mentioned in this repository.

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

---

👥 Credits and Acknowledgements

• FlukeDude: Original developer of The Impossible Game.
• TheFloW: For so_util, kubridge, and foundational techniques for loading Android executables on PS Vita.
• Rinnegatamante: For vitaGL/vitaShaRK and continued support to the PS Vita porting scene.
• v-atamanenko: For FalsoJNI and the soloader-boilerplate base template.
• Sean Barrett (nothings): For stb_image.h and stb_vorbis.c, used for texture and Ogg Vorbis audio decoding.
• Vita Community: To all developers and enthusiasts in the PS Vita homebrew community.

---

License

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