Releases - pokeemerald-vita-3ds
pokeemerald VITA 0.5.4b
Tag: v0.5.4b · 2026-11-17
HD-2D Bloom & Light Shaft Controls (WORLD → RENDERER)
WORLD BLOOM(0 (OFF)–10, default10): Scales exclusively the 3D world luminance bright-pass (VoxelHd2dShader_BrightPassuGain, keeping day/night/indoor thresholds and without touching sky bloom or light shafts).SKY BLOOM(0 (OFF)–10, default5=1.0x,10=2.0x): Controls the directional sun/moon sky glow (sWeatherAtlasTex).LIGHT SHAFTS(0 (OFF)–10, default5=1.0x,10=2.0x): Controls the procedural sun/moon light shafts (VoxelHd2dShader_Shafts).- Dawn & sunset ray strength (
voxel_renderer.c): Adjustedlight.raysscaling (clamp(daylight / 0.35, 0, 1)) so sunrise (05:30–08:00) and sunset (17:00–18:00) keep full daytime shaft/sky-bloom strength with their respective golden/amber tones while fading smoothly into night. - Menu backdrop cache: Invalidates
sMenuBgFbowhen any of the three options changes so previews update immediately behind the Options menu.
pokeemerald VITA 0.5.4
Tag: v0.5.4 · 2026-11-17
Native UI Menu Fixes (Bag, Party & Mail)
- Mail
CHECKin Bag (ui_scr_bag.c,ui_scr_playerpc.c,mail.c): AddedCHECKaction for Mail items inITEMS_POCKET, opening the native stationery viewer (UiMailRead_Open) without text/signature and preventingItemUseOutOfBattle_Mailfrom dereferencinggBagMenu(NULL/ freed). - Mail
GIVEvia Easy Chat (ui_game_items.c,ui_scr_bag.c,ui_scr_party.c): Giving Mail now allocates a save mail slot (GiveMailToMonByItemId) and opens the native Easy Chat editor (EASY_CHAT_TYPE_MAIL), cleanly returning the Mail item if cancelled and blocking held-item overwrites while Mail is equipped. - Party
MAILsubmenu (ui_scr_party.c,ui_game_items.c): Pokémon holding Mail now showMAIL → READ / TAKE(SEND TO PCviaTakeMailFromMonAndSave, orTO BAG (ERASE)viaTakeMailFromMon). - Safe held-item swap (
ui_game_items.c):UiGame_GiveItemnow checksBagAddand rolls back the swap if the old item's pocket is full, preventing silent item loss (compiled; full-pocket edge case pending hardware test). - Enigma Berry & Berry planting (
ui_game_items.c): Added safe dispatch forItemUseOutOfBattle_EnigmaBerrywithoutgBagMenu, andBAG → BERRIES → USEwhile facing an empty berry patch now plants directly viaBerryTree_EventScript_ItemUsePlantBerry.
pokeemerald VITA 0.5.3b
Tag: v0.5.3b · 2026-11-17
HD-2D Sunrays & Day/Night Transition Fixes
- Clear-day & sunny sunrays (\oxel_renderer.c): Enabled sun shafts in normal clear weather (\light.rays = 0.20) and boosted intense sun (\VOXEL_WEATHER_SUN\, \light.rays = 0.30), with higher daytime shaft gain (\1.55\ High / \1.15\ Med) for clear visibility against bright daytime scenes.
- Nocturnal sky glow & morning jump fix: Restored \light.rays *= cycle->daylight\ (removing \cycle->glow\, which is \1.0\ at night) so daytime shafts and sky glow stay strictly \
pokeemerald VITA 0.5.3
Tag: v0.5.3 · 2026-11-17
Performance & Voxel / HD-2D
- Opaque tree cores & HSR: Split static tree trunks/cores from swaying foliage (
voxel_tree.c,voxel_mesh_builder.c) for SGX543 hidden-surface removal. - HD-2D post-FX optimization: Replaced 12 blended
BlurTapswith 3CopyBox2x2passes, reduced sun shaft layers to 2x, softened 3D lamp halos, trimmed motes, and culled point lights. - Smooth atmosphere transitions: Smoothly interpolates zone weather and lighting tone transitions instead of snapping abruptly at map borders.
Fixes & UI Polish
- Match Call & UI: Fixed
match_call.cand polishedui_scr_nav.c,ui_scr_playerpc.c,ui_scr_pc.c,ui_mirror.c, andui_sprites.c.
Build & Packaging
- Telemetry off by default: Set
VITA_TELEMETRYback toOFFinCMakeLists.txt. build_all.shfallback fix: Removes cachedvar/lib/pacman/sync/vita.dband usespacman -Syywhen falling back topackages-2026.08-snapshot-20261115.68.1(and when rotating MSYS2 mirrors) solibalpmdoes not skip the older complete database viaIf-Modified-Since.
pokeemerald VITA 0.5.2
Tag: v0.5.2 · 2026-11-17
Fixes & Improvements
- Double / Gym battle party menu fix:
UiGame_BattlePartyCanCancelnow checks the HP of the specific battler in the menu (gBattlerInMenuId) instead of always the first player battler, andPlayerHandleChoosePokemonpopulates switchout prevention state before openingUi_OpenBattleParty(). - Day & indoor HD-2D bloom fix: Raised the bright-pass luminance threshold to
0.76ffor daytime outdoors and indoors (interpolating smoothly down to0.46fat night viabdn->glow) and changed the bright-pass ramp inkBrightFstok * k, stopping bright floors from glowing while preserving night lamp bloom andbloomAmt. - UI & Voxel rendering:
- Double-buffered post-FX FBOs, capped per-frame atlas syncs, and dropped per-frame CSV
fflushoverhead. - Added tiled 16x16 GBA backdrop textures and double-buffered UI VBOs (
sUiVbo[2]). - Switched animated voxel atlas updates to direct row writes (
WriteAtlasRowsDirect) so active and visible same-primary neighbour slots stay in sync on the same frame, and tracked(sAsyncAtlasGen, sAsyncAtlasExt)on async chunk commits. - Windows / MSYS2
build_all.shresilience: - Rotates MSYS2 mirrors (
/etc/pacman.d/mirrorlist.*) and retriespacman -Syu/pacman -S --neededup to 4 times when upstream mirrors return HTTP 500 or transient download errors. - Falls back to
packages-2026.08-snapshot-20261115.68.1viavdpm pacmanifvdpm install vitaGL sdl2fails on an incomplete upstream2026.08VitaSDK snapshot.
pokeemerald VITA 0.5.1
Tag: v0.5.1 · 2026-11-16
Visible Wild Pokémon: Procedural Overworld Population & Spawn Fix
- Procedural world pool (VW_POOL_MAX = 48) decoupled from the 12 active WILD_SLOTS via bitmask allocation, allowing wild Pokémon to exist across the map like NPCs without waiting stationary.
- Map & neighbor pre-population: single-pass reservoir sampling over valid encounter tiles (VisiblePopulateMap / VisiblePopulateRegion), plus direct layout scanning up to 24 tiles into connected neighboring maps (VisiblePopulateNeighbour) with species prefetching.
- 25° camera-aware streaming: asymmetric North/South visibility and streaming ranges (VW_VIEW_NORTH = 20, VW_SHOW_NORTH = 24, VW_HIDE_NORTH = 26) with entry/exit hysteresis and a 2-sprite/frame cap.
- Pop-in & animation fix: skips already-visible tiles when crossing map borders (sVisibleShifted) and plays VW_GROW + grass/water rustle exclusively for live spawns/respawns or in-view materializations.
pokeemerald VITA 0.5
Tag: v0.5 · 2026-11-16
Major visual, UI, and packaging update for pokeemerald VITA. Work in progress: expect bugs and unfinished secondary screens.
No VPK is distributed: it would contain Nintendo's game data. You build your own from your own cartridge dump with the Windows script.
What's new in v0.5
HD-2D Visual Mode & 3D World
- HD-2D post-processing mode (OPTIONS > WORLD), inspired by Bravely Emerald:
- Tilt-shift depth of field (
Pass_DepthOfFieldRGBA8 FBO), quarter-res bloom + light emitters, split-tone color grading, and vignette. - Dynamic street lamp and cave lantern point lights (
voxel_pointlights.c), continuous sun/moon light shafts, and night fireflies. - Foliage sway/animation (tall grass, flowers, ash grass), CPU-baked 16×16 Sobel tile relief, soft contact blob shadows, and HD-2D rain streaks/splashes.
- 25° camera & FOV options alongside 30/60 FPS support (30 FPS default in HD-2D).
- Visible wild Pokémon & extended sprite palettes (
gPlttExt): - Wild Pokémon spawn and roam in the overworld (configurable density and encounter rate).
- Follower Pokémon, Poké Balls, and water reflections keep their own extended HGSS palettes without clobbering overworld NPCs.
New GBA UI Skin & UI Fixes
- New default
GBAUI theme across all native touch screens, the battle HUD, PC boxes, and zone signs: - Authentic Gen 3 9-slice framing, specular highlights, inner bevels, tiled backdrop scanlines, and clean antialiased typography (
VT323/Press Start 2P). - Updated Hub, Party, Summary, Bag, Pokédex (with Cry Meter), PokéNav, Trainer Card / Frontier Pass, Options, Save, PC Boxes, and Battle HUD.
- UI fixes & polish:
- Zone entry signs now show only the zone name plate without the town motto drop-down box.
- Full UI navigation, hitbox, text clipping, and header alignment fixes across screens.
Packaging, Performance & Build
- Faster VPK installation (
followers.pak): consolidated the 424 follower.binfiles into a singlePKF1container (app0:followers/followers.pak), reducing the VPK from 439 files to 15 files (−96.6% entries) with in-memorybsearchlookup. - No release-build telemetry stalls (
VITA_TELEMETRY=OFF): disabled synchronous memory-card telemetry/stall logging (perf_frames.csv,perf_summary.txt,ui_stall.log) by default in release builds to eliminate 390–645 ms card-flush freezes on Core 0 (can still be re-enabled via-DVITA_TELEMETRY=ON). - Updated README with visual comparison screenshots (3D Normal vs. 3D HD-2D vs. Classic 2D), new GBA UI menus, and 25° camera examples.
How to build it
- Download Source code (zip) below and extract it to a folder with no spaces or accents in its path and not synced by OneDrive, e.g.
C:\Emerald\pokeemerald-vita-3ds. - Double-click
build_all.batand choose your Pokémon Emerald.gbain the window that opens. If Windows warns that the file comes from the internet, choose More info > Run anyway. - Install
EmeraldVita.vpkwith VitaShell. Saves and settings are stored inux0:data/POKEVITA/.
Full guide and common errors: docs/BUILD_YOUR_OWN.md (español).
pokeemerald VITA 0.1.1
Tag: v0.1.1 · 2026-11-14
Fix release for building your own VPK on a PC that has never built the port. Work in progress: expect bugs and unfinished screens.
No VPK is distributed: it would contain Nintendo's game data. You build your own from your own cartridge dump with the Windows script.
What's fixed
vitaGL.h: No such file or directoryon a new PC. The base VitaSDK does not include vitaGL, and the script only installed SDL2.build_allnow installs every library the game needs (vitaGL with its dependencies, SDL2, SDL2_image) when one is missing.- libpng on Windows without Developer Mode: three libpng files are symbolic links in the package and could not be created; the script now copies them.
- Updating works:
- the interface atlas is rebuilt on every run, so it always matches the game after an update;
- game files a new version needs are downloaded by themselves, without asking for the ROM again;
- the build tools are rebuilt when an update changes them.
- An older MSYS2 is updated in its own step before the build, so an update of MSYS2 itself can no longer cut the build off halfway.
build_all.bat: double-click it to build. The window stays open at the end with the result.- Accented text (Pokémon) shows correctly in the console, and the script warns when the folder is synced by OneDrive.
- The build guides, README and technical documentation are up to date.
If v0.1 failed for you, download this version and run it again in the same folder, or in a new one.
How to build it
- Download Source code (zip) below and extract it to a folder with no spaces or accents in its path and not synced by OneDrive, e.g.
C:\Emerald\pokeemerald-vita-3ds. - Double-click
build_all.batand choose your Pokémon Emerald.gbain the window that opens. If Windows warns that the file comes from the internet, choose More info > Run anyway.
The script installs MSYS2, VitaSDK and its libraries if they are missing, checks your dump, downloads the game files and builds EmeraldVita.vpk. The first run takes 20–40 minutes.
3. Install EmeraldVita.vpk with VitaShell. Saves and settings are stored in ux0:data/POKEVITA/.
Full guide and common errors: docs/BUILD_YOUR_OWN.md (español).
Known bugs and missing screens
Screens still on the GBA interface - The Pokédex entry shown after a catch (description and stats): the GBA text is drawn with no background over the 3D battle. - The summary of a POKéMON in the PC boxes. - Parts of the Battle Pyramid bag. - Easy Chat's Bard song and quiz screens. - Link and recorded battles.
Visual glitches - Trainer and legendary battle transitions are the GBA ones and only partly show over the 3D world. - Intro and title screen margins at 16:9 are broken.
3D world - Terrain generation faults in some maps, inherited from Emerald 3DS. Route 119, Lilycove City and Mirage Island are fixed; the rest are being fixed map by map. - Black spots on the terrain in some places, where the relief mesh has holes. - Occasional frame drops in dense areas.
Stability - The menu can freeze at times. A suspected cause is debug logs written to the memory card. - Vita3K shows a black screen: test on a real PS Vita.
The full feature list is in the README.
Feedback
Please report bugs with the issue template. Include what you did, what happened, and the log files from ux0:data/POKEVITA/. If the build fails, include the last lines the script printed.
pokeemerald VITA 0.1
Tag: v0.1 · 2026-11-14
Download: build_all.ps1 (0.0 MB)
First public test release of the native PS Vita port of Pokémon Emerald, with the features of Emerald 3DS. Work in progress: expect bugs and unfinished screens.
No VPK is distributed: it would contain Nintendo's game data. You build your own from your own cartridge dump with the Windows script.
How to build it
- Download Source code (zip) below and extract it to a folder with no spaces or accents in its path, e.g.
C:\Emerald\pokeemerald-vita-3ds. - In PowerShell, from that folder, run:
powershell powershell.exe -ExecutionPolicy Bypass -File .\build_all.ps1Then choose your Pokémon Emerald.gbain the window that opens. The script installs MSYS2 and VitaSDK if they are missing, checks your dump, downloads the game files and buildsEmeraldVita.vpk. The first run takes 20–40 minutes. - Install
EmeraldVita.vpkwith VitaShell. Saves and settings are stored inux0:data/POKEVITA/.
build_all.ps1 is also attached to this release. It only works from inside the extracted source folder. Full guide: docs/BUILD_YOUR_OWN.md (español).
Features
- 3D voxel overworld, built live from the game's maps:
- sun and shadows, day/night, weather;
- depth of field and water reflections;
- 3D buildings and trees;
- 30 or 60 FPS.
- 3D battles on a stage taken from the map where the battle starts, with a smooth fade from wild encounters.
- A new touch interface at 960×544 over the 3D world, usable with buttons or touch. It replaces the GBA menus with:
- Pokédex, party, bag, PokéNav, Fly map, trainer card, Nuzlocke tracker, options and save;
- PC boxes;
- Poké Mart;
- naming keyboard and Easy Chat;
- berry and contest choices;
- the battle HUD;
- dialogue boxes and zone signs.
- Five menu themes: RED, EMERALD, CRYSTAL, TROPICAL and ROYAL.
- HGSS follower Pokémon, an accelerated clock and time-based encounters.
- Extras:
- physical/special split and infinite TMs;
- running indoors;
- IV/EV pages;
- EXP Share and EXP multiplier;
- Nuzlocke rules;
- field HM shortcuts;
- button remapping.
Known bugs and missing screens
Screens still on the GBA interface - The Pokédex entry shown after a catch (description and stats): the GBA text is drawn with no background over the 3D battle. - The summary of a POKéMON in the PC boxes. - Parts of the Battle Pyramid bag. - Easy Chat's Bard song and quiz screens. - Link and recorded battles.
Visual glitches - Trainer and legendary battle transitions are the GBA ones and only partly show over the 3D world. - Intro and title screen margins at 16:9 are broken.
3D world - Terrain generation faults in some maps, inherited from Emerald 3DS. Route 119, Lilycove City and Mirage Island are fixed; the rest are being fixed map by map. - Black spots on the terrain in some places, where the relief mesh has holes. - Occasional frame drops in dense areas.
Stability - The menu can freeze at times. A suspected cause is debug logs written to the memory card. - Vita3K shows a black screen: test on a real PS Vita.
Waiting for testing on hardware
- Wide buildings no longer vanishing at the screen's west edge (Rustboro City).
- The menu themes on every screen and in the battle HUD.
- PC boxes: moving, withdrawing, depositing, releasing, marks, wallpapers and box names.
- Naming keyboard, Easy Chat in each of its uses, berry and contest choices.
- Day Care and move tutor choices.
- The fade into wild battles.
- Evolutions and other scenes.
Feedback
Please report bugs with the issue template. Include what you did, what happened, and the log files from ux0:data/POKEVITA/.