[![GitHub Workflow Status](https://camo.githubusercontent.com/265a19a3cab6a81bd164ede31c1d4c4dc644dedd6773afe8df8db4c7ffddd43f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f426570496e45782f496c32437070496e7465726f702f646f746e65742e796d6c)](https://github.com/BepInEx/Il2CppInterop/actions/workflows/dotnet.yml) [![GitHub release (latest by date)](https://camo.githubusercontent.com/a2d83ce14e800ce7ababee5e8eae65f5b7deb0b39c9dc9c297bd38fb253fbabe/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f426570496e45782f496c32437070496e7465726f70)](https://github.com/BepInEx/Il2CppInterop/releases) | | CLI | Generator | Runtime | HarmonySupport | |----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **NuGet.org** (release) | [![BepInEx NuGet (CLI)](https://camo.githubusercontent.com/52ca806cc8024685603ee058daa96befde92b82ebff9e53ed1df920e59109900/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f496c32437070496e7465726f702e434c493f6c6162656c3d4e75476574)](https://www.nuget.org/packages/Il2CppInterop.CLI) | [![BepInEx NuGet (Generator)](https://camo.githubusercontent.com/233b90c50cb695303800b0d4fbdef1ad999e8e44fb17f0a40c4e66e5473f5640/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f496c32437070496e7465726f702e47656e657261746f723f6c6162656c3d4e75476574)](https://www.nuget.org/packages/Il2CppInterop.Generator) | [![BepInEx NuGet (Runtime)](https://camo.githubusercontent.com/e7859f5dcbbed8c4ae697a62d0a85d56766f4de4eca90bec5aad421015079185/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f496c32437070496e7465726f702e52756e74696d653f6c6162656c3d4e75476574)](https://www.nuget.org/packages/Il2CppInterop.Runtime) | [![BepInEx NuGet (HarmonySupport )](https://camo.githubusercontent.com/3eeed513e4b64e2a996ac4560e045a2faa2e95a6f64cb4e5033c9d3fa6f1c40e/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f496c32437070496e7465726f702e4861726d6f6e79537570706f72743f6c6162656c3d4e75476574)](https://www.nuget.org/packages/Il2CppInterop.HarmonySupport ) | | **nuget.bepinex.dev** (CI) | [![BepInEx NuGet (CLI)](https://camo.githubusercontent.com/8b66705fcea28abba5455eac5c7dbc7514bacce0623a186b94ca97cbf084b531/68747470733a2f2f696d672e736869656c64732e696f2f656e64706f696e743f636f6c6f723d626c7565266c6162656c3d4e754765742675726c3d68747470733a2f2f736869656c64732e6b7a752e696f2f767072652f496c32437070496e7465726f702e434c493f666565643d6e756765742e626570696e65782e6465762f76332f696e6465782e6a736f6e)](https://nuget.bepinex.dev/packages/Il2CppInterop.CLI) | [![BepInEx NuGet (Generator)](https://camo.githubusercontent.com/022b8884ef58c212ba66b0a69a2e08b9e4a462c5435c5fc811c988a769072de7/68747470733a2f2f696d672e736869656c64732e696f2f656e64706f696e743f636f6c6f723d626c7565266c6162656c3d4e754765742675726c3d68747470733a2f2f736869656c64732e6b7a752e696f2f767072652f496c32437070496e7465726f702e47656e657261746f723f666565643d6e756765742e626570696e65782e6465762f76332f696e6465782e6a736f6e)](https://nuget.bepinex.dev/packages/Il2CppInterop.Generator) | [![BepInEx NuGet (Runtime)](https://camo.githubusercontent.com/442ba7941567cb08bbe2b3d16c49ec5894594beff5a79f8913a9966e9a754014/68747470733a2f2f696d672e736869656c64732e696f2f656e64706f696e743f636f6c6f723d626c7565266c6162656c3d4e754765742675726c3d68747470733a2f2f736869656c64732e6b7a752e696f2f767072652f496c32437070496e7465726f702e52756e74696d653f666565643d6e756765742e626570696e65782e6465762f76332f696e6465782e6a736f6e)](https://nuget.bepinex.dev/packages/Il2CppInterop.Runtime) | [![BepInEx NuGet (HarmonySupport)](https://camo.githubusercontent.com/5df5239d442036b02ea46cb340ba8ad8f532da4b27b01b80b3f8ef103940a5c0/68747470733a2f2f696d672e736869656c64732e696f2f656e64706f696e743f636f6c6f723d626c7565266c6162656c3d4e754765742675726c3d68747470733a2f2f736869656c64732e6b7a752e696f2f767072652f496c32437070496e7465726f702e4861726d6f6e79537570706f72743f666565643d6e756765742e626570696e65782e6465762f76332f696e6465782e6a736f6e)](https://nuget.bepinex.dev/packages/Il2CppInterop.HarmonySupport) | *** > **BepInEx fork of Il2CppAssemblyUnhollower is now Il2CppInterop!** > > Looking for old README and guides? Check out [`legacy-unhollower` branch](https://github.com/BepInEx/Il2CppInterop/tree/legacy-unhollower). Il2CppInterop is a framework for bridging together Unity's Il2Cpp and .NET's CoreCLR runtimes. The framework various interoperability tools: * A tool to generate .NET assemblies from [Cpp2IL](https://github.com/SamboyCoding/Cpp2IL)'s output. * A runtime library to work with Il2Cpp objects in CoreCLR. * Libraries to integrate other tools with Il2Cpp. The framework allows the use of Il2Cpp domain and objects in it from a managed .NET domain. This includes generic types and methods, arrays, and new object creation. This project started out as fork of [knah/Il2CppAssemblyUnhollower](https://github.com/knah/Il2CppAssemblyUnhollower) but has been since been modified with new API and fixes to be a standalone project. ## Getting started For plugin developers: * [Class injection](https://github.com/BepInEx/Il2CppInterop/blob/master/Documentation/Class-Injection.md) * [Implementing interfaces](https://github.com/BepInEx/Il2CppInterop/blob/master/Documentation/Implementing-Interfaces.md) * [Components and AssetBundles](https://github.com/BepInEx/Il2CppInterop/blob/master/Documentation/Injected-Components-In-Asset-Bundles.md) For tool integrators and advanced user: * [Using the command line tool](https://github.com/BepInEx/Il2CppInterop/blob/master/Documentation/Command-Line-Usage.md) * [Generating assemblies and bootstrapping runtime](https://github.com/BepInEx/Il2CppInterop/blob/master/Documentation/Integration-API.md) ## Used libraries Bundled into output files: * [iced](https://github.com/0xd4d/iced) by 0xd4d, an x86 disassembler used for xref scanning and possibly more in the future Used by generator itself: * [Mono.Cecil](https://github.com/jbevain/cecil) by jbevain, the main tool to produce assemblies