This software in an alpha stage. Please report any bugs on the github page.
This module includes following features:
Full project recovery performs the following:
This module has support for decompiling Godot 4.x, 3.x, and 2.x projects.
Grab the latest release version from here: https://github.com/bruvzg/gdsdecomp/releases
gdre_tools --headless --recover=game.pck
--recover=<pck/exe/apk>
: Perform full project recovery on the specified PCK/EXE/APK.--extract=<pck/exe/apk>
: Perform extraction only (no resource conversion) on the specified PCK/EXE/APK--output-dir=<out_dir>
: Output directory, defaults to <NAME>_extracted
, or the project directory if one is specified--key=<key>
: The Key to use if PAK/EXE/APK is encrypted (64 character hex string)--ignore-checksum-errors
: Ignore MD5 errors during PCK checking and perform recovery/extraction anywayUse the same Godot tools version that the original game was compiled in to edit the project; the recovery log will state what version was detected.
Support has yet to be implemented for converting the following resources:
obj
, dae
, fbx
, glb
, etc.)Support for converting certain resources is limited:
.translation
files only storing the hashes of the keys. It is recommended to just politely ask the developer if you want to add additional translations.In addition, it does not support decompiling any GDNative/GDExtension or GDMono scripts. For Mono/CSharp, you can use Ilspy or dotPeek.
Clone this repository into Godot's modules
subfolder as gdsdecomp
.
Rebuild Godot engine as described in https://docs.godotengine.org/en/latest/development/compiling/index.html.
For ease of bootstrapping development, we have included launch, build, and settings templates for vscode in the .vscode directory. Once you have read the instructions for compiling Godot above and set up your build environment: put these in the .vscode folder in the Godot directory (not gdsdecomp), remove the ".template" from each, and launch vscode from the Godot directory.
Godot 4.0 (master branch) @ daeb1c7292cbb426fd45c5ca98b1c7da40b390ba
Assuming you compiled with scons platform=linuxbsd target=template_debug
,
$ bin/godot.linuxbsd.template_debug.x86_64.llvm --headless --path=modules/gdsdecomp/standalone --recover=<pck/apk/exe>
The source code of the module is licensed under MIT license.