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

ASSETS.md

4004 bytes ยท Original / download

Assets

Three kinds of data end up in the VPK.

1. Game data from the decompilation

graphics/, sound/, data/ and src/data/ hold the game's graphics, audio, maps and tables as extracted by pret. They are converted at build time; no ROM is read.

Source Tool Output
graphics/**/*.png, *.pal (downloaded by fetch_assets, listed in tools/assets/manifest.txt) gbagfx .4bpp, .8bpp, .gbapal, .lz next to the source
sound/**/*.aif, sound/songs/midi/*.mid aif2pcm, mid2agb .bin samples, .s songs
data/maps/**/*.json, src/data/**/*.json mapjson, jsonproc .inc / .h included by the code

Run by make -f vita/assets.mk, which reuses the decomp's *_rules.mk files. The outputs are git-ignored.

2. Port data (assets/)

File Packed as Read by Format Generator
assets/voxel/buildings.bin app0:voxel/ voxel_building.c Building models and texture pages Emerald 3DS scripts/gen_voxel_buildings.py
assets/voxel/relief.bin app0:voxel/ voxel_relief.c Cliffs, stairs, sea rocks per layout Emerald 3DS scripts/gen_voxel_relief.py + relief_fixes.json
assets/voxel/regions.bin app0:voxel/ voxel_regions.c Cell roles, 4 bits per cell Emerald 3DS scripts/gen_voxel_regions.py
assets/voxel/signposts.bin app0:voxel/ voxel_sign.c Signpost / lamp pixel masks Emerald 3DS scripts/gen_voxel_sign_masks.py
assets/voxel/trees.rgba5551 app0:voxel/ voxel_renderer.c Tree atlas Emerald 3DS scripts/gen_voxel_trees.py
assets/ui2/ui_atlas.bin app0:ui2/ ui_assets.c Fixed part of the new UI's texture: baked theme fonts, white block, UI sprites tools/ui2/build_atlas.py (also writes src/platform/ui/ui_sprite_ids.h)
assets/ui/intro_margins.bin (EM3DLVS1) app0:ui/ vita_stage.c Leaves margins of the intro tools/ui_gen/gen_intro_margins.py (reads graphics/intro/scene_1; run by build_vita.sh, not committed)
assets/followers/ app0:followers/ src/follower_mon.c HGSS follower sprites (FMN1) and messages Sources in assets/followers/sources.txt

The voxel data files are made by Emerald 3DS's Python generators (CC BY-NC-SA 4.0). They read the decompilation, not a ROM. The generators and the terrain editor used to fix faulty maps are kept outside this repository (several GB); the files in assets/voxel/ are committed as built. Terrain faults are corrected as data (relief_fixes.json, read by gen_voxel_relief.py), never by hand-editing relief.bin.

3. Generated C headers

File Content Generator
src/platform/ui/ui_sprite_ids.h Fixed UI atlas sprite enum matching assets/ui2/ui_atlas.bin tools/ui2/build_atlas.py
src/platform/ui/ui_town_signs.h Town and city sign mottos extracted from data/maps/*/scripts.inc tools/ui2/gen_town_signs.py

Regenerating the UI art

python tools/ui2/bake_theme_fonts.py                               # theme_fonts.png + .json (needs local server)
python tools/ui2/build_atlas.py                                    # assets/ui2/ui_atlas.bin + ui_sprite_ids.h
python tools/ui2/gen_town_signs.py                                 # src/platform/ui/ui_town_signs.h
python tools/ui_gen/gen_intro_margins.py --output assets/ui/intro_margins.bin

build_atlas.py reads the base pixel fonts baked by design/stitch/_tools/font_bake.html (tools/ui2/fonts/ui_fonts.*), the theme fonts baked by tools/ui2/bake_theme_fonts.py (tools/ui2/fonts/theme_fonts.* for RED, CRYSTAL, TROPICAL and ROYAL), and the images design/stitch/_tools/export_assets.py exports to design/stitch/_assets/. build_all runs both export_assets.py and build_atlas.py on every build, because ui_sprite_ids.h is committed and the atlas must always match it. gen_intro_margins.py reads graphics/intro/scene_1; run the asset step first.