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

BUILD.md

5513 bytes · Original / download

Building

build_all.ps1 (Windows) or ./build_all.sh (in MSYS2) installs everything below and runs every step; users should follow BUILD_YOUR_OWN.md. This page is the detail behind it, for development.

The repository's path must not contain spaces or accents: make and the decomp's rules cannot handle them (build_all.ps1 refuses such a folder).

Requirements (Windows)

  1. MSYS2 in C:\msys64. In the MSYS shell: sh pacman -Syu pacman -S --needed make git cmake tar bzip2 xz wget curl python patch pkgconf diffutils \ mingw-w64-x86_64-gcc mingw-w64-x86_64-libpng mingw-w64-x86_64-pkgconf \ mingw-w64-x86_64-python mingw-w64-x86_64-python-pillow The generators run with MINGW64's Python and Pillow; no Windows Python is needed.
  2. VitaSDK 2026.08 with the vitaGL and SDL2 packages (MSYS shell; keep the two export lines in ~/.bash_profile): sh export VITASDK=/usr/local/vitasdk PATH=/usr/local/vitasdk/bin:$PATH VITASDK_CHANNEL=2026.08 export TAR_OPTIONS=--force-local mkdir -p /c/vdpm-tmp && export TMPDIR=$(cygpath -m /c/vdpm-tmp) git clone --depth 1 https://github.com/vitasdk/vdpm /tmp/vdpm && (cd /tmp/vdpm && ./bootstrap-vitasdk.sh) VDPM_NONINTERACTIVE=1 vdpm install vitaGL sdl2 The base VitaSDK has none of the libraries the game links: vitaGL brings vitaShaRK, libmathneon, SceShaccCgExt and taihen with it. Without them the build stops at vitaGL.h: No such file or directory. Check with arm-vita-eabi-gcc --version and vdpm list.

MSYS2 pitfalls: the Windows-form TMPDIR avoids vdpm-channel: cannot open file, and TAR_OPTIONS=--force-local stops tar reading C:/… as a host.

Steps

From the repository root:

  1. Game files (once): this repository does not carry the game's graphics, sounds or binary data. ./fetch_assets.sh <your Emerald dump> in the MINGW64 shell (or fetch_assets.ps1 -Rom <dump> from PowerShell) checks the dump, downloads them and generates the files made from them. Generators run there must read only downloaded sources (PNG, .bin, .pal): the conversion in step 2 has not run yet on a new copy.
  2. Host tools (once), MINGW64 shell: sh make -f make_tools.mk -j8 CC="gcc -static" CXX="g++ -static"
  3. Game assets (once, and after editing graphics, maps, sound or JSON): sh make -f vita/assets.mk -j8
  4. VPK, from PowerShell: powershell powershell.exe -ExecutionPolicy Bypass -File .\build_vita.ps1 or from the MSYS shell: ./build_vita.sh.

Output: build-vita/pokeemerald.vpk, plus eboot.bin and the ELF build-vita/pokeemerald (keep it: crash dumps are decoded against it). build_vita.sh drops a CMake cache created in another checkout path; for a clean rebuild delete build-vita/.

CMake options

Option Default Effect
VITA_PARALLEL_DRAW ON Draw GBA frames on the worker threads. Also enables the 288-px widescreen lines
VITA_LOGGING OFF VITA_LOG writes ux0:data/POKEVITA/debug.log
VITA_DRAW_SELFCHECK OFF Testing: compare parallel and sequential drawing periodically

What CMakeLists.txt does

  1. Collects every src/**/*.c and gflib/*.c (glob).
  2. Preprocesses each game file with arm-vita-eabi-gcc -E, then tools/preproc (charmap strings, INCBIN), into build-vita/generated/. Some files get extra forced includes here (src/intro.c gets src/platform/vita/compat/ctr_gba_stage.h).
  3. Compiles with -O2 -mcpu=cortex-a9 -mfpu=neon -mfloat-abi=hard -fno-strict-aliasing -fwrapv. The decomp relies on type punning and signed overflow, hence the last two flags.
  4. Assembles data/*.s and the songs into one game_data.o (.rodata renamed to .data because it holds pointers).
  5. Links the game side into game_combined.o with its .data/.bss renamed, so all game state sits between known symbols and vita_reset.c can restore a power-on copy for resets.
  6. Links through vita/vita_link.sh (pads the code segment for vita-elf-create).
  7. vita_create_self(... UNSAFE) (the app writes ux0:data/), then vita-mksfoex and vita-pack-vpk called directly (vita_create_vpk breaks on paths with spaces).
  8. Packs vita/sce_sys/ (LiveArea), assets/voxel/ → voxel/, assets/ui/ → ui/, assets/ui2/ → ui2/, assets/followers/ → followers/.

Title ID PKEM00001. LiveArea PNGs must be 8-bit indexed; vita/make_livearea.sh converts full-colour art (needs mingw-w64-x86_64-imagemagick).

Installing and testing

Warnings

The build prints no warnings; keep it that way. The flags are split in CMakeLists.txt: the decompiled game keeps the leniency it was written for (-Wno-implicit-function-declaration and friends), while src/platform/ builds with -Wall -Wextra (only unused parameters, sign comparisons and missing field initialisers are left out). The preprocessing step passes -Wno-trigraphs, since ?? in game text is never meant as one.