
PCK Reverse Engineering
Reverse engineering of .pck files from the In The Groove PC Demo
11/9/2026
2 min read
.pck files are packages that StepMania mounts as VFS (Virtual File System) instead of unpacking their content to disk.
I did this to make modding easier and to explore the content of these files.
The directory is the pack’s file index. The engine reads it when it mounts the pack and builds a table from each path to a position in the file. The paths are virtual paths, not locations on disk. Entries like “Cache/Banners/…” and “Cache/Songs/…” look like paths relative to the game’s root. Once the pack is mounted, they would appear as if those folders and files existed there. Each record gives the offset, stored size and compression flag, so the engine can open one file without touching the rest. A read seeks to the offset and, for a flagged entry, decompresses on the fly with zlib.
this is the structure of a sample .pck file.
0x0000 50 43 4b 46 "PCKF" magic
0x0004 "default base song" + zeros pack name, fills up to 0x80
0x0080 00 00 00 00 reserved (0)
0x0084 a8 00 00 00 file count = 168
0x0088 ── directory starts ──
record 0 (20 bytes of numbers + name)
record 1
...
record 167
0x2D36 ── file data starts (offset 11574) ──
file 0's bytes, file 1's bytes, ...
here is one record of a directory:
20 80 00 00 stored size = 32,800
20 80 00 00 real size = 32,800 (same, so not compressed)
36 2d 00 00 data offset = 11,574
3f 00 00 00 name length = 63
00 00 00 00 compressed? = 0
"Cache/Banners/_Songs_In The Groove_Euphoria_Euphoria-banner.png" (63 characters)