Jump to content

PK3

From Weissblatt Wiki

PK3 is an archive format first used in Quake III Arena and later adopted by many Doom source ports[1]. For Weissblatt, it poses a more modern, more flexible alternative to WAD.

Structure[edit | edit source]

PK3 files are actually just ZIP files, so theoretically any compression program can be used to create PK3 packages. For a PK3 to properly load into Weissblatt however, some requirements must be met:

Directory structure[edit | edit source]

Weissblatt's directory structure is based on the ZDoom PK3 structure. The table below explains each directory expected by Weissblatt's engine, it's purpose and it's typically expected file format:

Weissblatt PK3 structure
Directory Contains File Format
Characters/ Images S_SKIN (Plain Text)

Picture

Fades/ Screen Fades Fade (Flat)
Flats/ Floor textures Flats
Lua/ Lua scripts .lua (Plain Text)
Maps/ Maps WAD
Models/ 3D Models MD3

PNG (Textures)

Music/ Music files OGG

WAV (General) MIDI MOD XM S3M IT

Patches/ Patch graphics Picture
SOC/ Configuration SOC (Plain Text)
Sounds/ Sounds OGG

WAV

Sprites Sprite graphics Picture
Textures/ Wall textures Picture

There are also additional files which are also expected, but typically stored in the PK3 root directory:

Special lumps
File Type
ANIMDEFS ANIMDEFS
COLORMAP

WATERMAP CLMxxxx

COLORMAP
PLAYPAL

PALxxxx

Color palette
TEXTURES TEXTUREDEF
TRANSxx TINTTAB