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

Format:Build ART (tile file)

From ReverseEngineering.wiki
Format
Magic none (int32 version 1 at offset 0)
Extensions .art
Endianness little
On this wiki Facts · Code · Notes · Topics

Tile files of the Build engine (TILES000.ART, TILES001.ART, ...): a 16-byte header with version 1 and a tile range, per-tile width, height and animation words, then raw 8-bit column-major pixels.

Layout

All integers are little-endian. Per Ken Silverman's BUILDINF.TXT the file name is xxxxx###.ART and a loader keeps incrementing the number until a file is missing.

Offset Size Field
0 4 artversion, must be 1
4 4 numtiles (Ken: unused, do not trust)
8 4 localtilestart: first tile number in this file
12 4 localtileend: last tile number in this file (may exceed the last used slot)
16 2 x n tile widths (n = localtileend - localtilestart + 1)
- 2 x n tile heights
- 4 x n picanm words (animation and offsets, see the fact)
- width x height per tile pixel data of each tile, in tile order

Pixel data is one byte per pixel (index into Format:Build PALETTE.DAT), stored column by column: the byte at offset x * height + y is column x, row y (Ken's 4 x 4 example numbers the offsets down each column). Tile i's data starts after the headers plus the sizes of the earlier tiles in the same file; zero-sized tiles take no space.

Variants

EDuke32/NBlood accept a file that starts with the two dwords BUIL DART (the text "BUILDART") before the version dword; the plain format starts with the version.

The tile range checks differ: NBlood rejects a range with tilestart or tileend at or above MAXUSERTILES (30720 - 256), or tileend below tilestart. jfbuild has MAXTILES 9216 and does not check the range in the loader.

Unverified

Unverified: the order in which the engine overrides tiles that appear in more than one ART file or in a per-map ART (mapname_XX.art in EDuke32) was not read in detail.

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