Fix bug on macOS by sptndc · Pull Request #272 · BepInEx/Il2CppInterop

sptndc · 2026-06-21T18:36:03Z

Problem

XrefScans.XrefScanMethodDb and InjectorHelpers.Il2CppModule use Process.Modules and ProcessModule which are very limited or return incomplete data on macOS.

Furthermore, InjectorHelpers.Il2CppHandle uses NativeLibrary.Load like this:

NativeLibrary.Load("GameAssembly", typeof(InjectorHelpers).Assembly, null);

The .NET runtime automatically prefixes lib and will throw a DllNotFoundException.

Change

Use the native C functions dlopen, dlsym, and dladdr using C# P/Invoke for macOS to get the actual base address and calculate the memory size of a module. Replace the MemoryUtils.FindSignatureInModule method with the MemoryUtils.FindSignatureInBlock method, which takes three parameters: nint, long, and SignatureDefinition.
Provide the full file path to NativeLibrary.Load, so the .NET runtime will interpret it exactly as it is and skip the prefixing logic.

# Conflicts: # Il2CppInterop.Runtime/Injection/InjectorHelpers.cs

…ns.Logging for all logging

Using 6.0.0.0 is wrong because it is not a valid mscorlib version. In .NET 5 an higher, mscorlib version is locked to 4.0.0.0

… env var

…tions

# Conflicts: # Directory.Build.props # Il2CppInterop.Runtime/Injection/InjectorHelpers.cs # UnhollowerBaseLib/Il2CppException.cs # UnhollowerBaseLib/Runtime/VersionSpecific/Class/Class_24_4.cs # UnhollowerBaseLib/Runtime/VersionSpecific/Class/Class_27_0.cs # UnhollowerBaseLib/Runtime/VersionSpecific/Class/Class_27_1.cs # UnhollowerBaseLib/Runtime/VersionSpecific/Class/Class_27_2.cs # UnhollowerBaseLib/Runtime/VersionSpecific/Class/Class_27_3.cs # UnhollowerBaseLib/Runtime/VersionSpecific/Class/Class_29_0.cs # UnhollowerBaseLib/Runtime/VersionSpecific/Class/Class_29_1.cs # UnhollowerBaseLib/Runtime/VersionSpecific/Image/Image_27_0.cs # UnhollowerBaseLib/Runtime/VersionSpecific/ParameterInfo/ParameterInfo_16_0.cs # UnhollowerBaseLib/Runtime/VersionSpecific/ParameterInfo/ParameterInfo_24_1.cs # UnhollowerBaseLib/Runtime/VersionSpecific/ParameterInfo/ParameterInfo_27_3.cs

Major refactor, rename project to Il2CppInterop

* implement IL Hook in Il2CppDetourMethodPatcher to skip managed->native->managed * update to use detour instead of il hook

…od. (BepInEx#233) * Added better support for nested classes in GetIl2CppTypeFullName method. * Switched from a list to a stack. No more need to reverse the list. * Only add a . when namespacename exists. --------- Co-authored-by: SlideDrum <slidedrumofficial@gmail.com>

Based on: ds5678@9d09abe More info: BepInEx#244

Il2CppInterop and Il2CppAssemblyUnhollower have always been LGPLv3, simply using the split GPL+LGPL license files. Use the combined license text to avoid confusion.

* Separated Il2CppInterop.Generator * Fix formatting issues --------- Co-authored-by: cetotos <cetotospatatos@gmail.com>

…pInEx#255) * Separated Il2CppInterop.Runtime * Update Il2CppInterop.Runtime/Injection/Hooks/GenericMethod_GetMethod_Unity6_Hook.cs remove comments Co-authored-by: Jeremy Pritts <49847914+ds5678@users.noreply.github.com> * Update Il2CppInterop.Runtime/Injection/InjectorHelpers.cs change unity 6 hook name Co-authored-by: Jeremy Pritts <49847914+ds5678@users.noreply.github.com> * Update Il2CppInterop.Runtime/Injection/InjectorHelpers.cs change unity 6 hook name Co-authored-by: Jeremy Pritts <49847914+ds5678@users.noreply.github.com> * Revise comment Honestly, I don't remember removing it anyways --------- Co-authored-by: cetotos <cetotospatatos@gmail.com> Co-authored-by: Jeremy Pritts <49847914+ds5678@users.noreply.github.com>

* Unity 6 alignment issue fix for linux * Fix the Dotnet Formatting issues * fixup: forgot to add trace log line

* fix: preserve Nullable<T> data in Harmony patches * style: narrow Nullable check and normalize CopyMemory signature per review

…ect call for reference value type parameter (BepInEx#243)

…x#237)" This reverts commit 350df19. The patch breaks the managed method body when CopyOriginal called on detoured Original method body, as CopyOriginal expect to operate on unmodified Original method body. This essentially breaks applying more than one Harmony patches on a same hooking target.

…ltValue-signature', 'fix-HarmonySupport-ref-valuetype' and 'revert-implement-managed-detour' into illgames-fixes

…x#268)

Various fixes for issues with some Illgames games Co-authored-by: y0soro <y0soro@protonmail.com>

This fixes an issue where `GameAssembly.dylib` was not loaded for IL2CPP games on macOS.

ds5678 · 2026-06-21T19:41:55Z

Process.Modules and ProcessModule which are very limited or return incomplete data on macOS.

Is this true on .NET 10?

sptndc · 2026-06-21T20:36:37Z

Process.Modules and ProcessModule which are very limited or return incomplete data on macOS.

Is this true on .NET 10?

These APIs are architected around Windows-specific memory models. While .NET 10 offers robust macOS support, the operating system's strict user-space security policies—specifically Hardened Runtime and System Integrity Protection (SIP)—prohibit arbitrary process memory traversal for module enumeration.

ghorsington and others added 30 commits May 23, 2022 22:23

Merge branch 'wip-rebrand-standalone-generator' into rebrand

da05380

# Conflicts: # Il2CppInterop.Runtime/Injection/InjectorHelpers.cs

Fix after merge

0a44ff1

Remove unneeded AssemblyInfo

786c782

Add editorconfig; reformat

dc0d67e

Fix size_t offsets for x86 (synced from rebrand)

25037f4

Bump version

f16af56

Remove unused il2cpp stubs

4831ff5

Rewrite IL2CPP Exception StackTrace (BepInEx#36)

8b0f6d9

Bump version

766a718

Remove MINI and NET_6_0 preprocessor directives

272b007

Remove new file header

5aa3cf1

Refactor initializer into host runner pattern, use Microsoft.Extensio…

5103749

…ns.Logging for all logging

Fix ClangSharp reference

957adf2

Rewrite mscorlib to 4.0.0.0

0eb9d6e

Using 6.0.0.0 is wrong because it is not a valid mscorlib version. In .NET 5 an higher, mscorlib version is locked to 4.0.0.0

Fix LogError visibility

25a59a5

Replace GeneratedDatabasesUtil with IL2CPP_INTEROP_DATABASES_LOCATION…

0727e26

… env var

Update NuGet version

6305fb7

Add custom detour provider; add provider option to runtime startup op…

e334e79

…tions

Add Harmony support module

aba0a4f

Stub MethodGetFromReflection for 2018.1.0 & older

b4f75b0

Make import private

609a326

CLI: Add initial implementation for deobf map commands

b488999

Improve xref

8f3fd78

Move delegate workaround to detour impl

dd53cda

Merge remote-tracking branch 'origin/rebrand' into rebrand

955a83e

Port Il2CppException stack trace fix

1b9173a

Update initial documentation, update README

c32d8b1

Merge pull request BepInEx#35 from BepInEx/rebrand

6c65642

Major refactor, rename project to Il2CppInterop

Update version

98d1c07

ManlyMarco and others added 21 commits September 2, 2025 08:58

Bump version

87a4fef

Implement Managed Detour in Il2CppDetourMethodPatcher (BepInEx#237)

350df19

* implement IL Hook in Il2CppDetourMethodPatcher to skip managed->native->managed * update to use detour instead of il hook

Remove GarbageCollector_RunFinalizer_Patch (BepInEx#247)

c78947a

Based on: ds5678@9d09abe More info: BepInEx#244

[skip ci] Clarify license

f459429

Il2CppInterop and Il2CppAssemblyUnhollower have always been LGPLv3, simply using the split GPL+LGPL license files. Use the combined license text to avoid confusion.

Update Il2CppInterop.Generator to beta.5 for Cpp2IL (BepInEx#254)

5da607e

* Separated Il2CppInterop.Generator * Fix formatting issues --------- Co-authored-by: cetotos <cetotospatatos@gmail.com>

Fix DelegateSupport return type conversions (BepInEx#256)

ef34cf0

Fix Unity 6 alignment issue for Linux (BepInEx#257)

39adac7

* Unity 6 alignment issue fix for linux * Fix the Dotnet Formatting issues * fixup: forgot to add trace log line

Fix: preserve Nullable<T> data in Harmony patches (BepInEx#259)

1d75335

* fix: preserve Nullable<T> data in Harmony patches * style: narrow Nullable check and normalize CopyMemory signature per review

Add call to IL2CPP_il2cpp_object_unbox in ILGeneratorEx to fix incorr…

c26a42e

…ect call for reference value type parameter (BepInEx#243)

Add minimal ref ValueType type conversion into HarmonySupport

09da4f2

Fix Class::GetFieldDefaultValue signature for DigitalCraft 3.1.2

6df0cf7

Fix ref NonBlittableStruct IL generation

fb70fc4

Merge branches 'fix-ref-NonBlittableStruct-IL', 'fix-dc-GetFieldDefau…

b82611e

…ltValue-signature', 'fix-HarmonySupport-ref-valuetype' and 'revert-implement-managed-detour' into illgames-fixes

Bump version

3d5d04f

Match the IL2CPP game assembly module name case-insensitively (BepInE…

3e285b0

…x#268)

Merge pull request BepInEx#271 from y0soro/illgames-fixes

128aaf5

Various fixes for issues with some Illgames games Co-authored-by: y0soro <y0soro@protonmail.com>

Bump version

994fffa

Fix bug on macOS

88c1f91

This fixes an issue where `GameAssembly.dylib` was not loaded for IL2CPP games on macOS.

ds5678 requested changes Jun 21, 2026

View reviewed changes

Comment thread Il2CppInterop.Common/XrefScans/XrefScanMethodDb.cs Outdated

Comment thread Il2CppInterop.Runtime/Injection/InjectorHelpers.cs Outdated

Comment thread Il2CppInterop.Runtime/Injection/InjectorHelpers.cs Outdated

Comment thread Il2CppInterop.Runtime/Injection/InjectorHelpers.cs

Fix GameAssembly base address and memory size on macOS

366f359

sptndc closed this Jun 24, 2026

sptndc force-pushed the patch-1 branch from e9f7724 to 366f359 Compare June 24, 2026 13:46

sptndc deleted the patch-1 branch June 24, 2026 13:50

sptndc restored the patch-1 branch June 24, 2026 14:46

sptndc mentioned this pull request Jun 24, 2026

Fix bug on macOS #273

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Fix bug on macOS#272

Fix bug on macOS#272
sptndc wants to merge 767 commits into
BepInEx:masterfrom
sptndc:patch-1

sptndc commented Jun 21, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ds5678 commented Jun 21, 2026

Uh oh!

sptndc commented Jun 21, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

20 participants

Uh oh!

Conversation

sptndc commented Jun 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Problem

Change

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ds5678 commented Jun 21, 2026

Uh oh!

sptndc commented Jun 21, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

20 participants

sptndc commented Jun 21, 2026 •

edited

Loading