METEOR VII VITA changelog
v1.3.1 · Nov 16, 2026
This release adds a solid-black side-border option and fixes PlayStation button
prompts that were missing when using the original Android game data without a
modified field archive.
What's fixed
- Stock Android field files whose dialog table follows the stored script length are now accepted, so their button prompts are converted correctly.
- Stock
[A],[B],[X]and[Y]labels are mapped to the corresponding PlayStation glyphs. The existing colored and uncolored(A)/(B)/(X)/(Y)conversion remains available for translated or modified data. - The final field-text rendering path also performs the conversion after the selected language text is ready, covering prompts that were previously not visible in unmodified game data.
Black screens
- Gameplay > SIDE BORDERS < GRADIENT / BLACK > switches every centered 4:3 presentation, including menus and movies, to the selected side borders.
- The choice is saved as
borders_black 0/1incheats.txt.
Update / installation
Install ff7_vita_v1.3.1.vpk with VitaShell over the previous version.
Keep the existing APK, OBB, saves and settings. No game data is included.
Validation
- Host tests cover stock and modified field layouts, all four stock labels, original button opcodes, colored labels and uncolored labels.
- Existing compositor and settings tests cover the side-border option.
- The release package is checked for accidental game data.
FINAL FANTASY VII © SQUARE ENIX. This project is not affiliated with or endorsed
by Square Enix.
v1.2.0 · Nov 5, 2026
This update adds selectable encounter calculation multipliers to the port menu,
with separate field and world-map handling, saved settings and runtime diagnostics.
What's new
- Gameplay > ENCOUNTER RATE replaces the ON/OFF option with 0 (OFF), 1 (NORMAL), 2X and 4X. Changes apply without restarting the game.
- Field encounters scale their probability parameter during the original check, then restore it. World-map encounters scale the original effective rate after the game's Enemy Lure/Away calculation. Movement speed is unchanged.
- The selected setting is saved in
ux0:data/ffvii-vita/cheats.txt. Existingencounters 0andencounters 1configurations remain compatible; the default is NORMAL. - The optional Android touch button still shows ON/OFF. Turning encounters back on resumes the last active multiplier during the current session. Restarting with OFF saved resets the next activation to NORMAL.
- ENCOUNTERS BUTTON: SHOW/HIDE remains independent of the encounter rate.
- Runtime logs now include the selected factor, field/world hook call counts and the original/effective rates, making device reports easier to verify.
- If multiplier hooks are unavailable for an unsupported library layout, the menu falls back to OFF/NORMAL.
How 2X and 4X behave
**These labels multiply the game's encounter calculation parameters, not the
number of battles per minute or per distance traveled.** The original game
accumulates danger and uses random checks, so battle frequency is not linear.
A deterministic ARM simulation of 10,000 world-map checks on the same terrain,
modeling a battle return by resetting danger, produced:
| Setting | Encounters | Relative to NORMAL |
| --- | ---: | ---: |
| 1 (NORMAL) | 1,005 | 1.00× |
| 2X | 1,459 | 1.45× |
| 4X | 2,096 | 2.09× |
These are simulation results for one setup, not guarantees for other areas or
hardware measurements. A first device log confirmed hook installation, but did
not record enough information to verify the active rate during walking.
Confirmation of the frequency changes on Vita remains pending.
Update / installation
Install ff7_vita_v1.2.0.vpk with VitaShell over the previous version.
Keep existing game data and settings; back up ux0:data/ffvii-vita/save/ before
updating. No replacement APK or OBB is needed.
New installations require a homebrew-enabled PS Vita, kubridge.skprx,libshacccg.suprx, and the user's own Android FINAL FANTASY VII v1.0.29
data, copied intact to:
ux0:data/ffvii-vita/base.apk ux0:data/ffvii-vita/main.30.com.square_enix.android_googleplay.FFVII.obb
Controls
Hold L + R and press Start to open the port menu. Select Gameplay
with L/R, select ENCOUNTER RATE with Up/Down, then use Left/Right
or Cross to cycle settings. Press Circle to close.
Validation and known limitations
- Host tests cover rate selection, settings compatibility and persistence, touch OFF/ON behavior, independent button visibility, field rate restoration and world-map multiplication.
- ARM tests verify the original field probability comparison, Enemy Lure/Away rates and the world-map danger accumulation/random comparison.
- Release build and package checks passed; the VPK contains no game data.
- Multipliers retain the original encounter rules. On-device frequency and transition validation remain pending.
- Snowboard music remains silent. Some scenes may expose background or geometry limitations in widescreen; switch back to 4:3 if needed.
See [the validation record](RELEASE-v1.2.0-VALIDATION.md). For bug reports, include
the location, selected encounter rate, steps to reproduce, andux0:data/ffvii-vita/logs.txt plus logs_anterior.txt. To test rate handling,
walk in the same area with NORMAL and 4X before collecting the logs.
Credits
Port by Gustavo Garcia (ggdrn), with AI-assisted development.
Thanks to the contributors behind soloader-boilerplate, so-util, FalsoJNI,
vitaGL, VitaSDK, kubridge and the Vita homebrew community.
The VPK contains the port only. Game data must be supplied by the user.
FINAL FANTASY VII © SQUARE ENIX. This project is not affiliated with or endorsed
by Square Enix.
v1.1.0 · Nov 2, 2026
This update adds direct control over random encounters and an option to hide the
Android encounter button for a cleaner screen.
What's new
- Gameplay > RANDOM ENCOUNTERS: ON/OFF controls random encounters directly from the port menu, including while the on-screen button is hidden.
- Gameplay > ENCOUNTERS BUTTON: SHOW/HIDE shows or hides the touch button. Hiding it also removes its touch target and leaves the encounter setting unchanged.
- The menu and on-screen button share the same encounter state. Changes apply immediately and are saved in
ux0:data/ffvii-vita/cheats.txt, including encounter changes made by touching the visible button. - Existing configurations default to encounters ON and button SHOW.
Update / installation
Install ff7_vita_v1.1.0.vpk with VitaShell over the previous version. Keep
existing game data and settings; back up ux0:data/ffvii-vita/save/ before updating.
No replacement APK or OBB is needed for this update.
For a new installation, the requirements remain the same: a homebrew-enabled
PS Vita, kubridge.skprx, libshacccg.suprx, and the user's own Android FINAL
FANTASY VII v1.0.29 game data. Copy the original files intact to:
ux0:data/ffvii-vita/base.apk ux0:data/ffvii-vita/main.30.com.square_enix.android_googleplay.FFVII.obb
See the installation guide
for the complete setup instructions.
Controls
Hold L + R and press Start to open the port menu, then select Gameplay
with L/R. Use Up/Down to select, Left/Right or Cross to change a
setting, and Circle to close. No restart is needed for either encounter option.
Known limitations
- Snowboard music remains silent.
- Some scenes may expose background or geometry limitations in widescreen; switch back to 4:3 if a scene does not display correctly.
- Automated tests and the release build passed. On-device validation of the new options remains pending; see [the validation record](RELEASE-v1.1.0-VALIDATION.md).
For bug reports, include the port version, location, selected screen mode, steps
to reproduce and ux0:data/ffvii-vita/logs.txt plus logs_anterior.txt.
Credits
Port by Gustavo Garcia (ggdrn), with AI-assisted development.
Thanks to the contributors behind soloader-boilerplate, so-util, FalsoJNI,
vitaGL, VitaSDK, kubridge and the Vita homebrew community.
The VPK contains the port only. Game data must be supplied by the user.
FINAL FANTASY VII © SQUARE ENIX. This project is not affiliated with or endorsed
by Square Enix.
v1.0 · Oct 30, 2026
An unofficial port of the Android version of FINAL FANTASY VII to PlayStation Vita.
The original ARMv7 game library runs on the Vita through a compatibility layer,
with rendering provided by vitaGL.
Highlights
- Optional 16:9 widescreen for fields, battles and the world map. Switch between 4:3 and 16:9 in the port menu. Menus and movies retain their original aspect ratio.
- Widescreen adjustments for field backgrounds, world map terrain, sky and clouds, battle viewports, HUD alignment and dialog windows.
- Native optimizations for field rendering, the world map, battles and 3D minigames, including texture caching and GPU palette rendering.
- Frame pacing and performance improvements for the submarine, chocobo racing, roller coaster, snowboard and G-bike minigames.
- Physical Vita controls, PlayStation button prompts and right-stick camera rotation on the world map.
- A port menu with gameplay settings and optional cheats: movement speed, automatic dialog advance, language selection, EXP/gil multipliers, infinite HP/MP and materia selection.
- Audio, movie presentation and minigame input fixes from earlier releases.
- Developer tools are hidden from the standard port menu.
Requirements
- A PS Vita capable of running homebrew.
kubridge.skprxinstalled and enabled in the*KERNELsection of your taiHEN configuration.libshacccg.suprxinur0:data/orur0:data/external/.- Your own legally purchased Android copy of FINAL FANTASY VII, version 1.0.29.
- Approximately 2.1 GB of free space for the game data, plus space for the port.
Installation
- Install
ff7_vita_v1.0.vpkwith VitaShell. - Copy the following files from your Android installation to the Vita:
ux0:data/ffvii-vita/base.apk ux0:data/ffvii-vita/main.30.com.square_enix.android_googleplay.FFVII.obb
- Keep the APK and OBB intact; the port reads them directly.
- Launch FINAL FANTASY VII from LiveArea.
If you already use an earlier version, install the VPK over it and keep your
existing game data. Back up ux0:data/ffvii-vita/save/ before updating.
See the installation guide
for details.
Port menu
Hold L + R and press Start. Use L/R to switch tabs, Up/Down to
select an item, Left/Right to change it, Cross to confirm and Circle
to close the menu.
The standard menu contains Cheats and Gameplay.
In Gameplay, choose SCREEN to toggle 4:3/16:9. Language choices are
English, French, German, Spanish and Japanese; language changes apply after
restarting the game. Gameplay and cheat settings are stored in cheats.txt.
For bug reports, include the port version, location, selected screen mode,
steps to reproduce and ux0:data/ffvii-vita/logs.txt plus logs_anterior.txt.
Credits
The VPK contains the port only. Game data must be supplied by the user.
FINAL FANTASY VII © SQUARE ENIX. This project is not affiliated with or endorsed
by Square Enix.
v0.09.00 · Oct 26, 2026
Install ff7_vita_v0.09.00.vpk over any previous version. Game data stays inux0:data/ffvii-vita/ ([DATA.md](DATA.md)); no game data is included.
New: port menu
Hold L + R and press Start. L / R switch tabs; the bottom of the menu
explains the selected item. Choices are saved in cheats.txt.
- Cheats: infinite HP/MP; battle EXP and gil x2/x3/x4; add any materia (picked by color) or summon, at level 1 or max.
- Gameplay: faster walking/running in fields and on foot on the world map (x2/x3/x4, nothing else speeds up); automatic dialog skip (questions are left to you); dialog language (English, French, German, Spanish, Japanese, applied at the next start); back to the title to load another save.
- Debug: shortcuts to every 3D minigame and to the world map on the buggy, submarine or Highwind; scene markers; profiler and A/B switches for reports.
Performance
- Minigames: steady 30 fps in the submarine (was 27.5), roller coaster and chocobo race (was 16–24); snowboard capped at a steady 30 fps; faster G-bike. Most of their drawing and math now runs as native code checked against the original.
- Animated palettes: paletted textures go to the GPU as indexes + palette instead of being converted on the CPU every time a palette changes (Chocobo Square 15 → 27 fps, chocobo ranch faster). Repeated conversions are cached.
- Fields: native vertex lighting and background tile lists, faster triangle submission for every 3D scene.
- World map: triangle and projection code faster again (no calls back into the game library in the hot loops).
- Battles: native vertex color scaling (~12% of the game thread).
Fixes
- Button prompts show the right PS symbols: ✕ confirms, ○ cancels.
- First menu sound and save/load sounds are no longer missing.
- 448-line FMVs (e.g. the G-bike intro) fill the screen without distortion.
- Submarine: Square and the on-screen L2/R2 and R1+R2 buttons work.
- Less audio stutter when minigames stop and restart sounds.
Switches
New in ux0:data/ffvii-vita/:
| File | Effect |
|---|---|
| natives_off.txt | every native replacement off (tells a port bug from the game) |
| vcolor_off.txt, tri_off.txt, tri2_off.txt, math_off.txt, light_off.txt, texture_off.txt | one native module off |
| snowboard_60fps.txt, coaster_60fps.txt | leave that minigame uncapped |
| submarine_limiter_off.txt, chocobo_limiter_off.txt | keep the game's own limiter |
Known issues
- Leaving the profiler on into a battle can crash the game; record short profiles.
When reporting a problem, send logs.txt and logs_anterior.txt.
v0.6.0 · Oct 20, 2026
Install ff7_vita_v0.6.vpk over any previous version. Game data stays where it was
(ux0:data/ffvii-vita/, see [DATA.md](DATA.md)); no game data is included.
Performance
- World map native renderer. The four hottest routines of the world map renderer (
0x75F0AD,0x75F263,0x68DAE1,0x75F68C) were replaced with native ARM implementations that produce identical results. Together they accounted for ~57% of the game thread on the world map. Frame rate went from 19–23 fps (v0.5) to a steady 30 fps. - Faster paletted texture conversion. Fields that recreate palettised textures every frame had separate conversion and GL sync costs of ~22% of the game thread. The conversion loop is now split by destination format (one table lookup and one write per pixel); GL texture names are pre-generated on the render thread so
glGenTexturesnever stalls waiting for the queue.
Controls
- Right analog stick rotates the world map camera. Deflect right to rotate right, left to rotate left — same speed as holding L/R. The buttons still work as before. The stick has no effect outside the world map.
Changes
- Field screen zoom corrected. The zoom introduced in v0.2 was tracking 464 of 480 lines; it now follows the actual drawing area the game sets (448 lines by default), filling 777×544 without distortion.
field_stretch_on.txtstretches to the full 960×544 instead. - Battle mode zoom. The same zoom now applies to battles, removing the black strip under the command menu. The zoom uses 472 lines so that all submenus remain visible.
- Profiler fixed. With
profile_on.txt, the console no longer resets on boot. The sampler now runs on core 0 at higher priority (exact instruction-level samples), activates 20 s after boot (after all startup patches finish), and coordinates safely with the stack-patching pass. - Continuous profiling mode.
profile_all.txtsamples every 20 ms while the game thread is running, instead of only during slow frames. Useful for scenes like the world map that sleep briefly each frame. - World map game mode. When loading a save directly on the world map, the screen zoom now activates correctly (the game mode was not read until the first field screen in earlier versions).
Switches
Creating one of these empty files in ux0:data/ffvii-vita/ controls optional behaviour:
| File | Effect |
|---|---|
| stack_off.txt | stack accesses through the original translation |
| stack_check.txt | checks every stack access and logs any outside the stack (slower) |
| music_async_off.txt | music read on the game thread, as before |
| field_zoom_off.txt | field and battle screens with the bottom strip, as before |
| field_stretch_on.txt | stretch field and battle to the full 960×544 (distorted) |
| glbatch_off.txt | render thread woken on every draw, as before |
| world_off.txt | all world map native routines disabled |
| world_tri_off.txt | world map triangle renderer native routine disabled only |
| selftest_on.txt | runs the native code self-tests on boot |
| profile_on.txt | spike profiler: writes profile.bin for slow frames |
| profile_all.txt | continuous profiler: samples every 20 ms while running |
When reporting a problem, send logs.txt and logs_anterior.txt fromux0:data/ffvii-vita/.
