GitHub Vita Lite - Wolff's Store
Code / README | Releases | Issues
WolffsRoom/pokeemerald-vita-3ds

pokeemerald-vita-3ds

Native PS Vita port of pokeemerald with Emerald 3DS features (no ROM included)

TypeFilenameSize
DIR.github—
DIRasm—
DIRassets—
DIRconstants—
DIRdata—
DIRdesign—
DIRdocs—
DIRgraphics—
DIRinclude—
DIRsound—
DIRsrc—
DIRtools—
DIRvita—
FILE.editorconfig506 B
FILE.gitattributes478 B
FILE.gitignore1431 B
FILEaudio_rules.mk1771 B
FILEbuild_all.bat327 B
FILEbuild_all.ps16157 B
FILEbuild_all.sh6039 B
FILEbuild_vita.ps11128 B
FILEbuild_vita.sh1935 B
FILEcharmap.txt22065 B
FILECMakeLists.txt14722 B
FILECONTRIBUTING.md3462 B
FILEfetch_assets.ps11356 B
FILEfetch_assets.sh4964 B
FILEgraphics_file_rules.mk26351 B
FILEjson_data_rules.mk1501 B
FILELICENSE2319 B
FILEmake_tools.mk575 B
FILEmap_data_rules.mk2439 B
FILENOTICE.md4354 B
FILEREADME.md13560 B
FILEspritesheet_rules.mk20486 B

README

Pokémon Emerald Vita 3DS

Unofficial native PS Vita port of Pokémon Emerald, built from the pret/pokeemerald decompilation. It is not an emulator: the game's C code is compiled for the Vita's ARM CPU, and a platform layer supplies what the GBA hardware did. On top of it, the port brings the features of Emerald 3DS to the Vita with vitaGL:

The full list is under Features.

AI-assisted project. The code, build scripts and documentation were written with an AI coding assistant (Claude Code, by Anthropic) under the supervision of HctrRB, who sets the direction, reviews the changes and tests every build on a real PS Vita.

Legal notice. Pokémon and Pokémon Emerald are © Nintendo, Creatures Inc. and GAME FREAK inc. This project is not affiliated with or endorsed by them. This repository does not contain the game's graphics, sounds or binary data, nor any ROM: to build, you check a dump of your own cartridge and the game files are downloaded from the public decompilation (docs/BUILD_YOUR_OWN.md). Like every decompilation, the tree still holds the game's code and text in decompiled form. A built VPK contains Nintendo's data: do not distribute builds.

Features

3D world

New interface

Drawn natively at 960×544 over the 3D world. Every screen works with the buttons and with touch (first tap selects, a second tap on the selection confirms).

Extras

Physical / special split, infinite TMs, running indoors, IV / EV pages, EXP Share and EXP multiplier, Nuzlocke rules, field HM shortcuts, button remapping.

Status

Work in progress, in active testing. Expect bugs, crashes and unfinished screens. If you find one, please open an issue with the bug report template: what you did, what happened, and the log files from ux0:data/POKEVITA/. Feedback on screens that are missing or feel wrong is very welcome.

Performance: 60 FPS with drops to 55 at 333 / 166 MHz.

Not yet tested on a PS Vita

These parts build and run in the design mocks, but have not been checked on the console yet:

Known issues and gaps

Screens still on the GBA interface:

Visual glitches:

3D world:

Stability:

Repository layout

build_all.bat/.ps1/.sh               one step from your dump to EmeraldVita.vpk
CMakeLists.txt, build_vita.ps1/.sh   Vita build (preprocess → compile → link → SELF → VPK)
make_tools.mk, *_rules.mk, vita/     host tools, asset rules, link wrapper, LiveArea art
src/, include/, asm/, data/,         the pokeemerald decompilation (game code and text data;
constants/                           graphics/, sound/ and data binaries come from fetch_assets)
fetch_assets.sh/.ps1, tools/assets/  game files download (checks your ROM, then the manifest)
src/platform/                        GBA hardware emulation and main loop
src/platform/voxel/                  3D voxel world
src/platform/ui/                     the new interface (screens, widgets, themes)
src/platform/vita/                   Vita-specific features (clock, encounters, extras, stage)
assets/                              port data packed into the VPK (voxel, UI atlas, followers)
tools/                               pret host tools, UI atlas builder (tools/ui2), generators
design/stitch/                       HTML mocks of the new interface
docs/                                technical documentation

Build your own VPK

No builds are distributed: you make your own from your Pokémon Emerald cartridge. Full guide, with every command and the common errors: docs/BUILD_YOUR_OWN.md (en español: docs/COMPILA_TU_VPK.md).

You need a Windows 10/11 PC, your Pokémon Emerald dump (.gba, any language, 16 MB) and a PS Vita with HENkaku or Ensō. Nothing else has to be installed by hand:

  1. Get the repository (git clone, or Code > Download ZIP) into a folder with no spaces or accents in its path and not synced by OneDrive, e.g. C:\Emerald\pokeemerald-vita-3ds.
  2. Double-click build_all.bat in that folder and choose your .gba in the window it opens (or run powershell.exe -ExecutionPolicy Bypass -File .\build_all.ps1 -Rom <file>). It installs what is missing (MSYS2 in C:\msys64, its packages, VitaSDK with vitaGL and SDL2), checks your dump, downloads the game files and checks each one against tools/assets/manifest.txt (nothing is copied from the ROM), and builds everything. The first run takes 20–40 minutes.
  3. Install EmeraldVita.vpk with VitaShell (Enable unsafe homebrew on in HENkaku settings). The game appears as Emerald Vita (title ID PKEM00001); saves and settings live in ux0:data/POKEVITA/.

To update: git pull and run build_all.bat again (the ROM is only asked for the first time; game files a new version needs are downloaded by themselves). The manual steps are in the guide and in docs/BUILD.md.

Do not share the VPK or the downloaded files: they contain Nintendo's game data.

Controls

Button Action
Cross / Circle A / B
D-pad or left stick Move
L / R L / R
START Open or close the touch menu (field)
SELECT Registered item
Triangle Fast forward
Square Options
Touch Menu, battle action deck

Buttons can be remapped in Options. Settings and saves live in ux0:data/POKEVITA/ (see docs/ARCHITECTURE.md).

Documentation

Document Covers
docs/BUILD_YOUR_OWN.md (español) Make your own VPK from your cartridge, step by step
docs/BUILD.md Toolchain, build steps, CMake options, installing and testing
docs/README.md Index of the technical documentation
docs/ARCHITECTURE.md Layers, boot, one frame, where things are, runtime files
docs/THREADS.md Cores, pacing, who owns which data
docs/RENDERING.md Presentation paths, voxel passes, GBA overlay, GPU rules
docs/VITA_UI.md The user interface
docs/VOXEL_ENGINE.md The 3D overworld
docs/SCENES_16_9.md How GBA screens fill 16:9
docs/ASSETS.md Where every data file comes from
docs/DEBUGGING.md Logs, per-frame telemetry, crash dumps
design/stitch/README.md Design mocks of the new UI (Spanish)
CONTRIBUTING.md Code standards and workflow
NOTICE.md Licences of the ported code and credits

Credits