Skip to content

decomp-assets 0.8.0: images in a party-game series' main filesystem - #7

Merged
RetroGameDeveloper merged 1 commit into
mainfrom
feat/mainfs-images
Nov 14, 2026
Merged

RetroGameDeveloper merged 1 commit into
mainfrom
feat/mainfs-images

Conversation

@RetroGameDeveloper

Copy link
Copy Markdown
Contributor

What

New n64/mainfs.py: the main filesystem of an N64 party-game series.

  • Structure: directory table, file tables, and per file its unpacked size plus packing type.
  • Packings: 0 stored, 1 LZSS (1 KB window from 0x3BE), 2–4 Yaz0-like with 32-bit flag words, 5 run lengths.
  • Images come from two kinds of file: image packs (palette or intensity, 4/8/16/32-bit) and FORM models' BMP1 bitmaps with PAL1 palettes.
  • Formats follow the public-domain PartyPlanner64 project's documentation; the code is written here.

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

  • The three games: 4,456 / 5,456 / 4,675 images. Contact sheets checked by eye: characters, items, signs, HUD art.
  • No filesystem matched in the other 48 N64 ROMs.

Tests

tests/test_mainfs.py (homemade filesystem: all three packings, an empty directory, an image pack with a short palette, a FORM model, rejections). 164 pass, ruff clean.

🤖 Generated with Claude Code

Three N64 party games keep their assets in one filesystem of directories and
packed files (stored, LZSS, a Yaz0-like coding, run lengths; formats as the
public-domain PartyPlanner64 project documents them). Image packs and the
bitmaps of FORM models are now found and previewed: 4,456, 5,456 and 4,675
images in the three games. Only a file's first bytes are unpacked to tell its kind.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@RetroGameDeveloper
RetroGameDeveloper merged commit c18adba 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