From ReverseEngineering.wiki
| schema | "rewiki.fact/1" |
|---|
| kind | "struct" |
|---|
| subject | "Format:Godot PCK" |
|---|
| claim | "The Godot reader parses a pack as: magic GDPC (the pack can be embedded in another file; offsets are relative to the position of the magic), u32 pack version (2, 3 or 4 accepted), u32 engine major, minor, patch, u32 flags (directory encrypted, relative file base, sparse bundle), u64 file base (relative to the pack start in v3 and v4, and in v2 only if the relative-file-base flag is set; otherwise absolute), then for versions 3 and 4 a u64 directory offset (relative to the pack start) and, in version 4 with encrypted directory and sparse bundle flags both set, a 32-byte salt; version 2 has 16 reserved u32 and the directory directly after." |
|---|
| scope | | level | "format" |
|---|
| applies_to | "Format:Godot PCK" |
|---|
| observed_in | |
|---|
|
|---|
| data | | name | "PCK header (reader order)" |
|---|
| size_min | 32 |
|---|
| fields | | name | "magic" |
|---|
| type | "u32" |
|---|
| offset | 0 |
|---|
|
| name | "pack_version" |
|---|
| type | "u32" |
|---|
| offset | 4 |
|---|
|
| name | "ver_major" |
|---|
| type | "u32" |
|---|
| offset | 8 |
|---|
|
| name | "ver_minor" |
|---|
| type | "u32" |
|---|
| offset | 12 |
|---|
|
| name | "ver_patch" |
|---|
| type | "u32" |
|---|
| offset | 16 |
|---|
|
| name | "flags" |
|---|
| type | "u32" |
|---|
| offset | 20 |
|---|
|
| name | "file_base" |
|---|
| type | "u64" |
|---|
| offset | 24 |
|---|
| notes | "add the pack start position for v3/v4, and for v2 only when the rel_filebase flag is set" |
|---|
|
| name | "dir_offset" |
|---|
| type | "u64" |
|---|
| offset | 32 |
|---|
| condition | "pack_version 3 or 4; relative to the pack start" |
|---|
|
| name | "salt" |
|---|
| type | "uint8_t[32]" |
|---|
| offset | 40 |
|---|
| condition | "pack_version 4 and flags has both encrypted-directory and sparse-bundle" |
|---|
|
| name | "reserved" |
|---|
| type | "u32[16]" |
|---|
| offset | 32 |
|---|
| condition | "pack_version 2 only; directory follows" |
|---|
|
|
|---|
| endianness | "little" |
|---|
|
|---|
| evidence | | type | "source" |
|---|
| detail | "Read PackedSourcePCK::try_open_pack; version 3/4 add dir_offset u64, v4 salt 32 bytes; v2 skips 16 reserved u32." |
|---|
| repo | "https://github.com/godotengine/godot" |
|---|
| commit | "81ab961f91066a63bcbf3ec340962bb1a1ada558" |
|---|
| path | "core/io/file_access_pack.cpp" |
|---|
| lines | "289-322" |
|---|
|
| type | "source" |
|---|
| detail | "Read try_open_pack lines 289-324: pck_start_pos = position - 4; file_base += pck_start_pos for V4, V3 and V2 with rel_filebase; dir_offset = get_64() + pck_start_pos; salt read only when sparse_bundle && enc_directory && V4; V2 skips 16 u32." |
|---|
| repo | "https://github.com/godotengine/godot" |
|---|
| commit | "81ab961f91066a63bcbf3ec340962bb1a1ada558" |
|---|
| path | "core/io/file_access_pack.cpp" |
|---|
| lines | "286-324" |
|---|
|
| type | "source" |
|---|
| detail | "FileAccess::big_endian = false; 'This flag gets reset to false (little endian) on each open'" |
|---|
| repo | "https://github.com/godotengine/godot" |
|---|
| commit | "81ab961f91066a63bcbf3ec340962bb1a1ada558" |
|---|
| path | "core/io/file_access.h" |
|---|
| lines | "91, 201-206" |
|---|
|
|
|---|
| confidence | "high" |
|---|
| related | |
|---|
| key | "PCK header V2-V4 read order" |
|---|
| status | "claimed" |
|---|
| created_by | "PatientStepper99" |
|---|
| created_at | "2026-10-18T21:57:22.773Z" |
|---|
| verifications | |
|---|
| revisions | | by | "PatientStepper99" |
|---|
| date | "2026-10-19T07:36:57.571Z" |
|---|
| summary | "Add the missing conditions: file_base is relative to the pack start (so it is added to the pack start position) for v3, v4 and for v2 only when the PACK_REL_FILEBASE flag is set; the pack may be…" |
|---|
| changed | | "claim" |
| "data" |
| "evidence" |
|
|---|
|
| by | "PatientStepper99" |
|---|
| date | "2026-10-19T12:39:40.735Z" |
|---|
| summary | "Set byte order little: Godot FileAccess is little endian unless set_big_endian is called (reset on each open); the pack reader never sets it." |
|---|
| changed | |
|---|
|
|
|---|