A command-line tool that will decompile the script resources (xsc,csc,ysc,osc) files from the X360, PS3, PS4 and PC versions of Grand Theft Auto V and Red Dead Redemption 2 (RDR3). You are not allowed to use this tool for the purpose of creating modification in GTA:Online/RDR:Online.
Note: this tool is deprecated and a rewrite (improved type inference, call-graph analysis/clustering, struct-reversing for natives/codegen) is in progress.
- GTA-V-Script-Decompiler
- gta5-nativedb-data: Native table used for V & V-Console decompilation. Dataset slightly modified to include cross-mapping. 32-bit console hashes use only the v323 Jenkins hashes.
- rdr3-nativedb-data: Native table used for RDR3 & RDR-Console decompilation. Dataset will require modification on version bump & hash changes.
- emcifuntik: 1737-to-1868 V Crossmap.
--help Display this help screen.
--version Display version information.
-i, --in Input Directory/File Path.
-o, --out Output Directory/File Path.
-c, --opcode Opcode Set (v|vconsole|rdr|rdr1311|rdrconsole) (Default: v)
-n, --natives native json file. On null use the use the defined opcode set to select a native resource.
-f, --force Allow output file overriding. (Default: false)
-a, --aggregate Compute aggregation statistics of bulk dataset. (Default: false)
--minlines Minimum function line count for aggregation (Default: -1)
--minhits Minimum number of occurrences for aggregation. (Default: -1)
--gzin Compressed Input (GZIP) (Default: false)
--gzout Compress Output (GZIP) (Default: false)
--default Use default configuration (Default: false)
--uppercase Use uppercase native names (Default: true)
--namespace Concatenate Namespace to Native definition (Default: true)
--int Integer Formatting Method (int, uint, hex) (Default: "int")
--hash Use hash (Entity.dat) lookup table when formatting integers (Default: true)
--arraysize Show array sizes in definitions (Default: true)
--declare Declare all variables at the beginning of function/script definitions (Default: true)
--shift Shift variable names, i.e., take into consideration the immediate size of stack values (Default: false)
--mt Multithreaded decompilation (Default: true)
--position Show function location in definition (Default: false)
# Decompile a single RDR Native Script
decompiler.exe --default --opcode=rdr -n "Root:\rdr3-nativedb-data\natives.json" -i "Root:\rdr\ysc\startup_mp.ysc.full" -o "../somerelativepath/startup_mp.ysc.c"
# Decompile a single 1311 RDR Native Script, and explode your console
decompiler.exe --default --opcode=rdr1311 -n "Root:\rdr3-nativedb-data\natives.json" -i "Root:\rdr\ysc\fm_mission_controller.ysc"
# Bulk decompile GTA Native Scripts with aggregation statistics
decompiler.exe --default --opcode=v -a -n "Root:\gta5-nativedb-data\natives.json" -i "Root:\gta\ysc" -o "Root:\gta-v-decompiled-scripts.1737"
# Bulk decompile compressed RDR3
decompiler.exe --default --opcode=rdr --gzin -n ./rdr3-nativedb-data/natives.json -i ./ysc/script_mp_rel -o ./rdr3-decompiled-scripts.1232/script_mp_relA ScriptFile decompiles each function in a way that removes all state data. These stateless-functions are then compared (via SHA256) against the stateless-functions to all other scripts to create a collection of shared (aggregated) functions. For example,
int af_intro_t_sandy.func_23(int iParam0)
{
int iVar0;
int iVar1;
if (ENTITY::DOES_ENTITY_EXIST(iParam0))
{
iVar1 = ENTITY::GET_ENTITY_MODEL(iParam0);
iVar0 = 0;
while (iVar0 <= 2)
{
if (func_24(iVar0) == iVar1)
{
return iVar0;
}
iVar0++;
}
}
return 145;
}Stateless:
int func_(Param)
{
int i;
int i;
if (ENTITY::DOES_ENTITY_EXIST(Param))
{
Var = ENTITY::GET_ENTITY_MODEL(Param);
Var = 0;
while (Var <= 2)
{
if (func_(Var) == Var)
{
return Var;
}
Var++;
}
}
return 145;
}Which exists in 615 other locations across the v1737 GTA V PC natives.