¶ How is this useful?
Decompiled code can be useful for things like:
- Writing HarmonyX patches(transpilers)
- Looking up game's classes, methods, etc. and using them in your mod
¶ How to
Game assemblies are located at /Dinkum/Dinkum_Data/Managed/ folder.
Most of the core code is located at
Assembly-CSharp
¶ Using decompiled DLLs
Before you start, make sure to do steps from here.
Most of the time you will need to use Unity or game classes in your code, to do that, you'll need to reference assemblies you need in .csproj.
<Project Sdk="Microsoft.NET.Sdk">
<!-- other item groups -->
<ItemGroup>
<!-- File name -->
<Reference Include="Assembly-CSharp-nstrip">
<!-- Relative path to the dll -->
<HintPath>../lib/strip/Assembly-CSharp-nstrip.dll</HintPath>
</Reference>
<Reference Include="Mirror-nstrip">
<HintPath>../lib/dinkum/strip/Mirror-nstrip.dll</HintPath>
</Reference>
<!-- Other assembly references -->
</ItemGroup>
</Project>
Now when you want to use something from the game or Unity, you can just write the name of a class or a method and your IDE should automaticaly import the right thing.
¶ Using your IDE to view decompiled DLLs
¶ Rider
¶ Importing assemblies
- Open your project
- Go into
Assembliestab
- Press a button that says
OpenorExplore Folder - In the open window go to the
Managed
4.1. If you choseOpen, just select a singe.dllfile
4.2. If you choseExplore Folder, selectManagedfolder - Now you can explore game code
Better do this instead of using
Managedfolder:
1. Make alibfolder in the base of your project(same folder as.slnfile)
2. Copy all assemblies you need into/lib/not_stripped/
3. Use something like NStrip to publicize and strip them, move publicized DLLs into/lib/strip/folder
4. Do the same steps as above, except you chooseExplore Folderand selectlibfolder you created.
¶ Exploring assemblies
To open an assembly, simply press an arrow button that will open a list of namespaces(<Root Namespace>, Aevus, Mirror, etc.). For base assembly you will need to open a <Root Namespace> to see its classes and their respective methods, fields. Now you can open classes and see where each class/method is used, like you would with your code(Alt + F7 if you use intellij idea keybind)
¶ Visual Studio
need someone using VS for this part
¶ Using external tools to view decompiled DLLs
For this guide dnSpy will be used.
Most of the time external decompiler is used to view IL code of a method when writing a transpiler
- Install any .NET Decompiler
- Simply drag-and-drop the dll and you should see loaded DLL
- Locate the right class and the method you want
- On top you should see
File, Edit, View, Debug, Window, Help, locate a drop down menu sayingC#and chooseIL - Have fun