Repository navigation
Shadow Guardian Vita v1.2.5
Shadow Guardian Vita v1.2.5
This is a wrapper/port of Shadow Guardian HD for the PS Vita.
Changelog
- v1.2.5: Fixed broken rendering on interactable objects.
shaders/interactible_basic.xml,interactible_bump.xml, andinteractible_shadowmap.xml(the engine's own shader source, shipped inside the original game data) use GLSL that Android's GLES driver quietly accepts but the Vita's on-device Shark compiler (shark_compile_shader_extended()) rejects outright: avec4(1)constructor without an explicit float literal in all three, and — in_bumponly — anOutlineSizeuniform that's read in the shader body but never declared. All three previously failed to compile on Vita; the v1.2.1 and v1.2.4 hotfixes only stopped the game from crashing when that happened (a symptom of the bug, not the cause), so the interactable objects using these shaders kept rendering without their proper material/shading even on a "successful" boot. Found by diffing a tester's working data folder against a clean APK data dump — the only differences were these 3 files, hand-patched locally but never shipped. Corrected copies are now bundled inside the VPK (extras/shader_patches/) and installed toux0:data/shadowguardian/shaders/automatically on every boot (apply_shader_patches()insource/utils/init.c), so this is fixed for every tester regardless of which data dump they installed from — no manual file replacement needed.
Setup Instructions
In order to properly install the game, you'll need to extract the data from the original Android game.
- Install the
kubridgeandfd_fixplugins on your PS Vita. - Install
libshacccg.suprx, if you don't have it already, by following this guide. - Obtain the original APK of Shadow Guardian (
Shadow-Guardian-HD-v1-0-1-UK-RU.apk) and the required data files. - Extract the
.apkusing any zip extractor. - Place the executable
libshadowguardian.so(fromlib/armeabi-v7a/inside the APK) inux0:data/shadowguardian/. (If the APK also containslibStormGLOFT.so, you can copy it too — it does no harm.) - Place all game asset folders (
res,shaders,textures,models,music,sounds, etc.) inux0:data/shadowguardian/. - Make sure the 16:9 assets
sprites_1_7andgui_1_7are present. If the APK only ships thesprites_1_6/gui_1_6variants, duplicate them with VitaShell (Copy + Paste + Rename) so the_1_7names exist — missing 16:9 GUI assets can crash the game on the LOADING screen. Also confirm theres/folder was copied. - Double-check that
gui_1_6andsprites_1_6themselves are also present inux0:data/shadowguardian/(not just the_1_7copies) — some assets are only ever requested by their_1_6name at runtime, and a copy missing just these two files can pass every other check and still crash later during gameplay. - Download and install
shadowguardian.vpkon your PS Vita.
Controls
- Left Analog - Movement (in-game only)
- Right Analog - Camera (free-look)
- D-Pad - Menu Navigation / Movement
- R - Fire
- L / Square - Aim (hold)
- Cross - Contextual action (jump / run / grab / climb)
- Triangle - Reload / Switch weapon
- Circle - Toggle Virtual Buttons (Hide/Show HUD layout)
- Start - Pause / Back
- Select - Menu
- Touch Screen - Original Touch Controls
Known Issues
- Reload/weapon touch position (Triangle) confirmed by layout only; verify in combat on hardware.
- [Update this section prior to release with any remaining unresolved bugs]
Troubleshooting
Crash on the LOADING screen (C2-12828-1 error): this is usually a data setup problem, not a game bug. Check the following with VitaShell:
- You installed the latest
shadowguardian.vpk(older builds have known crashes that are already fixed). kubridgeandfd_fixplugins pluslibshacccg.suprxare installed (see Setup above).- In
ux0:data/shadowguardian/:libshadowguardian.so, theres/folder, and all asset folders are present, and both the_1_6and_1_7variants ofspritesandguiexist (sprites_1_6,sprites_1_7,gui_1_6,gui_1_7) — copy whichever ones are missing from the variant you do have. As of v1.2.3, a missinggui_1_6/gui_1_7orsprites_1_6/sprites_1_7shows a clear "missing game data files" dialog on boot instead of crashing later — if you see that dialog, it's telling you exactly which one to fix.
If it still crashes, please report it with:
- The newest
ux0:data/shadowguardian/logs/game_log_*.txt(from the time of the crash — do not delete it). - The newest
ux0:data/psp2core-*-eboot.bin.psp2dmpcore dump. - A note on exactly when it happens (on boot, which level loading, do you ever reach the menu?).
Credits
- TheFloW for the
so_loaderwrapper and Android porting boilerplate. - Rinnegatamante for
vitaGLand porting tools. - Gameloft for the original game.