Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Library:Build engine

From ReverseEngineering.wiki
Library
Developer Ken Silverman
License Build source license (BUILDLIC.TXT: free non-commercial redistribution of derivatives over the Internet, commercial use needs a license from Ken Silverman); EDuke32 and NBlood are GPL-2.0-or-later with that license applying to the Build part
On this wiki Facts · Code · Notes · Topics

Ken Silverman's Build engine (1993-1997), the 2.5D sector-and-wall engine of Duke Nukem 3D, Shadow Warrior, Blood and others; its data lives in GRP archives, ART tile files, PALETTE.DAT/LOOKUP.DAT and MAP boards.

Overview

The Build engine renders a world made of sectors (convex or concave regions with a ceiling and a floor) bounded by walls, plus sprites; the same data structures are used by the game code and stored almost unchanged in the MAP file. Games that use it include Duke Nukem 3D, Shadow Warrior and Blood (the task brief and the existing GRP page also name Ion Fury via EDuke32; Unverified: the full list of other Build games). Data formats are documented by Ken Silverman in BUILDINF.TXT, shipped in the Build source release and mirrored in jonof/jfbuild (doc/buildinf.txt).

Data files

File Contents Page
.GRP flat archive of the game's files Format:GRP (Build engine group file)
TILES###.ART 8-bit paletted tiles, numbered sequentially Format:Build ART (tile file)
PALETTE.DAT, LOOKUP.DAT base palette, shade tables, translucency table, extra palettes Format:Build PALETTE.DAT
.MAP board: sectors, walls, sprites Format:Build MAP (board file)
.RFF Blood's resource archive Format:RFF (Blood resource file)

Source ports

  • jonof/jfbuild: Jonathon Fowler's portable port of the original Build source, close to Ken's code; its src/engine.c has the original loaders.
  • EDuke32 (source/build/src) and NBlood, which carries the same Build engine fork: C++ code with extra limits (MAXTILES 30720), map version 9 and a different tile-header reader.

The engine versions differ in MAXTILES (9216 in the jfbuild head read here, 30720 in the NBlood head read here), so a tile number above 9215 only exists in newer ports.

Unverified leads

Unverified: Shadow Warrior, Blood and Duke Nukem 3D differ in game-side conventions (lotag/hitag meanings, sprite picnums, Blood's extra map data); this page only covers the engine-level file formats read from the two repositories above.

Code & repositories

  • 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
  • https://github.com/NBlood/NBlood @ 497385d64b97f4fd13b6efb3929df0f2ab3adc87 · license: none
    NBlood: Blood port that carries the EDuke32 Build engine fork (source/build/src engine.cpp, tiles.cpp, palette.cpp) and Blood's RFF Resource class (source/blood/src/resource.cpp). Used for map version 9, the BUILDART prefix, PALETTE.DAT variants and the RFF format.
    Tested on: source read, not run: source read at the cited commit, not run · checked 2026-10-19; last activity 2026-10-02; Note: the latest release ships binaries; the wiki links only the source, never the binaries; no license: not reusable