Il2CppInterop.HarmonySupport 1.2.0

Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet add package Il2CppInterop.HarmonySupport --version 1.2.0                
NuGet\Install-Package Il2CppInterop.HarmonySupport -Version 1.2.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Il2CppInterop.HarmonySupport" Version="1.2.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Il2CppInterop.HarmonySupport --version 1.2.0                
#r "nuget: Il2CppInterop.HarmonySupport, 1.2.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Il2CppInterop.HarmonySupport as a Cake Addin
#addin nuget:?package=Il2CppInterop.HarmonySupport&version=1.2.0

// Install Il2CppInterop.HarmonySupport as a Cake Tool
#tool nuget:?package=Il2CppInterop.HarmonySupport&version=1.2.0                

<p align="center"> <img src="logo/logo_big.svg" width="300"> </p>

GitHub Workflow Status GitHub release (latest by date)

CLI Generator Runtime HarmonySupport
NuGet.org (release) BepInEx NuGet (CLI) BepInEx NuGet (Generator) BepInEx NuGet (Runtime) BepInEx NuGet (HarmonySupport )
nuget.bepinex.dev (CI) BepInEx NuGet (CLI) BepInEx NuGet (Generator) BepInEx NuGet (Runtime) BepInEx NuGet (HarmonySupport)

BepInEx fork of Il2CppAssemblyUnhollower is now Il2CppInterop!

Looking for old README and guides? Check out legacy-unhollower branch.

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'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 but has been since been modified with new API and fixes to be a standalone project.

Getting started

For plugin developers:

For tool integrators and advanced user:

Used libraries

Bundled into output files:

  • iced by 0xd4d, an x86 disassembler used for xref scanning and possibly more in the future

Used by generator itself:

  • Mono.Cecil by jbevain, the main tool to produce assemblies
Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Il2CppInterop.HarmonySupport:

Package Downloads
NextBepLoader.Core.IL2CPP

BepInEx support library for Il2Cpp games

GitHub repositories (2)

Showing the top 2 popular GitHub repositories that depend on Il2CppInterop.HarmonySupport:

Repository Stars
BepInEx/BepInEx
Unity / XNA game patcher and plugin framework
LavaGang/MelonLoader
The World's First Universal Mod Loader for Unity Games compatible with both Il2Cpp and Mono
Version Downloads Last updated
1.4.5 4,250 3/4/2023
1.4.4 532 2/25/2023
1.4.3 715 12/13/2022
1.4.2 290 12/12/2022
1.4.1 2,048 12/11/2022
1.4.0 848 11/13/2022
1.3.0 3,861 10/21/2022
1.2.0 577 10/4/2022
1.1.4 431 9/30/2022
1.1.3 505 9/10/2022
1.1.2 408 9/8/2022
1.1.1 483 8/29/2022
1.1.0 748 7/10/2022