4.2.0

New Features

• Added button to open the github repo in settings

Tweaks

• Updated to .Net 10
• Updated harmony to 2.4.2

Fixes

• Ignore target locale casing to fix #37
• Fixed configKey.Value null reference exceptions by @NepuShiro in #39

Locale

• Updates to zh-tw.json by @medicalwei in #38

New Contributors

• @NepuShiro made their first contribution in #39

Other news

• https://github.com/resonite-modding-group/setup-resonite-env-action has been updated to setup .Net 10 and allow building against password protected branches such as the headless

Full Changelog: 4.1.0...4.2.0

4.1.0

New Features

• Loading embedded locale data with fallback #30
  • Fixes raw locale keys being shown in settings
• Added timing to config saving log
• Added additional logging around GetLoadableTypes to assist in some mods not being seen as loadable
• Added Repo link on the settings page (not currently clickable)

Fixes

• Removed type hiding as Resonites 'type update' covers all the cases it did.
  • This also resolves extra setting components being created #36
• Removed setting name overrides so they can be localized
• Removed Task IsCompletedSuccessfully Shim
• Removed a few cases of unnecessary variable creation and assignment
• Fix for some cases of empty config backups being created
• Fixed troubleshooting link in faq by @polyjitter in #31
• Various internal cleanup in docs and logging

Locale

• Added ja Locale by @kazu0617 in #35
• Added en and eo locale by @XDelta
• Added zh-tw by @medicalwei in #32

New Contributors

• @polyjitter made their first contribution in #31
• @medicalwei made their first contribution in #32
• @kazu0617 made their first contribution in #35

Thanks for the contributions!

Full Changelog: 4.0.0...4.1.0

4.0.0

The Splittening has occurred!

New Features

• ModLoader now uses UserspaceCore
• Initial start of using the built in settings for modloader settings.
• More docs
• Initialization Timing
• ConfigKeys can have Values more directly set/get with ConfigKeyName.Value

Tweaks

• Now on Net9 instead of net472
• Updated harmony to 2.4.0
• Changed execution hook and separated modloader init from it.
• Consolidated debugging info logged
• Internal optimizations using newer .Net features
• AssemblyFiles that fail to parse name or version will log 'Unknown'
• Additional exception handling for config files

Removed

• Unity References

Known Issues

• The settings page shows raw locale strings
• The current settings may act odd. haven't done extensive testing

Other news

• Issue templates added
• Github action to set up a resonite environment for building plugins and mods is available on the Actions Marketplace, Repo https://github.com/resonite-modding-group/setup-resonite-env-action

Full Changelog: 3.0.0...4.0.0

Net9 Pre-Release

Built for pre-release. This dll will be updated with fixes and changes from #24. Several mods will require being recompiled and may crash your game in the meantime. Additionally includes some extras from #27

Tested working with Beta 2025.8.18.670

3.0.0

New Features

• Added ToString() override for config keys
• Added Debug log at start of ExecutionHook

Tweaks

• Fixes for Type update to FrooxEngine by @BlueCyro in #12
  • Reworks the compatibility hash as now they are made per loaded DataModelAssembly
• Updated harmony to 2.3.3
  • Includes several improvements to targeting
• Added harmony 2.3.5 as 0Harmony-Net9.dll
  • Specifically for the Net9 Headless
• Removed Unsafe, HideModTypes, and HideLateTypes modloader config options as the type update should cover most to all of the use-cases for these
• Removed obsolete configuration handling option

Additional notes

• Some additional testing and cleanup is planned for the hiding of types related patches and configs

If you want to run ResoniteModLoader on the new .Net 9 headless build, you will need to use the 0Harmony-Net9.dll file instead of 0Harmony.dll.

2.6.0

New features

• Added headless property available to mods with Modloader.IsHeadless in #4 by @RileyGuy
• Added several additional Debug log messages for debugging the modloader itself
  • Includes listing launch args in logs

Tweaks

• Refactored out LoadedResoniteMod in #8 resolving #7 by @art0007i
• Fixed hash computation when other plugins are present fixing #3
• Fixed NullReferenceException on startup caused by IsValidGenericType being refactored to a new class #5
• Applied .Net recommended performance and visibility suggestions
• Removed unused 'nolibraries' config

Additional notes

• Several small improvements in comment clarity
• Cleaned up csproj to use more Sdk defaults instead of redefining them
• Started moving docs over to a Github Wiki
  • Should improve linking to and finding of pages in the documentation

2.5.1

Fixes

• Fixed headless unable to load files used for the loading indicator #2

2.5.0

New features

• New OnChanged event for ModConfigurationKey's
  ExampleConfigKey.OnChanged += (value) => { Msg($"Key set to {value}"); };
• Loading progress indicator on the splash screen to show the current status #1
  • Only shows modloader specific engine steps
  • Can be hidden with the hidevisuals Modloader config option

Tweaks

• TargetFramework is now net472
• Removed the headless build condition
  • A separate headless build is not currently needed
• Changed harmony id to com.resonitemodloader.ResoniteModLoader

Additional notes

• Marked IncompatibleConfigurationHandlingOption.FORCE_LOAD as obsolete, use FORCELOAD
• Added xml doc to release

Known issues

#2 On headless, you'll need to set the hidevisuals config

2.4.0

Initial public release of the ResoniteModLoader

• Updated to use LangVersion C# 10
  • Mainly for GlobalDirectives and File Scoped Namespaces
• Removed deprecated and obsolete methods
• Added some additional logging and error handling around config usage and loading
• Mod configs should now be formatted with indentation instead of long single line
• Updated docs are in progress

Additional notes

• Headless specific build may not be needed as Newtonsoft.Json has been updated and now matches on the client and headless