1550 Commits
Author SHA1 Message Date
Chris Dobbyn dbc82f05b8 v6: Fix plugin loading on native arm64 macOS (#1405)
* fix(macos): load plugins when the game runs as native arm64

This is the v6 port of #1402, which fixed the same failure on v5-lts.

MonoMod picks DetourNativeMonoPosixPlatform on Mono, whose MakeWritable and
MakeExecutable call mprotect with PROT_READ|PROT_WRITE|PROT_EXEC. macOS on
Apple Silicon answers EACCES, because a process without the
com.apple.security.cs.allow-unsigned-executable-memory entitlement can never
hold a page that is writable and executable at once. Unity ships
com.apple.security.cs.allow-jit instead, so Mono's code lives in a MAP_JIT
region, which also rejects mach_vm_write with KERN_INVALID_ADDRESS.

The EACCES escapes DetourRuntimeILPlatform's constructor, which runs inside
DetourHelper.Runtime's initialiser after _RuntimeInit is already set, so every
later read of DetourHelper.Runtime returns null and every Harmony patch dies on
a NullReferenceException in DetourHelper.GetIdentifiable. On v6 the first
casualty is ConsoleSetOutFix.Apply, which is not wrapped in Utility.TryDo, so
the whole preloader dies before it opens LogOutput.log. The only trace is a
preloader_*.log beside the executable.

v6 reaches this more easily than v5 does: run_bepinex_mono.sh sets
ARCHPREFERENCE="arm64,x86_64" unconditionally on Apple Silicon, so a universal
game runs as native arm64 by default and no opt-in is needed to hit the bug.

AppleSiliconDetourFix installs a detour platform that keeps
DetourNativeARMPlatform's AArch64 encoding and routes every code write through
doorstop_jit_memcpy, which toggles pthread_jit_write_protect_np around its own
memcpy. The toggle cannot be done from managed code: it drops execute
permission for the calling thread, and the caller is itself running
JIT-compiled code.

XTermFix forced DetourNativeX86Platform on every non-Windows target. On Apple
Silicon that encoded x86 branches into arm64 method bodies and reinstated the
failing mprotect, so it is now skipped when the new fix applies. XTermFix also
cleared DetourHelper.Native back to null on the way out, which would discard
the platform installed here, so it now restores what it found.

doorstop_jit_memcpy landed in UnityDoorstop via NeighTools/UnityDoorstop#114
and is not in the pinned 4.5.0 release. Until DoorstopVersion is bumped, this
fix reports its absence as a warning through the preloader instead of failing
silently, which is what happens today.

Verified on an M4 Pro against Valheim 6000.0.75f1 (Unity Mono), with a probe
plugin that Harmony-patches an already-JIT-compiled method:

  arm64,   unpatched build: preloader dies, no LogOutput.log
  arm64,   this build:      plugin loads, Harmony patch applies
  x86_64,  this build:      plugin loads, Harmony patch applies

* Move AppleSiliconDetourFix to BepInEx.Preloader.Core

The IL2CPP preloader needs the same class, so keep one copy where both
preloaders already reference it rather than a copy per runtime.

* Cut the comments back to one line each
2026-11-05 19:50:19 +01:00
3448ef75c2 Log Unity stack traces on IL2CPP (#1424)
UnityLogCallback ignored its second parameter, so Unity exceptions and
errors logged only their message. Append the trace for Exception and Error
when Unity gives one. The Mono source already does this for Exception. Log
and Warning stay as they are, since in the game I tested Unity passed a
trace for most of those.

Fixes #660

Co-authored-by: mirfalltnixein <22786734+mirfalltnixein@users.noreply.github.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 19:33:09 +01:00
b782da4ac5 Mark run_bepinex.sh as executable in the Linux and macOS zips (#1420)
Cake's Zip creates each entry with ZipArchive.CreateEntry and copies the
bytes, so file modes on disk are never recorded and every file ends up as
0644. run_bepinex.sh therefore isn't executable after extracting, and users
have to chmod +x it before ./run_bepinex.sh %command% works. Set its mode
to 0755 after packing.

Co-authored-by: mirfalltnixein <22786734+mirfalltnixein@users.noreply.github.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-23 15:04:53 +02:00
Arrowmaster 4e98359b51 Upgrade UnityDoorstop to version 4.6.0 (#1418) 2026-10-20 20:51:05 +02:00
MenShiyun 6cea286d20 Fix GameDataPath exception in non-Unity3D games (#1416)
When `GameDataPath` is invalid, do not throw an exception; instead, set
both `GameDataPath` and `ManagedPath` to `null`.
2026-10-16 12:41:59 +02:00
Joshua TraverandCursor 5b766a3b7f Follow PE export jmp thunks before applying a native detour (#1387)
* Follow PE export jmp thunks before applying a native detour.

GetProcAddress of il2cpp_runtime_invoke can be a jmp rel32 stub. Dobby aborting on that stub is BepInEx#1188-class. Resolve E9 and FF 25 in INativeDetour.Create so Default/Dobby and Funchook all patch the prologue. No-op when the pointer is already a function body.

Co-authored-by: Cursor <cursoragent@cursor.com>

* Use IntPtr.Size when following FF 25 thunks.

nint.Size does not exist on the net6.0 BepInEx IL2CPP target.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-01 07:03:47 +02:00
Drew MochakandManlyMarco 7cb1246fcc Survive stripped UnityEngine.Application members during chainloader init (#1391)
Two related failures on aggressively stripped Unity Mono builds:

1. InitializeLoggers reads Application.unityVersion, which the managed
   code stripper can remove. The version is only used for an
   informational log line, but a MissingMethodException there aborts the
   rest of chainloader initialisation. Read it defensively instead.

2. UnityChainloader.Initialize caught every exception, logged it as
   Fatal, and returned normally. StaticStart then called Execute() on a
   chainloader that was never initialised, so BepInEx logged
   "Chainloader startup complete" while every plugin silently never ran.
   Rethrow so a failed init cannot be mistaken for a successful one.

Verified on Beacon Pines (Unity 2021.3.45f1, Mono, x64), which strips
both Application.unityVersion and the log-callback members.

Co-authored-by: ManlyMarco <39247311+ManlyMarco@users.noreply.github.com>
2026-09-01 06:58:43 +02:00
Drew Mochak 6d82b2e5fc Don't kill the chainloader when Unity log callbacks are stripped (#1389)
UnityLogSource's static constructor falls back to
Application.RegisterLogCallback when Application.logMessageReceived is
absent. Unity's managed code stripper can remove both, in which case
GetMethod returns null and the unguarded Invoke throws a
NullReferenceException out of the static constructor.

That exception propagates through chainloader initialisation, so the
chainloader never starts and no plugins load. The failure is close to
undiagnosable: LogOutput.log ends at "Preloader finished" with no error,
and the exception only appears on stdout.

Unity log forwarding is optional, so warn and continue instead of taking
the whole loader down.

Seen on Beacon Pines (Unity 2021.3.45f1, Mono), whose
UnityEngine.Application has neither member.
2026-09-01 06:56:05 +02:00
ManlyMarco 6abdba47ee Revert Cpp2IL back to development.1452 because of regressions 2026-06-28 18:07:00 +02:00
ManlyMarco 0523d6f4e9 Downgrade Samboy063.Cpp2IL.Core to 2022.1.0-pre-release.20
Version 21 includes a reference to Disarm version 99 which results in builds to fail unless author's custom nuget feed is referenced.

Details: https://github.com/SamboyCoding/Disarm/issues/45
2026-06-24 15:26:40 +02:00
ManlyMarco c58c42dc60 build_pr.yml - Also run on v5-lts branch 2026-06-21 19:40:08 +02:00
ManlyMarco ac4f64a404 comment_pr.yml - Fix not working on PRs from forks 2026-06-21 19:30:18 +02:00
ManlyMarco 80dde081fd Bump Cpp2IL to 2022.1.0.21 and AssetRipper.Primitives to 3.2.0 (#1362) 2026-06-21 19:05:18 +02:00
ManlyMarco 0643c2bceb Bump Il2CppInterop to 1.5.3 (#1361) 2026-06-21 12:49:28 +02:00
ManlyMarco 4aab2920fc Make UnityInput and KeyboardShortcut available in IL2CPP (#998) 2026-06-21 12:22:08 +02:00
HetCreep 4a879f582c Hash the full UTF-8 byte length in HashStrings (#1355)
HashStrings passed str.Length (a char count) as the byte count to
MD5.TransformBlock, so for any non-ASCII string only a truncated prefix
of the UTF-8 bytes was hashed. Capture the byte array and use its Length.
2026-06-21 12:20:41 +02:00
HetCreep fb5f191b36 Enumerate a config snapshot under the lock (#1357)
ConfigFile documents its public methods as thread-safe, but GetEnumerator
returned the live Dictionary enumerator with no lock, so a concurrent
Bind/Reload could invalidate it mid-foreach. Snapshot under _ioLock instead.
2026-06-21 12:13:51 +02:00
HetCreep 32fb12f2e9 Remove the duplicate byte TomlTypeConverter registration (#1359)
typeof(byte) was registered twice in the TypeConverters initializer; the
second entry silently overwrote the first. Keep the one grouped with the
other integral types.
2026-06-21 12:10:28 +02:00
HetCreep 5f39645992 Allow multiple [TargetType] and [TargetAssembly] attributes (#1343)
Patch-method discovery already reads both with the plural
MetadataHelper.GetAttributes<T>(), and the docs say additional target
attributes can be specified, but the attributes lacked
AllowMultiple = true, so the compiler rejected a second one (CS0579).
Set AllowMultiple = true on both.
2026-06-11 14:52:43 +02:00
HetCreep da64b220eb Do not abort startup when the config file cannot be written (#1340)
* Don't abort startup when the config file can't be written

ConfigFile.Save opens the file for writing with no exception handling and is invoked automatically via SaveOnConfigSet while settings are bound during startup, before logging is initialized. A read-only or otherwise unwritable config file (a read-only install directory, a file locked by another process or antivirus) therefore throws UnauthorizedAccessException out of the early startup path and shows the Failed to start BepInEx dialog.
2026-06-11 14:49:59 +02:00
js6pak bd467c9af6 Expose a DisplayBepInExVersion (#556) 2026-06-11 12:25:33 +02:00
HetCreep a06688e85b Degrade instead of crashing when the IL2CPP interop assemblies are missing (#1338)
* Degrade instead of crashing when the interop assemblies are missing

OnInvokeMethod references interop types (UnityEngine.Application/LogType) in its body. The CLR JIT-compiles the whole method before running any of it, so when the interop assemblies cannot be resolved the method throws FileNotFoundException at JIT time -- before its own try is entered -- and the exception escapes into the native runtime-invoke detour and crashes the process with nothing logged.

Move the interop-referencing call into its own SetupUnityLogging method called inside the try. OnInvokeMethod then JITs without the interop assemblies present, the missing-interop failure is caught, and the loader degrades (logs and continues) so the game runs unmodded. Set unhook at the top of the try so the detour fires exactly once even on failure.

* Condense the interop-degrade comments and reword the fatal log

Per review: trim the JIT-bypass comments to one line each and change
the fatal message to "Unable to execute IL2CPP chainloader, no plugins
will be loaded".
2026-06-11 11:54:22 +02:00
HetCreep a1afbfb169 Skip missing search directories to fix preloader DirectoryNotFoundException (#1331) 2026-06-11 11:46:18 +02:00
はやしうめ 9aedb90fc6 Set the console codepage to ensure correct text display regardless of encoding (#1337) 2026-06-09 17:07:44 +02:00
HetCreep f568f0e7b5 Fix misleading error label for Finished handlers (#1329)
BaseChainloader.Execute invoked the Finished event inside the same
try/catch that reports plugin-loading failures, so an exception thrown
by a Finished event listener was logged as "Error occurred loading
plugins:" even though it was unrelated to plugin loading.

Move Finished?.Invoke() into its own try/catch with an accurate
message. Control flow is otherwise unchanged: Finished still runs only
after LoadPlugins succeeds, a throwing listener is still caught, and
"Chainloader startup complete" is still logged afterwards.

Fixes #842
2026-06-08 14:49:39 +02:00
HetCreep 77d438cf69 Clarify BepInDependency version errors and docs (#1330)
The chainloader collected both not-installed dependencies and
installed-but-incompatible-version dependencies into one list and
reported them all as "missing dependencies", which is confusing when
the plugin is present but on a version outside the requested range.

Separate the two cases and log distinct, actionable messages: one for
dependencies that are not installed, and one for dependencies present
with an incompatible version (showing the found version and the
required range).

Also expand the BepInDependency(string, string) xmldoc: the version is
a SemVer range, link the range syntax, and warn about the BepInEx 5 ->
6 behaviour change (a bare version was a minimum, now it is exact).

Fixes #779
2026-06-08 14:48:55 +02:00
HetCreep f8ba0a41af Give actionable error when base-libs download fails (#1332)
When the Unity base-libraries download fails (commonly a 404 for a
Unity version not yet hosted on unity.bepinex.dev), the uncaught
HttpRequestException surfaced only as a cryptic "Failed to generate
Il2Cpp interop assemblies" and the game would not launch -- even
though a local fallback (the unity-libs directory) already exists.

Catch the download failure and throw a clear message naming the Unity
version, the URL and the two workarounds: place a matching
base-libraries .zip in the unity-libs directory, or point the
[IL2CPP] UnityBaseLibrariesSource config at a valid URL.

Refs #1295, #1084, #986, #941, #515
2026-06-08 14:36:17 +02:00
tobey 3fab71a191 Improved support for IL2CPP metadata v23-106 (Unity 6+) (#1284)
chore(deps): update Cpp2IL and Il2CppInterop
2026-03-07 14:10:33 +01:00
Arrowmaster c0386134c6 Upgrade Doorstop to version 4.5.0 (#1260) 2026-02-24 17:05:40 +01:00
The0x539 0d275a4df3 Avoid accidentally (indirectly) reading PlatformHelper.Current before setting it (#1254) 2026-01-27 15:26:39 +01:00
ManlyMarco dd0655fe9d Cache downloaded base libraries in the unity-libs directory (#1213) 2025-11-16 19:49:19 +01:00
ManlyMarco 88b4838fef Fix assembly preloading overriding preloader patches (#1212) 2025-11-14 12:23:18 +01:00
ManlyMarco af0cba71fb v6 - Bump Il2CppInterop to 1.5.0-ci.620 (#1106) 2025-06-21 02:59:18 +02:00
ManlyMarco 5fef3570f2 Bump Cpp2IL to pre-release.19 (#1103) 2025-05-09 19:09:55 +02:00
js6pak 995f04991b Fix CI webhook 2025-01-12 17:13:13 +01:00
ManlyMarco 0c2a3f13c3 Switch Build.csproj TargetFramework to net8.0 (#1039)
Fixes CI broken by net6.0 being deprecated.
2025-01-12 16:25:43 +01:00
Howard Lam 28559fe708 Checks if target Unity binaries archive exists before attempting download in case game's network conenction is blocked (#1024) 2025-01-11 22:51:47 +01:00
itectori 35f6b1b541 include DeobfuscationMap.csv.gz in ComputeHash (#1020) 2024-12-02 19:48:56 +01:00
ManlyMarco e1974e26fd Use joelwmale/webhook-action@2.4.1 2024-09-24 20:44:45 +02:00
ManlyMarco e2d5ab8ebc Clean up empty files 2024-09-24 20:32:25 +02:00
aldelaro5 544f909a80 Revert "Merge pull request #960 from aldelaro5/metaplugins" (#995)
This reverts commit 2a61b61497, reversing
changes made to 6b38cee127.
2024-09-24 20:25:56 +02:00
aldelaro5andManlyMarco d9b95a0ac7 Add input abstraction layer to support games with the Input class disabled
Originally pull request #444

Co-authored-by: ManlyMarco <39247311+manlymarco@users.noreply.github.com>
2024-09-17 18:50:35 +02:00
aldelaro5andManlyMarco af5d93917c Make Logger.Listeners and Logger.Sources thread safe
Originally pull request #656

Co-authored-by: ManlyMarco <39247311+manlymarco@users.noreply.github.com>
2024-09-17 18:50:35 +02:00
aldelaro5andManlyMarco 8597ce7ebf Add TomlTypeConverter for UnityEngine.Rect
Originally pull request #510

Co-authored-by: ManlyMarco <39247311+manlymarco@users.noreply.github.com>
2024-09-17 18:50:35 +02:00
aldelaro5andghorsington 6e846fc70a Preload Harmony and MonoMod
Originally commit a1bb117c86

Co-authored-by: ghorsington <neigh@coder.horse>
2024-09-17 18:50:35 +02:00
aldelaro5andghorsington 92f7d25698 Print file write data in console
Originally commit 6c5766d5ab

Co-authored-by: ghorsington <neigh@coder.horse>
2024-09-17 18:50:35 +02:00
aldelaro5andghorsington a5b7dabc1d Add error when using *nix build with Windows executable
Originally commit 8c7dcf265c

Co-authored-by: ghorsington <neigh@coder.horse>
2024-09-17 18:50:35 +02:00
aldelaro5 b891cecab9 Upgrade the github workflows sdk to 8.0.x (#992) 2024-09-17 18:18:48 +02:00
aldelaro5 726b68e52b Prioritize the shallowest path for the same assembly name in the default providers (#980)
Change the behaviors of the default providers so if multiple assemblies with the same name exists, but in different directories, ignore any that are located deeper.
2024-09-10 14:48:48 +02:00
ManlyMarco cdeaad7868 Use upload-artifact@v4 (#981) 2024-09-10 14:47:22 +02:00