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

README.md

12641 bytes · Original / download

Dome Keeper - PS Vita Port

Dome Keeper - PS Vita Port

Experimental PlayStation Vita port of Dome Keeper, adapted from the Godot PC release and tested with the custom Godot 3.5 RC5 Vita runtime.

Current status: technical preview under active development. The build boots on PS Vita hardware and reaches the in-game LevelStage. The three hard LevelStage blockers — a VRAM out-of-memory crash, texture WebP decode crashes, and map shaders exceeding the GPU's texture-unit limit — have now been addressed, and we are verifying that the map renders on hardware. Remaining work is gameplay rendering and performance. This is not a playable release yet.


Release Status

OVERALL PROGRESS~72%   PS VITAGODOT 3.5 RC5   STATETECHNICAL PREVIEW

The current Vita build has reached these steps on real hardware:

Step Progress
Boot — no C2-12828-1 crash ██████████████  Done
Title menu + background music ██████████████  Done
Controller input ██████████████  Done
New Game / Loadout flow ██████████████  Done
Enter LevelStage / Map ██████████████  Done
VRAM / OOM crash fixed ██████████████  Done
Texture decode — stale .stex ██████████████  Done
Map shaders within 8-sampler limit ██████████████  Done
Map renders on hardware █████████░░░░░  Testing
Playable gameplay loop █████░░░░░░░░░  Pending
Performance tuning ██░░░░░░░░░░░░  Pending
Overall ██████████░░░░  ~72%
What was fixed inside LevelStage (click to expand)
Three separate hard blockers inside `LevelStage` have now been addressed: 1. **VRAM out-of-memory** — the map's `ViewportLights` was allocating a full-size **3D + HDR** render target with post-processing mipmaps (>150 MB). Forced to 2D (`usage = 0`, `hdr = false`). 2. **`Failed decoding WebP`** — 136 stale `.stex` files held **old oversized image dimensions** (resized PNGs never re-imported, e.g. a flag at 2560×1536) that overflowed the Vita's WebP decoder. Regenerated from the current PNGs. 3. **Shaders over the texture-unit limit** — the PowerVR SGX543 exposes only **8 fragment texture units**, but `map_main_stones` (13 samplers) and `map_background_edges` (14 samplers) could not compile. Both reduced to ≤7 samplers. The next step is confirming the map actually renders on hardware.

Downloads

For now, this repository publishes only the experimental VPK from the Releases page.

The final game.pck is not included and is still under development.

You must own the original game. No commercial game assets are provided here.


Installation

  1. Download the latest VPK from the Releases page.
  2. Install the VPK on your PS Vita using VitaShell or FMVita.
  3. A compatible game.pck will be required at the app folder once the data package is stable.

Expected target path:

ux0:app/DOMEKEE01/game.pck

At this stage, the stable game.pck package is still being worked on.


Controls

Button Action
Left Stick / D-Pad Move / Navigate
Cross Confirm / Interact
Circle Cancel / Back
Triangle Gadget / Context action
Square Secondary action
L / R Game actions, depending on state
Start Pause

Controls are still subject to change while the gameplay scene is being stabilized.


Technical Progress

The port has gone through several Vita-specific fixes. The most impactful, in order:

More detail is available in DetailsVitaPort.txt.


Tooling (scripts/)

The scripts/ folder holds the Python utilities written during the port. They operate on the local Vita build folder (absolute paths are embedded in each script — adjust them to your setup). See scripts/README.md for the full layout and safety notes.

Folder Purpose Key scripts
stex/ .stex (StreamTexture) WebP format inspection and repair revert_all_stex.py (the official B→A fix), scan_stex_format.py, check_stex.py, check_mip.py
textures/ Texture / atlas size reduction for the 4096 px and VRAM limits scan_textures_vita.py, optimize_vita.py, resize_stex_v2.py, restore_atlas_stex_v2.py
shaders/ Applies the SCREEN_UV → local-variable (_suv) workaround fix_shaders_vita.py
validate/ Pre-PCK checks of shaders, textures, refs and project settings validate_vitabuild.py, validate_refs.py
restore/ Restore resources from the original/reference PCK restore_all_from_original.py, restore_all_missing.py
audio/ WAV → IMA-ADPCM compression and audio bus patching compress_audio.py, patch_audio.py
_history/ Archived one-off patches and the original combined script blobs (reference only — not meant to be re-run) —

Warning: never run a fix_all_stex-style script. The harmful logic survives only inside _history/combined_scripts_fb1d.py; it re-inserts the broken WebP size prefix. Use stex/revert_all_stex.py to repair instead.


Next Steps


Known Issues


Main Tools Used

GDRE Tools

Used to inspect and extract Godot PCK data during research.

https://github.com/GDRETools/gdsdecomp

Godot PSVita

Custom Godot 3.5 Vita runtime used for hardware testing.

https://github.com/SonicMastr/godot-vita

PrincessLog / NetLoggingMgr

PS Vita network logging tool used to capture hardware crash logs (the princesslog-*.log files that drive most of the debugging above).

godotpcktool

Used during PCK repacking experiments.

https://github.com/hhyyrylainen/GodotPckTool


AI Notice

This project used AI-assisted debugging and code review during the porting process. The work included crash-log analysis, Godot scene inspection, script compatibility fixes, and documentation of Vita-specific issues.


Follow My Work

https://wolffsroom.wordpress.com/