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

README.md

9900 bytes · Original / download

The Case of the Golden Idol - PS Vita Port

The Case of the Golden Idol - PS Vita Port

A port of The Case of the Golden Idol for the PlayStation Vita, adapted from the original Godot Engine PC release. This repository contains the source scripts, patching engines, and tools created to adapt the game to run natively on the PS Vita hardware.

Installation

  1. Head to the Releases tab.
  2. Download the latest GoldenIdol-Patch.zip and GoldenIdol-Vita-x.x.x.vpk.
  3. Extract GoldenIdol-Patch.zip into a new folder on your PC.

HOW TO APPLY THE PATCH:

  1. Open Steam, right-click on "The Case of the Golden Idol", go to Manage -> Browse local files.
  2. Copy the file named game.pck from that folder.
  3. Paste the game.pck file EXACTLY INTO THE DataSteam FOLDER of your extracted patcher.
  4. Go back to the main patcher folder and run ApplyPatch.bat. Follow the on-screen instructions to select your language.
  5. Wait for the process to finish. It will automatically apply the patch and create a new folder named game_data containing your patched game file.
  6. Install the GoldenIdol-Vita-X.X.X.vpk on your PS Vita using VitaShell or FMVita (my personalized VitaShell).
  7. Connect your Vita via FTP or USB, and copy the entire newly created game_data folder into your Vita's game app folder at: ux0:app/IDOL00001/ (This ensures the file ends up exactly at ux0:app/IDOL00001/game_data/game.pck, not just the root app folder).
  8. Have fun!

⚠️ Note: You MUST own the original game on Steam to generate the Vita playable files. No game assets are provided in this repository.

UPDATE NOTICE: IF YOU WISH TO UPDATE THE GAME, PLEASE UPDATE THE GAME FILES AS WELL ('game.pck'), NOT JUST THE VPK. Rest assured, save files are not lost when uninstalling or updating the game (they are stored in 'ux0:data\godot\app_userdata\The Case of Golden Idol...).


Controls (Controles)

PS Vita Controls

| Control | Action | Control | Action | |:---:|:---|:---:|:---| | | Zoom In / Zoom Out | | Confirm / Interact | | | Show / Hide highlights | | Cancel / Back | | | Move while zoomed | | Open Thinking Panel | | | Mouse control | **SELECT** | Options | | | Interact (click) | | |

Screenshots


Main Tools Used

This port was made possible thanks to the following incredible tools:

GDRE_Tools

GODOT PSVita

AssetStudio


Python Automation Tools

A set of .py tools automate the adjustments needed to fit the PC assets within the PS Vita constraints. They now live in the Tools/ folder, organised by category (see Tools/README.md for full details and usage):

Tools/stex/ — low-level .stex (StreamTexture) format operations | Script | Purpose | | :--- | :--- | | fix_vram_textures.py | Repoints VRAM (mode=2) textures to the RGBA4444 variant the Vita can actually render (fixes white/black textures). | | fix_webp_stex.py | Swaps large lossless-WebP .stex that the Vita can't decode for their uncompressed variant. | | halve_stex.py | Downscales an uncompressed RGBA4444 .stex 2x (packing-agnostic). | | resize_stex.py | Fractional (num/den) downscale of an uncompressed RGBA4444 .stex. |

Tools/textures/ — texture / asset optimisation | Script | Purpose | | :--- | :--- | | lossless_vita_optimizer.py | Repacks oversized textures into Power-of-Two grids and rewrites the scene Rect2 coords. | | build_beach_textures.py | Rebuilds the DLC beach scene textures (dithered RGBA4444 + frame repack) for CDRAM. | | adjust_anim.py | Choreographs the custom "Ported by WolffsRoom" splash animation into the boot sequence. | | fix_idol_animation.py | Restores the splash statue atlas and applies bilinear filter + scale tweaks. |

Tools/project/ — project hygiene | Script | Purpose | | :--- | :--- | | cleanup_unused.py | Detects and moves unused scenes + prototype images out of the build (smaller PCK), with an undo manifest. | | restore_imports.py | Selective import strategy (lossless for NPOT, VRAM for POT) to avoid the PowerVR GPU crash. |

Tools/vita/ — Vita platform configuration | Script | Purpose | | :--- | :--- | | apply_vita_settings.py | Forces the Vita target settings into project.godot. | | patch_sfo_extended_memory.py | Patches PARAM.SFO for the extended memory mode. |

Tools/patches/ — GDScript / content patches | Script | Purpose | | :--- | :--- | | fix_steam_issues.py | Removes Steamworks dependencies that would crash the console runtime. | | patch_dlcs_v2.py | Unlocks both DLCs (Spider of Lanka & Lemurian Vampire) locally. | | patch_credits_v4.py | Injects the custom port splash into the boot/credits sequence. | | improvements.py | Input/control rewrites (virtual cursor, zoom, Select -> cancel). |

Tools/trophy/ — trophies | Script | Purpose | | :--- | :--- | | build_trp.py | Packs the Steam-derived trophy set into a PS Vita TROPHY.TRP (NoTrpDrm format). |

The distributable patcher engine (build_patch.py, patch_apply.py, patch_engine_animated.py) ships with the patcher in the Releases tab.


Improvements for the PS Vita

Since this port is based on the Godot version, I took the liberty (as it was easy) of reworking several parts of the game to make it feel native on the console:

Controls and input: - Mouse support: Virtual cursor/mouse system driven by the analog stick. - Reworked controls: Replaced the original Xbox-style scheme to make better use of the PS Vita's buttons. - Help screen: The on-screen command list now shows the real PS Vita controls instead of the PC ones. - "O" (Cancel) fix: It was mapped to both accept and cancel, causing menus to close and immediately reopen; it now performs cancel only. - Mouse Speed setting: Configurable cursor speed slider under Settings.

Zoom: - Progressive zoom: Holding L/R or D-Pad Up/Down now zooms smoothly (continuous) instead of fixed steps, both for the scene camera and the Thinking Panel. - Thinking Panel zoom: Zoom the deduction board (up to 3x) to read the text on the small screen, with an opaque backdrop so the game scene is never exposed at the edges. - Hint zoom: The hint illustrations can be zoomed and panned the same way.

Visual and UI: - Touch-optimized screens: Reworked screens such as the main menu (splash_screen_dlc) for the touch screen. - Screen-opening animations: Added/improved animations for menus, dialogs and transitions. - Scene-only transitions: The black transition between locations now only covers the scene, keeping the toolbar visible. - Overhauled Credits & Discord supporters screens: Rolling credits that return automatically when finished. - Brightness setting: New Settings slider that fades the screen darker or lighter. - Object-description box: Fixed the text centering inside the item description box.


Planned Improvements


Known Issues


IA Notice

This project utilized Gemini 3.1 Pro through the Antigravity IDE to optimize the creation of the Python scripts, compile differential patchers, and automate the extensive pipeline needed to port the Golden Idol Godot project to the PS Vita.


Follow my other work here as well: https://wolffsroom.wordpress.com/