Harmony 2.3.6

Oops in v2.3.5

• #633 fixes a binary compatibility issue present in 2.3.5 so if you have problems with 2.3.5 this release will fix them. Sorry for the inconvenience!

What's Changed

• MethodDelegate now allows for swapping value type with object, and allow ref for arg 0 on value type #633
• Add CodeMatcher.InsertAfter and improve exception handling 919f138
• Use the proper instruction for TypeCode.DateTime and TypeCode.Decimal 7e18ac1
• Remove leftover debugger log #653
• Allow OpCodes.Ldstr in LoadsConstant #656
• Fix bug in handling __args argument with out bool parameters #657 #659 #660
• Add Test Case for #657 #658
• Improve performance of AccessTools.TypeByName() a390e14
• Add AccessTools.TypeSearch() a390e14

New Contributors

• @samuelmasse made their first contribution in #653
• @SoundOfScooting made their first contribution in #656
• @xADDBx made their first contribution in #657

Harmony 2.3.5

Fixes a regression/oversight in 2.3.4 that makes System.Text.Json 9.0.1 a dependency on all .NET versions

Harmony 2.3.4

What's New

• supports .NET 9
• API landing page in the docs

What's Changed

• updates to MonoMod.Core v1.2.3
• updated version of ILRepack
• updated readme with more game references
• fixes Codes shortcuts, applies HarmonyArgument before special name lookup e8b4857
• documentation fixes (incl. a CodeMatcher example by @warquys)
• bumped dependency versions
• handle using object in place of value type, and vice versa e04f564
• fixe NRE #639
• allows empty string for targeting special MethodType options and doesn't try searching for it with AccessTools 0b13d7b
• adds a test for #640
• net9 locking in FileLog 57ed506
• handle constant/static readonly fields in MakeDeepCopy #619
• fixed wrong cache call in CallClosure() 22959ce
• prevents infinite loop in CodeMatcher when using MatchStartBackwards/Repeat #647

Known unsolved issues

• methods returning bool? cannot be patched correctly (disabled test 81aa26a)

Harmony 2.3.3

What's Changed

• adds UnpatchCategory() 395749f
• fixes HarmonyPriority bug with inherited values 395749f

Harmony 2.3.2

What's Changed

• Fix/get method from stackframe by @pardeike in #601

Harmony 2.3.1.1

This releases fixes a regression for .Net Standard projects

Harmony 2.3.1

v2.3.1 fixes:

• Dependency problem / duplicate type errors that we introduced with v2.3
• Better dead code handling #584
• new Lib.Harmony.Ref for projects targeting .NET Standard 2.0

Harmony Thin 2.3.0.1

This update updates Harmony Thin only and makes the dependency on MonoMod.Core public so it is included in transitive dependencies. No other changes.

Harmony 2.3

We have been preparing and testing this for months and I want to specially mention the the help of our HUGE community on this release. Harmony is downloaded over 800 times a day and has over 1.6 million downloads on Nuget and a Discord server with over 2100 members.

New core engine
Harmony 2.3 now uses MonoMod.Core v1.1 (part of https://github.com/MonoMod) which is a rewrite of the low level back-end for patching .NET methods.

Support for newer .NET versions
.NET 7 and .NET 8 support is finally here

Tests via GitHub Actions
Harmony is now tested on Azure and GitHub and thus we can start testing macOS and other fancy combinations: https://github.com/pardeike/Harmony/actions/workflows/test.yml

Fat and Thin versions
Harmony is now released in two packages on nuget: Lib.Harmony and Lib.Harmony.Thin. The thin version does not embed dependencies and thus allows you to manage them yourself. The normal version embeds them as internal types and works as usual as a standalone dll.
https://www.nuget.org/packages/Lib.Harmony
https://www.nuget.org/packages/Lib.Harmony.Thin

Changes

• Support GenericInstance types in inline method signatures 1960f57
• adds better detection for methods that end in dead code 7b5158a
• Merge pull request #565 from Zetrith 03b6426
• Error in exported Godot Engine build when attempting to patch method #562
• Regression with methods ending in throw + ret e63e183
• fixes a bug where Harmony calls TargetMethods() always twice 7ab508c
• Native async patching is not available in .NET Standard or .NET #533
• adds IEnumerable.Matches() b9206db
• Uses PlatformTriple.Current.GetIdentifiable for a user submitted MethodInfo
• fixes more unix tests
• patches Assembly.GetExecutingAssembly internally
• Improves http_client tests cda2226
• adds useful linux test shortcut c2586e7
• adds null/zero return clarifcations for TargetMethod/s #544
• fixes CodeMatch(()=>... 7e4183e
• Documentation Auxiliary Methods - Attribute spelling issue. Plus logic fix. #557
• adds InnerTypes() and extensions for AccessTool methods on type Type d916a30
• code cleanup, net8.0, optional ret code for methods ending in throw

• Methods for getting indices and making loads and stores by @LoganDark in #500
• Add an example for patch factory methods by @Meigyoku-Thmn in #502
• Add Categories feature to Patch Container Classes by @rrazgriz in #498
• yet another injector by @StackOverflowExcept1on in #512
• Adds support for targeting an async method's internal MoveNext method by @Banane9 in #514
• Add targeting of indexer properties by @Banane9 in #519
• Add Delegate overloads and implicit casts to HarmonyMethod; Fixes #505 by @Banane9 in #521
• Added netstandard2.0 reference assemblies support by @Aragas in #523

Additions

• adds Mono.Cecil.ByReferenceType, Mono.Cecil.GenericInstanceMethod, Mono.Cecil.GenericInstanceType, Mono.Cecil.TypeSpecification and Mono.Cecil.Cil.OpCodes to ForwardingAttributes
• You can now patch methods like ref SomeType Test() by using ref RefResult<SomeType> __resultRef

Huge THANK YOU to all contributors (a lot of them new):

• @LoganDark - #500
• @Meigyoku-Thmn - #502
• @rrazgriz - #498
• @StackOverflowExcept1on - #512
• @SineSwiper - #544
• @ZXfkSIE - #548
• @erdelf - #557
• @jivanf - #560
• @Zetrith - #565
• @kohanis - #582

SPECIAL THANKS

• @Aragas who added 10 PR's in various areas
• @Banane9 for their 3 PR's

Full Changelog

v2.2.2.0...v2.3.0.0

Harmony 2.3-prerelease.7

This release is just like prerelease.6 but build with the new thin/fat mechanics.
No new features or fixes were added.