资讯动态

如何用gdsdecomp完整还原Godot游戏项目?新手到高手的PCK反编译完整指南

发布时间:2026/10/18 1:34:17 来源:尧图企业网站定制
如何用gdsdecomp完整还原Godot游戏项目新手到高手的PCK反编译完整指南【免费下载链接】gdsdecompGodot reverse engineering tools项目地址: https://gitcode.com/GitHub_Trending/gd/gdsdecomp你是否遇到过这种情况手里只有一个 Godot 游戏的发布包APK、EXE 或单独的 PCK想研究里面的脚本实现或者项目源码意外丢失只剩安装包面对一堆.gdc字节码和.res二进制文件无从下手gdsdecompGodot RE Tools是一个构建在 Godot 引擎内的逆向工程工具集它能从 APK、PCK、EXE 中提取资源把 GDScript 字节码批量反编译回.gd源码并完整还原可编辑的原始项目。本文带你从环境搭建一路做到项目恢复成功。gdsdecomp能帮你做什么功能总览功能模块对应代码位置能帮你做什么完整项目恢复standalone/、utility/pck_dumper.cpp从 APK/PCK/EXE 一键还原项目文件、脚本和资源GDScript 批量反编译bytecode/将.gdc字节码转回可读的.gd源码支持 2.x/3.x/4.xPCK 提取与创建utility/pck_creator.cpp提取游戏包内容、把目录打包成 PCK、修补已有 PCK资源格式转换exporters/二进制资源.ctex、.res等与原始/文本格式互转自定义解密crypto/、docs/custom_decryptors.md应对使用非标准加密方案的游戏包安装前需要哪些准备环境搭建与快速配置前置条件Godot 引擎源码项目基于其维护的 Godot forkgdre-wb-f964fa714f5分支SCons 构建工具、C17 编译器若需要 C# 反编译能力安装 rustup 与 .NET 10 SDK从源码编译的步骤也可改用 Windows 上的scoop install gdsdecomp直接装发布版git clone https://gitcode.com/GitHub_Trending/gd/gdsdecomp ln -s $(pwd)/gdsdecomp godot/modules/gdsdecomp cd godot scons platformlinuxbsd targettemplate_debug -j$(nproc)验证方法运行bin/godot.linuxbsd.template_debug.x86_64 --version确认编译成功随后启动编辑器能看到 RE Tools 菜单就说明模块加载成功。⚠️ 注意先以编辑器方式打开一次modules/gdsdecomp/standalone目录完成资源导入再运行命令行恢复否则会缺少资源。实战演练三步完整恢复一个Godot游戏项目第一步打开目标游戏包GUI 方式在 RE Tools 菜单选 Recover project...或直接把 PCK/EXE 拖进窗口命令行方式gdre_tools --headless --recoverpath/to/game.pck想先看看包里有什么用--list-filesgame.pck。预期效果工具自动识别文件类型列出 PCK 版本、引擎版本和文件总数。⚠️ 输出目录默认是文件名_extracted想自定义请加上--outputDIR。第二步选择恢复模式在 PCK explorer 窗口中勾选要处理的文件二选一Extract only仅提取原始文件Full Recovery完整恢复推荐包含反编译与格式转换命令行中只取脚本时加--scripts-only。⚠️ 加密包必须提供 64 位十六进制密钥--keyKEY否则会直接解密失败。第三步执行恢复并检查报告点击 Extract...命令行则自动执行。完成后报告显示反编译脚本数成功/失败、成功转回原始导入格式的资源数、未转换文件列表。✅ 成功标志报告出现 Decompiled scripts: N / Failed scripts: 0并生成gdre_export.log日志文件反馈问题时请附带它。报告还会提示你该用哪个版本的 Godot 编辑器打开项目——照做可避免大量报错。它是如何工作的三大核心功能深度解析完整项目恢复不止是解压缩是什么--recover一次完成六件事——从 APK/PCK/EXE 加载资源、反编译全部 GDScript、恢复原始项目文件、把导入资源转回原始导入格式、把自动转换的二进制资源转回文本格式、重建插件配置文件。解决什么问题让你只凭发布包就能得到一个可在编辑器里继续开发的项目。怎么用gdre_tools --headless --recovergame.apk --output./restored。注意 2.x 的模型文件dae、fbx、glb和 GDNative/GDExtension 脚本暂不支持转换。GDScript 反编译靠字节码定义表自动适配版本是什么bytecode/ 目录为每个引擎版本维护了对应的字节码定义工具自动识别.gdc的字节码版本并选用正确的反编译逻辑版本对照见 BYTECODE_HISTORY.md。怎么用gdre_tools --list-bytecode-versions gdre_tools --decompilescripts/*.gdc --bytecode4.3.0--bytecode既可传版本字符串如4.3.0也可传 commit 哈希如f3f05dc。资源文本↔二进制双向转换解决什么问题想手动改场景/资源但没有源码格式文件时可以直接转换gdre_tools --bin-to-txtscene.res gdre_tools --txt-to-binscene.tscn恢复流程中的.ctex→.png等转换也由 exporters/ 里的各格式导出器自动完成。实用技巧与进阶用法这些操作能省不少事只恢复部分文件用 glob 精确过滤--include/--exclude支持通配符必须基于res://或user://根目录省略根目录时默认按res://处理*.gdc等价于res://**/*.gdcgdre_tools --headless --recovergame.pck \ --includeres://scripts/**/*.gdc --excluderes://import/**PCK 校验失败怎么办包体不完整时先试--ignore-checksum-errors忽略 MD5 校验错误问题严重时用--skip-checksum-check跳过校验再在报告里确认哪些文件损坏。反向操作自己打包与修补 PCKgdre_tools --pck-create./my_proj --pck-version2 \ --pck-engine-version4.3.0 --outputmy.pck gdre_tools --pck-patchgame.pck --patch-file/tmp/fix.gdres://fix.gd \ --outputpatched.pckC# 项目可加--csharp-assemblyPATH指定程序集路径未指定时会自动从 PCK 路径旁探测。常见问题这四个坑先绕开❓恢复出来的项目打开后报错很多用与原游戏匹配的 Godot 编辑器版本恢复报告会写明检测到的版本。若脚本、着色器报错密集可把原游戏的二进制作为导出模板再试。❓填了密钥仍解密失败多数情况是密钥本身不对——游戏常在加载后对密钥做变换。先确认密钥正确、再确认游戏用的不是标准加密方案若确为自定义方案按 docs/custom_decryptors.md 写一个继承CustomDecryptor类的 GDScript需 Godot 4.5用--custom-decryption-script指定即可。❓反编译结果和源码对不上用--force-bytecode-version4.3.0版本串或 commit 哈希强制指定字节码版本或用--load-custom-bytecodeJSON加载自定义定义文件。❓只想拿脚本不要资源gdre_tools --headless --recovergame.pck --scripts-only速度快且输出干净。下一步行动从这份资料继续深入学习资源仓库内相对路径README.md完整的命令行参数速查表docs/custom_decryptors.md自定义解密器编写指南BYTECODE_HISTORY.md各 Godot 版本与字节码的完整对照tests/现成的测试包与测试脚本适合上手练手适用场景研究优秀 Godot 游戏的实现思路恢复丢失的原始项目文件引擎版本迁移前的资源整理Godot 引擎教学与逆向技术学习现在就去仓库获取最新发布版或从源码编译挑一个手头的游戏包跑一条--recover命令——可编辑的完整项目源码就在输出目录里等你了。【免费下载链接】gdsdecompGodot reverse engineering tools项目地址: https://gitcode.com/GitHub_Trending/gd/gdsdecomp创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑