||2 months ago|
|.github||2 months ago|
|.scripts||1 year ago|
|.vscode||2 months ago|
|bytecode||2 months ago|
|compat||2 months ago|
|doc_classes||1 year ago|
|editor||2 months ago|
|external/toojpeg||1 year ago|
|helpers||3 years ago|
|icons||3 years ago|
|images||4 months ago|
|misc||1 year ago|
|standalone||2 months ago|
|utility||2 months ago|
|.clang-format||1 year ago|
|.gitattributes||1 year ago|
|.gitignore||2 months ago|
|BYTECODE_HISTORY.md||2 years ago|
|LICENSE||4 years ago|
|README.md||2 months ago|
|SCsub||4 months ago|
|config.py||1 year ago|
|gdre_icon_builder.py||8 months ago|
|register_types.cpp||2 months ago|
|register_types.h||8 months ago|
Godot RE Tools
This software in an alpha stage. Please report any bugs on the github page.
This module includes following tools:
- Full project recovery
- PCK archive extractor / creator.
- GDScript batch decompiler.
- Resource text <-> binary batch converter.
Full project recovery performs the following:
- Loads project resources from an APK, PCK, or embedded EXE file
- Decompiles all GDScript scripts
- Recovers the original project file
- Converts all imported resources back to their original import formats
- Converts any auto-converted binary resources back to their original text formats
- Recreates any plugin configuration files
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
Support has yet to be implemented for converting the following resources:
- ADPCM wavs
- Translation files
- Models (
In addition, it does not support decompiling any GDNative or GDMono scripts. For Mono/CSharp, you can use Ilspy or dotPeek.
- To perform full project recovery from the GUI, select "Recover project..." from the "RE Tools" menu:
- If the project is encrypted, select the "Set encryption key..." menu option first first and enter the key.
- In the file dialog, select the apk, pck, or embedded exe you want to recover:
- In the PCK explorer dialog, select "Full Recovery" or "Extract Only", then select the directory you want to recover the project to, then click "Extract...":
- After it finishes, it will pop up a recovery box telling you the location of the log file, what editor version you should use when editing the recovered project, report any non-recovered assets:
gdre_tools --headless --recover=game.pck
--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)
Use 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.
Compiling from source
Clone this repository into Godot's
modules subfolder as
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) @ commit
- Support for building on 3.x has been dropped and no new features are being pushed
- Godot RE Tools still retains the ability to decompile 3.x and 2.x projects, however.
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.