Nyamoru at 19:46, 19 March 2026

2026-03-19T19:46:31Z

@@ Line 1: / Line 1: @@
 ''PK3'' is an archive format first used in [[wikipedia:Quake_III_Arena|Quake III Arena]] and later adopted by many Doom source ports[https://doomwiki.org/wiki/PK3]. For Weissblatt, it poses a more modern, more flexible alternative to [https://doomwiki.org/wiki/WAD WAD].
-== Structure ==
+== Building PK3s ==
-PK3 files are actually just [[wikipedia:ZIP_(file_format)|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:
+PK3 files are actually just [[wikipedia:ZIP_(file_format)|ZIP files]], so theoretically any compression program can be used to create PK3 packages. There are however some specialty tools to make building Weissblatt (addon) PK3s easier:
 === Directory structure ===
 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:

Nyamoru: Created page with "''PK3'' is an archive format first used in Quake III Arena and later adopted by many Doom source ports[https://doomwiki.org/wiki/PK3]. For Weissblatt, it poses a more modern, more flexible alternative to [https://doomwiki.org/wiki/WAD WAD]. == Structure == 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 Weissbl..."

2025-04-06T17:42:00Z

Created page with "''PK3'' is an archive format first used in Quake III Arena and later adopted by many Doom source ports[https://doomwiki.org/wiki/PK3]. For Weissblatt, it poses a more modern, more flexible alternative to [https://doomwiki.org/wiki/WAD WAD]. == Structure == 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 Weissbl..."

New page

''PK3'' is an archive format first used in [[wikipedia:Quake_III_Arena|Quake III Arena]] and later adopted by many Doom source ports[https://doomwiki.org/wiki/PK3]. For Weissblatt, it poses a more modern, more flexible alternative to [https://doomwiki.org/wiki/WAD WAD].

== Structure ==
PK3 files are actually just [[wikipedia:ZIP_(file_format)|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 ===
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:
{| class="wikitable"
|+Weissblatt PK3 structure
!Directory
!Contains
!File Format
|-
|<code>Characters/</code>
|Images
|S_SKIN (Plain Text)
[[Doom Picture|Picture]]
|-
|<code>Fades/</code>
|[[Screen Fade|Screen Fades]]
|Fade ([[Flat#Fade|Flat]])
|-
|<code>Flats/</code>
|Floor textures
|[[Flat|Flats]]
|-
|<code>Lua/</code>
|Lua scripts
|<code>.lua</code> (Plain Text)
|-
|<code>Maps/</code>
|Maps
|WAD
|-
|<code>Models/</code>
|[[3D Model|3D Models]]
|[[3D Model#MD3|MD3]]
PNG (Textures)
|-
|<code>Music/</code>
|Music files
|OGG
WAV
(General) MIDI
MOD
XM
S3M
IT
|-
|<code>Patches/</code>
|Patch graphics
|[[Doom Picture|Picture]]
|-
|<code>SOC/</code>
|Configuration
|SOC (Plain Text)
|-
|<code>Sounds/</code>
|Sounds
|OGG
WAV
|-
|<code>Sprites</code>
|Sprite graphics
|[[Doom Picture|Picture]]
|-
|<code>Textures/</code>
|Wall textures
|[[Doom Picture|Picture]]
|}
There are also additional files which are also expected, but typically stored in the PK3 root directory:
{| class="wikitable"
|+Special lumps
!File
!Type
|-
|<code>ANIMDEFS</code>
|[[ANIMDEFS]]
|-
|<code>COLORMAP</code>
<code>WATERMAP</code>
<code>CLMxxxx</code>
|[[Color Palette#COLORMAP|COLORMAP]]
|-
|<code>PLAYPAL</code>
<code>PALxxxx</code>
|[[Color Palette|Color palette]]
|-
|<code>TEXTURES</code>
|[[TEXTUREDEF]]
|-
|<code>TRANSxx</code>
|[[Color Palette#TINTTAB|TINTTAB]]
|}
[[Category:Guide]]
[[Category:Technology]]

PK3 - Revision history

Nyamoru at 19:46, 19 March 2026