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

VITA_UI.md

4442 bytes · Original / download

User interface

The port's menus, dialogue boxes, battle HUD and the scenes it replaces are the new UI (src/platform/ui/), drawn natively over the 3D world, with five menu themes. It is the only menu system: the old 3DS-style Vita menu (vita_ui*.c) was removed on 2026-11-13. Where the new UI has no screen, or cannot open one, the game's own GBA screen is used:

Button mapping, fast forward, always-run and the save path are in src/platform/vita/vita_controls.c.

New UI (src/platform/ui/)

Core 1 (the game thread) runs Ui_Tick between game frames and builds a draw list; Core 0 draws it in one call over one 1024×2048 RGBA5551 texture (fixed atlas assets/ui2/ui_atlas.bin in rows 0–1023 + 256 64×64 cells in rows 1024–2047 for sprites decoded at run time). See THREADS.md and RENDERING.md.

Files Role
ui_core.c, ui_draw.c, ui_render.c, ui_assets.c, ui_sprites.c Screen stack, input, draw list, texture, atlas, sprite cache
ui_theme.c Five menu themes (RED, EMERALD, CRYSTAL, TROPICAL, ROYAL): colour tokens, box geometry, battle HUD tokens and baked font face IDs
ui_widgets.c, ui_kit.c Boxes, rows, buttons, lists, popups, toasts
ui_scr_*.c Screens: START hub, Pokédex, party, bag, PokéNav, trainer card, options, Nuzlocke, mart, PC boxes, player's PC (items, mailbox, decorations), naming keyboard, Easy Chat, berry choice, forget a move, choose a Pokémon
ui_contest.c Contest appeal choice
ui_mirror.c, ui_sign.c Dialogue, YES/NO, multichoice and money boxes (including 2D evolution, egg-hatch and trade dialogue mirrors), plus zone signs
ui_battle_hud.c, ui_game_battle.c Battle HUD (plates, party balls, messages, commands, moves, targets, level up) and the battle bag / party
ui_game*.c Game data and actions used by the screens
ui_stall.c Diagnostic: writes ui_stall.log when the UI stops updating for more than 100 ms

Opening modes (ui_core.c)

Themes (ui_theme.c)

Selected in OPTIONS > GENERAL > DISPLAY > MENU COLOR (extra "ui_theme"):

Theme Characteristics Fonts
RED (default) Chamfered dark-slate corners, diagonal frame stripes, red highlight bar Saira Condensed
EMERALD Warm paper panels, double bevel, dark teal frame Press Start 2P + VT323
CRYSTAL Cool ice panels, glossy pill highlights M PLUS Rounded 1c
TROPICAL Warm sand panels, coral/amber pills, heavy dark outlines Fredoka
ROYAL Deep emerald-and-gold forest aesthetic, chamfered selection bar Exo 2

Design mocks: design/stitch/ (?theme= previews each theme). The atlas is built by tools/ui2/build_atlas.py.

Game features behind the UI

File Role
vita_extras.c/h QoL switches stored in settings.txt; VitaExtras_GetFast(FAST_EXTRA_*) is an O(1) cache read by game code
vita_daynight.c/h Accelerated clock (1×–1000×) and day/night light
vita_encounters.c/h Time-of-day wild encounter tables for 20 routes
vita_nuzlocke.c Nuzlocke rules and tracking
src/follower_mon.c HGSS follower Pokémon (assets/followers/)