Shadow Guardian Vita v1.2.3

Shadow Guardian Vita v1.2.3

This is a wrapper/port of Shadow Guardian HD for the PS Vita.

Changelog

• v1.2.3: The startup data check in init.c now also validates gui_1_6/gui_1_7 (flat or under GloftSGHP/), the same way it already did for sprites_1_6/sprites_1_7. A tester's console crashed mid-gameplay with the same SpriteMgr::LoadSprite signature as v1.2.2 even though the startup check passed — the log showed gui_1_6 was also missing from their data copy, which the old check never looked for. This doesn't fix the crash by itself (the data still needs to be there), but a missing gui_1_6/gui_1_7 now shows a clear "missing game data files" dialog on boot instead of an opaque native crash later in gameplay.

Setup Instructions

In order to properly install the game, you'll need to extract the data from the original Android game.

1. Install the kubridge and fd_fix plugins on your PS Vita.
2. Install libshacccg.suprx, if you don't have it already, by following this guide.
3. Obtain the original APK of Shadow Guardian (Shadow-Guardian-HD-v1-0-1-UK-RU.apk) and the required data files.
4. Extract the .apk using any zip extractor.
5. Place the executable libshadowguardian.so (from lib/armeabi-v7a/ inside the APK) in ux0:data/shadowguardian/. (If the APK also contains libStormGLOFT.so, you can copy it too — it does no harm.)
6. Place all game asset folders (res, shaders, textures, models, music, sounds, etc.) in ux0:data/shadowguardian/.
7. Make sure the 16:9 assets sprites_1_7 and gui_1_7 are present. If the APK only ships the sprites_1_6 / gui_1_6 variants, duplicate them with VitaShell (Copy + Paste + Rename) so the _1_7 names exist — missing 16:9 GUI assets can crash the game on the LOADING screen. Also confirm the res/ folder was copied.
8. Double-check that gui_1_6 and sprites_1_6 themselves are also present in ux0:data/shadowguardian/ (not just the _1_7 copies) — some assets are only ever requested by their _1_6 name at runtime, and a copy missing just these two files can pass every other check and still crash later during gameplay.
9. Download and install shadowguardian.vpk on 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:

1. You installed the latest shadowguardian.vpk (older builds have known crashes that are already fixed).
2. kubridge and fd_fix plugins plus libshacccg.suprx are installed (see Setup above).
3. In ux0:data/shadowguardian/: libshadowguardian.so, the res/ folder, and all asset folders are present, and both the _1_6 and _1_7 variants of sprites and gui exist (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 missing gui_1_6/gui_1_7 or sprites_1_6/sprites_1_7 shows 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:

1. The newest ux0:data/shadowguardian/logs/game_log_*.txt (from the time of the crash — do not delete it).
2. The newest ux0:data/psp2core-*-eboot.bin.psp2dmp core dump.
3. A note on exactly when it happens (on boot, which level loading, do you ever reach the menu?).

Credits

• TheFloW for the so_loader wrapper and Android porting boilerplate.
• Rinnegatamante for vitaGL and porting tools.
• Gameloft for the original game.