Skip to content

Commit

Permalink
Update documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
ds5678 committed Sep 15, 2024
1 parent a2c57b1 commit 4105261
Show file tree
Hide file tree
Showing 2 changed files with 18 additions and 1 deletion.
2 changes: 1 addition & 1 deletion Il2CppInterop.Pdb.Generator/Program.cs
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ public static void Main(string[] args)
{
if (args.Length <= 1)
{
Console.WriteLine($"Usage: UnhollowerPdbGen.exe <path to GameAssembly.dll> <path to {MethodAddressToTokenMap.FileName}>");
Console.WriteLine($"Usage: Il2CppInterop.Pdb.Generator.exe <path to GameAssembly.dll> <path to {MethodAddressToTokenMap.FileName}>");
}
var rootPath = Path.GetDirectoryName(args[0])!;
var map = new MethodAddressToTokenMap(args[1]);
Expand Down
17 changes: 17 additions & 0 deletions Il2CppInterop.Pdb.Generator/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
# PDB generator

This is an executable that can be ran to generate a Microsoft PDB file (debug symbols) for GameAssembly.dll based on unhollower-generated names.

This can be useful for analyzing code of obfuscated games. For unobfuscated games, using [Il2CppInspector](https://github.com/djkaty/Il2CppInspector) might provide better results for code analysis.

Generated PDBs were tested with windbg, lldb, WPA viewer/ETL performance analysis and IDA.

Generated PDBs only include generated methods, and don't include type info, generic method info and IL2CPP internals.

You need to manually copy the following Microsoft-provided libraries from Visual Studio (or other build tools) for this to work. They cannot be redistributed because the license on them is not clear.

* `mspdbcore.dll`
* `msobj140.dll`
* `tbbmalloc.dll`

These need to be placed next to the built executable file. Use file search to find `mspdbcore` in the Visual Studio install directory. By default, they are in `C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\IDE\`.

0 comments on commit 4105261

Please sign in to comment.