Format:GRP (Build engine group file)
| Magic | KenSilverman |
|---|---|
| Extensions | .grp |
| Endianness | little |
| On this wiki | Facts · Code · Notes · Topics |
Flat archive of Ken Silverman's Build engine games (Duke Nukem 3D's DUKE3D.GRP, Shadow Warrior, Blood-era tools, Ion Fury): the 12-byte magic "KenSilverman", a file count, a table of 16-byte name+size entries and the raw files stored back to back.
Layout
All integers are little-endian.
| Offset | Size | Field |
|---|---|---|
| 0 | 12 | magic, ASCII "KenSilverman" (no terminator) |
| 12 | 4 | number of files N |
| 16 | 16 x N | directory: 12-byte file name (NUL-padded, 8.3 style, no path), 4-byte size |
| 16 + 16 x N | - | file data, in directory order, no padding or alignment |
There are no stored offsets: the offset of file i is 16 + 16 x N plus the sizes of files 0..i-1. Names are limited to 12 characters, so contents are flat (no directories). Typical contents are map files (.MAP), art tiles (TILES000.ART), sounds (.VOC), music (.MID), the palette (PALETTE.DAT), LOOKUP.DAT and the definitions the game loads.
Identification
The first 12 bytes spell KenSilverman. Source ports identify a particular game or version by the CRC-32 of the whole .grp file (Chocolate Duke3D computes a CRC-32 with the standard 0xEDB88320 polynomial over the entire file while loading it and keeps it for the game layer).
The jfbuild reader (Library:Build engine) checks only the 12 magic bytes and then trusts the count; there is no version field and no checksum. When several groups are loaded or names repeat, the last one wins (see the fact on the lookup order), so a mod GRP can shadow files of the base GRP. Reference: jonof/jfbuild src/cache1d.c initgroupfile.
Notes
Unverified: later ports and mods extend the concept (for example .zip or .pk3 replacements loaded before the GRP); this page only covers the original format described by Ken Silverman.
Code & repositories
See linked repositories.
- https://github.com/fabiensanglard/chocolate_duke3D @
1cfa1909aa1f5a5ab159301044ca499673bc2283· license: none
Chocolate Duke3D: Build engine source whose filesystem.c opens GRP archives and quotes Ken Silverman's format description
Tested on: source read, not run: read source only · checked 2026-10-18; archived; last activity 2019-03-30; no license: not reusable - https://github.com/jonof/jfbuild @
e06cbd005a8e6d5f38b5a7aa27ea597dd233c16e· license: LicenseRef-Build-Source-License (declared by the contributor; GitHub's detector did not recognize COPYING)
Jonathon Fowler's port of Ken Silverman's Build engine source: src/engine.c (loadboard, loadpics, loadpalette), src/cache1d.c (GRP) and doc/buildinf.txt (Ken's ART, MAP and PALETTE.DAT notes). The Build source license (buildlic.txt) allows free non-commercial redistribution of derivatives over the Internet; cite facts only.
Tested on: source read, not run: source and BUILDINF.TXT read at the cited commit, not run · checked 2026-10-19; last activity 2026-06-28