Add fields to script export (PrivateImplementationDetails)

This commit is contained in:
LukeFZ
2023-11-29 19:59:48 +01:00
parent e6355bb1b4
commit 2d73e28cea
3 changed files with 445 additions and 413 deletions

View File

@@ -51,6 +51,8 @@ namespace Il2CppInspector.Model
// For il2cpp < 19, the key is the string literal ordinal instead of the address
public Dictionary<ulong, string> Strings { get; } = new Dictionary<ulong, string>();
public Dictionary<ulong, string> Fields { get; } = new Dictionary<ulong, string>();
public bool StringIndexesAreOrdinals => Package.Version < 19;
// The .NET type model for the application
@@ -243,6 +245,16 @@ namespace Il2CppInspector.Model
}
Methods[method].MethodInfoPtrAddress = address;
break;
case MetadataUsageType.FieldInfo:
if (usage.SourceIndex > TypeModel.Package.Metadata.FieldRefs.Length)
break;
var fieldRef = TypeModel.Package.FieldRefs[usage.SourceIndex];
var fieldType = TypeModel.GetMetadataUsageType(usage);
var field = fieldType.DeclaredFields.First(f => f.Index == fieldType.Definition.fieldStart + fieldRef.fieldIndex);
Fields.Add(usage.VirtualAddress, $"{fieldType.Name}.{field.Name}".ToCIdentifier());
break;
}
}

View File

@@ -1,273 +1,288 @@
// Copyright (c) 2020-2021 Katy Coe - http://www.djkaty.com - https://github.com/djkaty
// All rights reserved
using System;
using System.Collections.Generic;
using System.Linq;
using System.IO;
using System.Text.Json;
using Il2CppInspector.Reflection;
using Il2CppInspector.Model;
namespace Il2CppInspector.Outputs
{
// Output module to produce machine readable metadata in JSON format
public class JSONMetadata
{
private readonly AppModel model;
private Utf8JsonWriter writer;
// Allow non-compliant C-style comments in JSON output
public bool AllowComments { get; set; } = false;
public JSONMetadata(AppModel model) => this.model = model;
// Write JSON metadata to file
public void Write(string outputFile) {
using var fs = new FileStream(outputFile, FileMode.Create);
writer = new Utf8JsonWriter(fs, options: new JsonWriterOptions { Indented = true });
writer.WriteStartObject();
// Output address map of everything in the binary that we recognize
writeObject(
"addressMap",
() => {
writeMethods();
writeStringLiterals();
writeUsages();
writeFunctions();
writeMetadata();
writeApis();
writeExports();
writeSymbols();
},
"Address map of methods, internal functions, type pointers and string literals in the binary file"
);
writer.WriteEndObject();
writer.Dispose();
}
private void writeMethods() {
writeArray("methodDefinitions", () => writeMethods(model.GetMethodGroup("types_from_methods")), "Method definitions");
writeArray("constructedGenericMethods", () => writeMethods(model.GetMethodGroup("types_from_generic_methods")), "Constructed generic methods");
// We could use ILModel.CustomAttributeGenerators here to ensure uniqueness but then we lose function name information
// TODO: Merge CAG names that deal with multiple attribute types to reflect all of the attribute type names (solving the above)
writeArray("customAttributesGenerators", () => {
foreach (var method in model.TypeModel.AttributesByIndices.Values) {
writeObject(() => writeTypedFunctionName(method.VirtualAddress.Start, method.Signature, method.Name));
}
}, "Custom attributes generators");
writeArray("methodInvokers", () => {
foreach (var method in model.TypeModel.MethodInvokers.Where(m => m != null)) {
writeObject(() => writeTypedFunctionName(method.VirtualAddress.Start, method.GetSignature(model.UnityVersion), method.Name));
}
}, "Method.Invoke thunks");
}
private void writeMethods(IEnumerable<AppMethod> methods) {
foreach (var method in methods.Where(m => m.HasCompiledCode)) {
writeObject(() => {
writeTypedFunctionName(method.MethodCodeAddress, method.CppFnPtrType.ToSignatureString(), method.CppFnPtrType.Name);
writeDotNetSignature(method.Method);
});
}
}
private void writeStringLiterals() {
writeArray("stringLiterals", () => {
foreach (var str in model.Strings)
writeObject(() => {
// For version < 19
if (model.StringIndexesAreOrdinals) {
writer.WriteNumber("ordinal", str.Key);
writer.WriteString("name", $"STRINGLITERAL_{str.Key}_{stringToIdentifier(str.Value)}");
// For version >= 19
} else {
writer.WriteString("virtualAddress", str.Key.ToAddressString());
writer.WriteString("name", "StringLiteral_" + stringToIdentifier(str.Value));
}
writer.WriteString("string", str.Value);
});
}, "String literals");
}
private void writeUsages() {
// TypeInfo addresses for all types from metadata usages
writeArray("typeInfoPointers",
() => {
foreach (var type in model.Types.Values) {
// A type may have no addresses, for example an unreferenced array type
if (type.TypeClassAddress != 0xffffffff_ffffffff) {
writeObject(() => {
writeTypedName(type.TypeClassAddress, $"struct {type.Name}__Class *", $"{type.Name}__TypeInfo");
writeDotNetTypeName(type.Type);
});
}
}
}, "Il2CppClass (TypeInfo) pointers");
// Reference addresses for all types from metadata usages
writeArray("typeRefPointers",
() => {
foreach (var type in model.Types.Values) {
if (type.TypeRefPtrAddress != 0xffffffff_ffffffff) {
writeObject(() => {
// A generic type definition does not have any direct C++ types, but may have a reference
writeName(type.TypeRefPtrAddress, $"{type.Name}__TypeRef");
writeDotNetTypeName(type.Type);
});
}
}
}, "Il2CppType (TypeRef) pointers");
// Metedata usage methods
writeArray("methodInfoPointers",
() => {
foreach (var method in model.Methods.Values.Where(m => m.HasMethodInfo)) {
writeObject(() => {
writeName(method.MethodInfoPtrAddress, $"{method.CppFnPtrType.Name}__MethodInfo");
writeDotNetSignature(method.Method);
});
}
}, "MethodInfo pointers");
}
private void writeFunctions() {
writeArray("functionAddresses", () => {
foreach (var func in model.Package.FunctionAddresses)
writer.WriteStringValue(func.Key.ToAddressString());
}, "Function boundaries");
}
private void writeMetadata() {
var binary = model.Package.Binary;
writeArray("typeMetadata", () => {
writeObject(() => writeTypedName(binary.CodeRegistrationPointer, "struct Il2CppCodeRegistration", "g_CodeRegistration"));
writeObject(() => writeTypedName(binary.MetadataRegistrationPointer, "struct Il2CppMetadataRegistration", "g_MetadataRegistration"));
foreach (var ptr in binary.CodeGenModulePointers)
writeObject(() => writeTypedName(ptr.Value, "struct Il2CppCodeGenModule", $"g_{ptr.Key.Replace(".dll", "")}CodeGenModule"));
}, "IL2CPP Type Metadata");
// plagiarism. noun - https://www.lexico.com/en/definition/plagiarism
// the practice of taking someone else's work or ideas and passing them off as one's own.
// Synonyms: copying, piracy, theft, strealing, infringement of copyright
writeArray("functionMetadata", () => {
// This will be zero if we found the structs from the symbol table
if (binary.RegistrationFunctionPointer != 0)
if (model.UnityVersion.CompareTo("5.3.5") >= 0)
writeObject(() => writeTypedFunctionName(binary.RegistrationFunctionPointer,
"void il2cpp_codegen_register(const Il2CppCodeRegistration* const codeRegistration, const Il2CppMetadataRegistration* const metadataRegistration, const Il2CppCodeGenOptions* const codeGenOptions)",
"il2cpp_codegen_register"));
else
writeObject(() => writeTypedFunctionName(binary.RegistrationFunctionPointer,
"void il2cpp_codegen_register(const Il2CppCodeRegistration* const codeRegistration, const Il2CppMetadataRegistration* const metadataRegistration)",
"il2cpp_codegen_register"));
}, "IL2CPP Function Metadata");
// TODO: In the future, add data ranges for the entire IL2CPP metadata tree
writeArray("arrayMetadata", () => {
if (model.Package.Version >= 24.2) {
writeObject(() => writeTypedArray(binary.CodeRegistration.pcodeGenModules, binary.Modules.Count, "struct Il2CppCodeGenModule *", "g_CodeGenModules"));
}
}, "IL2CPP Array Metadata");
}
private void writeApis() {
var apis = model.AvailableAPIs;
writeArray("apis", () => {
foreach (var api in apis) {
var address = apis.primaryToSubkeyMapping[api.Key];
writeObject(() => writeTypedFunctionName(address, api.Value.ToSignatureString(), api.Key));
}
}, "IL2CPP API functions");
}
private void writeExports() {
var exports = model.Exports;
writeArray("exports", () => {
foreach (var export in exports) {
writeObject(() => writeName(export.VirtualAddress, export.Name));
}
}, "Exports");
}
private void writeSymbols() {
var symbols = model.Symbols.Values;
writeArray("symbols", () => {
foreach (var symbol in symbols) {
writeObject(() => {
writeName(symbol.VirtualAddress, symbol.Name);
writer.WriteString("demangledName", symbol.DemangledName);
writer.WriteString("type", symbol.Type.ToString());
});
}
}, "Symbol table");
}
// JSON helpers
private void writeObject(Action objectWriter) => writeObject(null, objectWriter);
private void writeObject(string name, Action objectWriter, string description = null) {
if (AllowComments && description != null)
writer.WriteCommentValue(" " + description + " ");
if (name != null)
writer.WriteStartObject(name);
else
writer.WriteStartObject();
objectWriter();
writer.WriteEndObject();
}
private void writeArray(string name, Action arrayWriter, string description = null) {
writer.WriteStartArray(name);
if (AllowComments && description != null)
writer.WriteCommentValue(" " + description + " ");
arrayWriter();
writer.WriteEndArray();
}
private void writeName(ulong address, string name) {
writer.WriteString("virtualAddress", address.ToAddressString());
writer.WriteString("name", name.ToEscapedString());
}
private void writeTypedName(ulong address, string type, string name) {
writeName(address, name);
writer.WriteString("type", type.ToEscapedString());
}
private void writeTypedFunctionName(ulong address, string type, string name) {
writeName(address, name);
writer.WriteString("signature", type.ToEscapedString());
}
private void writeTypedArray(ulong address, int count, string type, string name) {
writeTypedName(address, type, name);
writer.WriteNumber("count", count);
}
private void writeDotNetSignature(MethodBase method) {
writer.WriteString("dotNetSignature", method.ToString().ToEscapedString());
}
private void writeDotNetTypeName(TypeInfo type) {
writer.WriteString("dotNetType", type.CSharpName);
}
private static string stringToIdentifier(string str) {
str = str.Substring(0, Math.Min(32, str.Length));
return str.ToCIdentifier();
}
}
}
// Copyright (c) 2020-2021 Katy Coe - http://www.djkaty.com - https://github.com/djkaty
// All rights reserved
using System;
using System.Collections.Generic;
using System.Linq;
using System.IO;
using System.Text.Json;
using Il2CppInspector.Reflection;
using Il2CppInspector.Model;
namespace Il2CppInspector.Outputs
{
// Output module to produce machine readable metadata in JSON format
public class JSONMetadata
{
private readonly AppModel model;
private Utf8JsonWriter writer;
// Allow non-compliant C-style comments in JSON output
public bool AllowComments { get; set; } = false;
public JSONMetadata(AppModel model) => this.model = model;
// Write JSON metadata to file
public void Write(string outputFile) {
using var fs = new FileStream(outputFile, FileMode.Create);
writer = new Utf8JsonWriter(fs, options: new JsonWriterOptions { Indented = true });
writer.WriteStartObject();
// Output address map of everything in the binary that we recognize
writeObject(
"addressMap",
() => {
writeMethods();
writeStringLiterals();
writeUsages();
writeFunctions();
writeMetadata();
writeApis();
writeExports();
writeSymbols();
writeFields();
},
"Address map of methods, internal functions, type pointers and string literals in the binary file"
);
writer.WriteEndObject();
writer.Dispose();
}
private void writeMethods() {
writeArray("methodDefinitions", () => writeMethods(model.GetMethodGroup("types_from_methods")), "Method definitions");
writeArray("constructedGenericMethods", () => writeMethods(model.GetMethodGroup("types_from_generic_methods")), "Constructed generic methods");
// We could use ILModel.CustomAttributeGenerators here to ensure uniqueness but then we lose function name information
// TODO: Merge CAG names that deal with multiple attribute types to reflect all of the attribute type names (solving the above)
writeArray("customAttributesGenerators", () => {
foreach (var method in model.TypeModel.AttributesByIndices.Values) {
writeObject(() => writeTypedFunctionName(method.VirtualAddress.Start, method.Signature, method.Name));
}
}, "Custom attributes generators");
writeArray("methodInvokers", () => {
foreach (var method in model.TypeModel.MethodInvokers.Where(m => m != null)) {
writeObject(() => writeTypedFunctionName(method.VirtualAddress.Start, method.GetSignature(model.UnityVersion), method.Name));
}
}, "Method.Invoke thunks");
}
private void writeMethods(IEnumerable<AppMethod> methods) {
foreach (var method in methods.Where(m => m.HasCompiledCode)) {
writeObject(() => {
writeTypedFunctionName(method.MethodCodeAddress, method.CppFnPtrType.ToSignatureString(), method.CppFnPtrType.Name);
writeDotNetSignature(method.Method);
});
}
}
private void writeStringLiterals() {
writeArray("stringLiterals", () => {
foreach (var str in model.Strings)
writeObject(() => {
// For version < 19
if (model.StringIndexesAreOrdinals) {
writer.WriteNumber("ordinal", str.Key);
writer.WriteString("name", $"STRINGLITERAL_{str.Key}_{stringToIdentifier(str.Value)}");
// For version >= 19
} else {
writer.WriteString("virtualAddress", str.Key.ToAddressString());
writer.WriteString("name", "StringLiteral_" + stringToIdentifier(str.Value));
}
writer.WriteString("string", str.Value);
});
}, "String literals");
}
private void writeUsages() {
// TypeInfo addresses for all types from metadata usages
writeArray("typeInfoPointers",
() => {
foreach (var type in model.Types.Values) {
// A type may have no addresses, for example an unreferenced array type
if (type.TypeClassAddress != 0xffffffff_ffffffff) {
writeObject(() => {
writeTypedName(type.TypeClassAddress, $"struct {type.Name}__Class *", $"{type.Name}__TypeInfo");
writeDotNetTypeName(type.Type);
});
}
}
}, "Il2CppClass (TypeInfo) pointers");
// Reference addresses for all types from metadata usages
writeArray("typeRefPointers",
() => {
foreach (var type in model.Types.Values) {
if (type.TypeRefPtrAddress != 0xffffffff_ffffffff) {
writeObject(() => {
// A generic type definition does not have any direct C++ types, but may have a reference
writeName(type.TypeRefPtrAddress, $"{type.Name}__TypeRef");
writeDotNetTypeName(type.Type);
});
}
}
}, "Il2CppType (TypeRef) pointers");
// Metedata usage methods
writeArray("methodInfoPointers",
() => {
foreach (var method in model.Methods.Values.Where(m => m.HasMethodInfo)) {
writeObject(() => {
writeName(method.MethodInfoPtrAddress, $"{method.CppFnPtrType.Name}__MethodInfo");
writeDotNetSignature(method.Method);
});
}
}, "MethodInfo pointers");
}
private void writeFunctions() {
writeArray("functionAddresses", () => {
foreach (var func in model.Package.FunctionAddresses)
writer.WriteStringValue(func.Key.ToAddressString());
}, "Function boundaries");
}
private void writeMetadata() {
var binary = model.Package.Binary;
writeArray("typeMetadata", () => {
writeObject(() => writeTypedName(binary.CodeRegistrationPointer, "struct Il2CppCodeRegistration", "g_CodeRegistration"));
writeObject(() => writeTypedName(binary.MetadataRegistrationPointer, "struct Il2CppMetadataRegistration", "g_MetadataRegistration"));
foreach (var ptr in binary.CodeGenModulePointers)
writeObject(() => writeTypedName(ptr.Value, "struct Il2CppCodeGenModule", $"g_{ptr.Key.Replace(".dll", "")}CodeGenModule"));
}, "IL2CPP Type Metadata");
// plagiarism. noun - https://www.lexico.com/en/definition/plagiarism
// the practice of taking someone else's work or ideas and passing them off as one's own.
// Synonyms: copying, piracy, theft, strealing, infringement of copyright
writeArray("functionMetadata", () => {
// This will be zero if we found the structs from the symbol table
if (binary.RegistrationFunctionPointer != 0)
if (model.UnityVersion.CompareTo("5.3.5") >= 0)
writeObject(() => writeTypedFunctionName(binary.RegistrationFunctionPointer,
"void il2cpp_codegen_register(const Il2CppCodeRegistration* const codeRegistration, const Il2CppMetadataRegistration* const metadataRegistration, const Il2CppCodeGenOptions* const codeGenOptions)",
"il2cpp_codegen_register"));
else
writeObject(() => writeTypedFunctionName(binary.RegistrationFunctionPointer,
"void il2cpp_codegen_register(const Il2CppCodeRegistration* const codeRegistration, const Il2CppMetadataRegistration* const metadataRegistration)",
"il2cpp_codegen_register"));
}, "IL2CPP Function Metadata");
// TODO: In the future, add data ranges for the entire IL2CPP metadata tree
writeArray("arrayMetadata", () => {
if (model.Package.Version >= 24.2) {
writeObject(() => writeTypedArray(binary.CodeRegistration.pcodeGenModules, binary.Modules.Count, "struct Il2CppCodeGenModule *", "g_CodeGenModules"));
}
}, "IL2CPP Array Metadata");
}
private void writeApis() {
var apis = model.AvailableAPIs;
writeArray("apis", () => {
foreach (var api in apis) {
var address = apis.primaryToSubkeyMapping[api.Key];
writeObject(() => writeTypedFunctionName(address, api.Value.ToSignatureString(), api.Key));
}
}, "IL2CPP API functions");
}
private void writeExports() {
var exports = model.Exports;
writeArray("exports", () => {
foreach (var export in exports) {
writeObject(() => writeName(export.VirtualAddress, export.Name));
}
}, "Exports");
}
private void writeSymbols() {
var symbols = model.Symbols.Values;
writeArray("symbols", () => {
foreach (var symbol in symbols) {
writeObject(() => {
writeName(symbol.VirtualAddress, symbol.Name);
writer.WriteString("demangledName", symbol.DemangledName);
writer.WriteString("type", symbol.Type.ToString());
});
}
}, "Symbol table");
}
private void writeFields()
{
writeArray("fields", () =>
{
foreach (var field in model.Fields)
{
writeObject(() =>
{
writeName(field.Key, field.Value);
});
}
});
}
// JSON helpers
private void writeObject(Action objectWriter) => writeObject(null, objectWriter);
private void writeObject(string name, Action objectWriter, string description = null) {
if (AllowComments && description != null)
writer.WriteCommentValue(" " + description + " ");
if (name != null)
writer.WriteStartObject(name);
else
writer.WriteStartObject();
objectWriter();
writer.WriteEndObject();
}
private void writeArray(string name, Action arrayWriter, string description = null) {
writer.WriteStartArray(name);
if (AllowComments && description != null)
writer.WriteCommentValue(" " + description + " ");
arrayWriter();
writer.WriteEndArray();
}
private void writeName(ulong address, string name) {
writer.WriteString("virtualAddress", address.ToAddressString());
writer.WriteString("name", name.ToEscapedString());
}
private void writeTypedName(ulong address, string type, string name) {
writeName(address, name);
writer.WriteString("type", type.ToEscapedString());
}
private void writeTypedFunctionName(ulong address, string type, string name) {
writeName(address, name);
writer.WriteString("signature", type.ToEscapedString());
}
private void writeTypedArray(ulong address, int count, string type, string name) {
writeTypedName(address, type, name);
writer.WriteNumber("count", count);
}
private void writeDotNetSignature(MethodBase method) {
writer.WriteString("dotNetSignature", method.ToString().ToEscapedString());
}
private void writeDotNetTypeName(TypeInfo type) {
writer.WriteString("dotNetType", type.CSharpName);
}
private static string stringToIdentifier(string str) {
str = str.Substring(0, Math.Min(32, str.Length));
return str.ToCIdentifier();
}
}
}

View File

@@ -1,140 +1,145 @@
# Shared interface
def AsUTF8(s):
return s if sys.version_info[0] > 2 else s.encode('utf-8')
def ParseAddress(d):
return int(d['virtualAddress'], 0)
def DefineILMethod(jsonDef):
addr = ParseAddress(jsonDef)
SetName(addr, AsUTF8(jsonDef['name']))
SetFunctionType(addr, AsUTF8(jsonDef['signature']))
SetHeaderComment(addr, AsUTF8(jsonDef['dotNetSignature']))
def DefineILMethodInfo(jsonDef):
addr = ParseAddress(jsonDef)
SetName(addr, AsUTF8(jsonDef['name']))
SetType(addr, r'struct MethodInfo *')
SetComment(addr, AsUTF8(jsonDef['dotNetSignature']))
def DefineCppFunction(jsonDef):
addr = ParseAddress(jsonDef)
SetName(addr, AsUTF8(jsonDef['name']))
SetFunctionType(addr, AsUTF8(jsonDef['signature']))
def DefineString(jsonDef):
addr = ParseAddress(jsonDef)
SetName(addr, AsUTF8(jsonDef['name']))
SetType(addr, r'struct String *')
SetComment(addr, AsUTF8(jsonDef['string']))
def DefineFieldFromJson(jsonDef):
DefineField(jsonDef['virtualAddress'], jsonDef['name'], jsonDef['type'], jsonDef['dotNetType'])
def DefineField(addr, name, type, ilType = None):
addr = int(addr, 0)
SetName(addr, AsUTF8(name))
SetType(addr, AsUTF8(type))
if (ilType is not None):
SetComment(addr, AsUTF8(ilType))
def DefineArray(jsonDef):
addr = ParseAddress(jsonDef)
MakeArray(addr, int(jsonDef['count']), AsUTF8(jsonDef['type']))
SetName(addr, AsUTF8(jsonDef['name']))
# Process JSON
def ProcessJSON(jsonData):
# Method definitions
print('Processing method definitions')
for d in jsonData['methodDefinitions']:
DefineILMethod(d)
# Constructed generic methods
print('Processing constructed generic methods')
for d in jsonData['constructedGenericMethods']:
DefineILMethod(d)
# Custom attributes generators
print('Processing custom attributes generators')
for d in jsonData['customAttributesGenerators']:
DefineCppFunction(d)
# Method.Invoke thunks
print('Processing Method.Invoke thunks')
for d in jsonData['methodInvokers']:
DefineCppFunction(d)
# String literals for version >= 19
print('Processing string literals')
if 'virtualAddress' in jsonData['stringLiterals'][0]:
for d in jsonData['stringLiterals']:
DefineString(d)
# String literals for version < 19
else:
litDecl = 'enum StringLiteralIndex {\n'
for d in jsonData['stringLiterals']:
litDecl += " " + AsUTF8(d['name']) + ",\n"
litDecl += '};\n'
DefineCode(litDecl)
# Il2CppClass (TypeInfo) pointers
print('Processing Il2CppClass (TypeInfo) pointers')
for d in jsonData['typeInfoPointers']:
DefineFieldFromJson(d)
# Il2CppType (TypeRef) pointers
print('Processing Il2CppType (TypeRef) pointers')
for d in jsonData['typeRefPointers']:
DefineField(d['virtualAddress'], d['name'], r'struct Il2CppType *', d['dotNetType'])
# MethodInfo pointers
print('Processing MethodInfo pointers')
for d in jsonData['methodInfoPointers']:
DefineILMethodInfo(d)
# Function boundaries
print('Processing function boundaries')
functionAddresses = jsonData['functionAddresses']
functionAddresses.sort()
count = len(functionAddresses)
for i in range(count):
addrStart = int(functionAddresses[i],0)
if addrStart == 0:
continue
addrNext = None
if i != count -1:
addrNext = int(functionAddresses[i+1],0)
MakeFunction(addrStart,None,addrNext)
# IL2CPP type metadata
print('Processing IL2CPP type metadata')
for d in jsonData['typeMetadata']:
DefineField(d['virtualAddress'], d['name'], d['type'])
# IL2CPP function metadata
print('Processing IL2CPP function metadata')
for d in jsonData['functionMetadata']:
DefineCppFunction(d)
# IL2CPP array metadata
print('Processing IL2CPP array metadata')
for d in jsonData['arrayMetadata']:
DefineArray(d)
# IL2CPP API functions
print('Processing IL2CPP API functions')
for d in jsonData['apis']:
DefineCppFunction(d)
# Entry point
print('Generated script file by Il2CppInspector - http://www.djkaty.com - https://github.com/djkaty')
CustomInitializer()
with open(os.path.join(GetScriptDirectory(), "%JSON_METADATA_RELATIVE_PATH%"), "r") as jsonFile:
jsonData = json.load(jsonFile)['addressMap']
ProcessJSON(jsonData)
print('Script execution complete.')
# Shared interface
def AsUTF8(s):
return s if sys.version_info[0] > 2 else s.encode('utf-8')
def ParseAddress(d):
return int(d['virtualAddress'], 0)
def DefineILMethod(jsonDef):
addr = ParseAddress(jsonDef)
SetName(addr, AsUTF8(jsonDef['name']))
SetFunctionType(addr, AsUTF8(jsonDef['signature']))
SetHeaderComment(addr, AsUTF8(jsonDef['dotNetSignature']))
def DefineILMethodInfo(jsonDef):
addr = ParseAddress(jsonDef)
SetName(addr, AsUTF8(jsonDef['name']))
SetType(addr, r'struct MethodInfo *')
SetComment(addr, AsUTF8(jsonDef['dotNetSignature']))
def DefineCppFunction(jsonDef):
addr = ParseAddress(jsonDef)
SetName(addr, AsUTF8(jsonDef['name']))
SetFunctionType(addr, AsUTF8(jsonDef['signature']))
def DefineString(jsonDef):
addr = ParseAddress(jsonDef)
SetName(addr, AsUTF8(jsonDef['name']))
SetType(addr, r'struct String *')
SetComment(addr, AsUTF8(jsonDef['string']))
def DefineFieldFromJson(jsonDef):
DefineField(jsonDef['virtualAddress'], jsonDef['name'], jsonDef['type'], jsonDef['dotNetType'])
def DefineField(addr, name, type, ilType = None):
addr = int(addr, 0)
SetName(addr, AsUTF8(name))
SetType(addr, AsUTF8(type))
if (ilType is not None):
SetComment(addr, AsUTF8(ilType))
def DefineArray(jsonDef):
addr = ParseAddress(jsonDef)
MakeArray(addr, int(jsonDef['count']), AsUTF8(jsonDef['type']))
SetName(addr, AsUTF8(jsonDef['name']))
# Process JSON
def ProcessJSON(jsonData):
# Method definitions
print('Processing method definitions')
for d in jsonData['methodDefinitions']:
DefineILMethod(d)
# Constructed generic methods
print('Processing constructed generic methods')
for d in jsonData['constructedGenericMethods']:
DefineILMethod(d)
# Custom attributes generators
print('Processing custom attributes generators')
for d in jsonData['customAttributesGenerators']:
DefineCppFunction(d)
# Method.Invoke thunks
print('Processing Method.Invoke thunks')
for d in jsonData['methodInvokers']:
DefineCppFunction(d)
# String literals for version >= 19
print('Processing string literals')
if 'virtualAddress' in jsonData['stringLiterals'][0]:
for d in jsonData['stringLiterals']:
DefineString(d)
# String literals for version < 19
else:
litDecl = 'enum StringLiteralIndex {\n'
for d in jsonData['stringLiterals']:
litDecl += " " + AsUTF8(d['name']) + ",\n"
litDecl += '};\n'
DefineCode(litDecl)
# Il2CppClass (TypeInfo) pointers
print('Processing Il2CppClass (TypeInfo) pointers')
for d in jsonData['typeInfoPointers']:
DefineFieldFromJson(d)
# Il2CppType (TypeRef) pointers
print('Processing Il2CppType (TypeRef) pointers')
for d in jsonData['typeRefPointers']:
DefineField(d['virtualAddress'], d['name'], r'struct Il2CppType *', d['dotNetType'])
# MethodInfo pointers
print('Processing MethodInfo pointers')
for d in jsonData['methodInfoPointers']:
DefineILMethodInfo(d)
# FieldInfo
print('Processing FieldInfo pointers')
for d in jsonData['fields']:
DefineField(d['virtualAddress'], d['name'], r"uint64_t")
# Function boundaries
print('Processing function boundaries')
functionAddresses = jsonData['functionAddresses']
functionAddresses.sort()
count = len(functionAddresses)
for i in range(count):
addrStart = int(functionAddresses[i],0)
if addrStart == 0:
continue
addrNext = None
if i != count -1:
addrNext = int(functionAddresses[i+1],0)
MakeFunction(addrStart,None,addrNext)
# IL2CPP type metadata
print('Processing IL2CPP type metadata')
for d in jsonData['typeMetadata']:
DefineField(d['virtualAddress'], d['name'], d['type'])
# IL2CPP function metadata
print('Processing IL2CPP function metadata')
for d in jsonData['functionMetadata']:
DefineCppFunction(d)
# IL2CPP array metadata
print('Processing IL2CPP array metadata')
for d in jsonData['arrayMetadata']:
DefineArray(d)
# IL2CPP API functions
print('Processing IL2CPP API functions')
for d in jsonData['apis']:
DefineCppFunction(d)
# Entry point
print('Generated script file by Il2CppInspector - http://www.djkaty.com - https://github.com/djkaty')
CustomInitializer()
with open(os.path.join(GetScriptDirectory(), "%JSON_METADATA_RELATIVE_PATH%"), "r") as jsonFile:
jsonData = json.load(jsonFile)['addressMap']
ProcessJSON(jsonData)
print('Script execution complete.')