Jazz Jackrabbit Tile Format

From ModdingWiki
Jump to: navigation, search
Jazz Jackrabbit Tile Format
File:Jazz Jackrabbit Tile Format.png
There is no image of a tileset in this format — upload one!
Format typeTileset
Max tile count240
Tile names?No
Minimum tile size (pixels)?
Maximum tile size (pixels)?
Plane count1
Plane arrangementLinear
Transparent pixels?Unknown
Hitmap pixels?No
Supports sub-tilesets?No
Compressed tiles?Yes
Hidden data?No

Jazz Jackrabbit has two sort of tiles:

  • Tiles for regular levels are stored in BLOCKS.xxx files. This file is used in all levels with filename LEVELy.xxx where xxx is the same.
  • Tiles for bonus levels are stored in BONUSy.000 files. The bonus levels contain a string that determines what tile file to use.

Regular tiles

The file starts with an RLE-compressed palette, which is used for all the tiles. This is followed by two other RLE palettes used for the sky (Each block of sky is 256 pixels high and stretched across the level. There are two alternating sky blocks stacked in the level.) For a total 0f 768 possible colors for each level.

Tile data consists of 4, 60 tile blocks (No more than 240 tiles total.) If a block has data in it it start with 'ok' and it will be RLE compressed using Jazz Jackrabbit RLE compression, if it is empty, it will consist simply of the byte $20. (These can be seen at the end of the default files.)

Bonus tiles

The file consists of three blocks, all RLE compressed. The first is the sky used in the bonus level, the second is the palette used for the graphics and the third is tile data.

The tile block is identical to that found in regular tiles, but without the 'ok' text. There are only 60 tiles in a bonus tileset.


The format for regular tiles was deciphered from the source of OpenJazz. The format for bonus tiles was deciphered by Zander Zoftware. Some corrections were made by Levellass. If you find this information helpful in a project you're working on, please give credit where credit is due. (A link back to this wiki would be nice too!)