Godot Unpacker
Godot 引擎 .pck / .exe 解封包脚本，支持 Godot 3（PCK v1）和 Godot 4（PCK v2）。
功能
-
PCK 解包 — 从
.pck或.exe文件的 PCK 数据中提取全部数据 -
格式转换 — 自动将 Godot 专有格式转换为通用格式：
-
.ctex（GST2）/.stex（GDST）→.png/.webp -
.oggvorbisstr（RSRC）→.ogg -
.sample（RSRC AudioStreamWAV）→.wav（支持 IMA-ADPCM 解码）
-
-
批量提取 — 仅提取图片或音频资源
-
项目结构还原 — 通过
.import映射文件重建原始目录结构
支持的格式
实验性支持 PCK v3（Godot 4.5+）
| Godot 格式 | 魔数 | 说明 | 输出格式 |
|---|---|---|---|
| PCK v1 | GDPC |
Godot 3 资源包 | 提取的文件 |
| PCK v2 | GDPC |
Godot 4 资源包 | 提取的文件 |
| CTEX | GST2 |
Godot 4 CompressedTexture2D | .png / .webp |
| STEX | GDST |
Godot 3 StreamTexture | .png / .webp |
| RSRC (OGG) | RSRC |
AudioStreamOggVorbis / OggPacketSequence | .ogg |
| RSRC (WAV) | RSRC |
AudioStreamWAV / AudioStreamSample | .wav |
| 内嵌 PCK | — | 附加在 .exe 末尾的 PCK 数据 |
自动检测 |
快速开始
bash
git clone https://github.com/Aionfatedio/Godot-unpacker.git
cd Godot-unpacker
# 传入游戏文件夹
python godot_unpacker.py "C:\Games\GodotGame\"
# 传入游戏pck文件
python godot_unpacker.py full game.pck -o output/
环境
Python 3.8+
用法
bash
python godot_unpacker.py "path/to/godot/game/"
输出结构：
text
*_unpacked/
_raw/ # Godot 原始格式文件
_resource/ # 还原后的项目资源（已转换为通用格式）
更多子命令执行python godot_unpacker.py或前往GitHub查看
项目结构
text
godot_unpacker.py # CLI 入口
pck_reader.py # PCK 解析
resource_converter.py # 格式转换（CTEX、STEX、OGG、WAV、RSRC）
project_restorer.py # 结构还原
