Skip to content

decomp-assets 0.9.0: texture banks packed with FLA2 - #8

Merged
RetroGameDeveloper merged 1 commit into
mainfrom
feat/fla2-texbanks
Nov 14, 2026
Merged

RetroGameDeveloper merged 1 commit into
mainfrom
feat/fla2-texbanks

Conversation

@RetroGameDeveloper

Copy link
Copy Markdown
Contributor

What

New n64/fla2.py:

  • FLA2 unpacking: an LZ variant with a 4 KB window and flag bits read high first; the end marker is checked against the stated size.
  • Texture banks: a count, then a 36-byte header plus data per texture. Supported: CI4/CI8 with an RGBA16 palette at the header's palette offset, RGBA16, IA16 and RGBA32.

The format follows the MIT-licensed libgarib project's documentation; the code is written here.

Results (read-only, the user's own ROMs)

  • Both decomp projects of the game: 1,682 textures in 20 banks. libgarib's ROM map lists 20 texture banks, so all are found.
  • Contact sheet checked by eye.
  • No FLA2 texture bank in the other 49 N64 ROMs.

Tests

tests/test_fla2.py (homemade encoder: literals, runs, end marker, truncation, a bank with CI4/RGBA16/IA16, rejections). 167 pass, ruff clean.

🤖 Generated with Claude Code

A platformer about a magic glove packs its texture banks with FLA2, an LZ
variant (formats as the MIT-licensed libgarib project documents them). The
banks are unpacked and their textures (CI4/CI8 with palettes, RGBA16, IA16,
RGBA32) shown: 1,682 in 20 banks, every texture bank the game has.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@RetroGameDeveloper
RetroGameDeveloper merged commit f6d1d8a into main Nov 14, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant