Skip to content

Releases: Reloaded-Project/Reloaded-II

1.29.1

30 May 16:01
Compare
Choose a tag to compare

Read and Discuss in a Browser.
Previous Changelog.

This is an emergency release to address crashes with .NET 9.0.5.
Please note this release lacks proper testing; as this is a very urgent/emergency release.

Emergency .NET 9.0.5 Rollback by @Sewer56

Microsoft rolled out .NET 9.0.5 with a change that causes crashes in all games when used with Reloaded-II.

I've made the following changes to address this:

  • Enforced .NET 9.0.4: Mod loader now requires .NET 9.0.4 and prevents booting with 9.0.5
  • Launcher still allows 9.0.5, but will prompt 9.0.4 installation for Mod Loader if needed.
  • Improved Dependency Installation: Automatically downloads and installs exact dependency versions
  • Enhanced Progress Feedback: Detailed progress during dependency installation
  • Automatic Runtime Installation: Fully automatic runtime installation in launcher

image

Note: The crashes appear to be related to garbage collector changes in .NET 9.0.5, though specific details are still being investigated.

Bug Fixes by @RyoTune

  • Fixed Config Reset Crashes: Fixed crashes when resetting configurations with different integer types (byte, short vs int)
  • Fixed Mod Template ConfigContext: Mod templates now properly set ConfigContext with IApplicationConfig
  • This allows mods to have per-application (per-game) configurations.

French Localization by @dysfunctionalriot

Complete French translation added! 🇫🇷 All text up to version 1.29.0 has been translated.


Complete Changes (Autogenerated)

1.29.1 - 2025-05-30

Merged

  • Added: Emergency Patch to rollback .NET 9.0.5 to 9.0.4 #597
  • Fix: Mod template ConfigContext not being set. #591
  • Add French translation #587
  • Fix crashes when resetting configs. #566

Commits

  • Fix crashes when resetting configs whenever the "DefaultValue" type did not match the target property. f13dc31
  • Added French translation 39ec4d8
  • Fix mod template config context not being set when loaded by the mod loader. ce91bb5
  • Changed: Force .NET 9.0.4 on the Loader, and install of exact dependency af293af
  • Updated: Download direct required version from automatic dependency installer 238ffc1
  • Changed: Use the dependency resolver from installer in Missing Dependencies Dialog c9342f1
  • Updated: Project Changelog f3b0560
  • Bumped: Version to 1.29.1 142e680
  • Changed: Build with 9.0.4 SDK so that launcher ends up being 9.0.4 14f089e

====

====

Available Downloads

(Below this text, on GitHub)

Setup.exe: This is a 1 click installer for Windows.
Setup-Linux.exe: This is a version of Setup.exe for easier use in WINE / Proton. Use Linux Setup Guide.
Release.zip: For people who prefer to install manually without an installer.
Tools.zip: Tools for mod authors and developers.

Other files are related to updates, you can ignore them.

1.29.0

21 Apr 00:42
Compare
Choose a tag to compare

Read and Discuss in a Browser.
Previous Changelog.

This release consists of community contributions; cleaned up and merged into the main project.

User Friendly Enums by @RyoTune

Thanks to @RyoTune it is now possible to give 'enums' user friendly named in mod configs;
before you had:

public enum SampleEnum
{
NoOpinion,
Sucks,
IsMediocre,
IsOk,
IsCool,
ILoveIt,
}

Which produced

image

With the new addition, it's now possible to add user friendly names to each configuration item:

public enum SampleEnum
{
[Display(Name = "No Opinion 🤷")]
NoOpinion,
[Display(Name = "It's Sucks! 👎")]
Sucks,
[Display(Name = "It's mediocre 😐")]
IsMediocre,
[Display(Name = "It's okay! 👍")]
IsOk,
[Display(Name = "It's cool! 😎")]
IsCool,
[Display(Name = "I Love It!!! ❤️🔥")]
ILoveIt,
}

image

Explicit Item Ordering by @RyoTune

image

[Display(Order = 0)]
public int OrderFirst { get; set; }

[Display(Order = 1)]
public int OrderSecond { get; set; }

[Display(Order = 2)]
public int OrderThird { get; set; }

Lower order means items come first.

Do note that this is inverted from the original PR; so if you originally wrote your mod against Reloaded II.5 ReMIX fork, it may be the opposite to what you expected.

Launcher Error Reporting by @TheBestAstroNOT + @Sewer56

image

Launcher errors now give you the option to print the error details to a text file.

image

Hopefully this is a bit friendlier for end users 🤞.

Improved Missing Loader Error by @TheBestAstroNOT + @Sewer56

Sometimes users do the following:

  • Use the Deploy ASI Loader feature in Reloaded, and then uninstall Reloaded.
  • Use the Deploy ASI Loader feature and then move the Reloaded folder.

image

The error message for missing Mod Loader DLL was updated to account for these situations.
The user is now explicitly let known how to resolve the error.


Complete Changes (Autogenerated)

1.29.0 - 2025-04-21

Merged

  • Add support for named enum values in configs. #560
  • Add support for ordering items in mod configs. #554
  • Fix mod template not including DEBUG blocks in created projects. #553
  • Updated: Reloaded.Mod.Template to Target NET 9 #545

Fixed

Commits

  • Updated: Reloaded.Mod.Template Target NET 9 11ed57b
  • Updated: CI Replace .NET 8 with .NET 9 install for template and reloaded-utils-server d8b78bb
  • Update: Target NET 9.0 for all NET 8.0 targets ef721fe
  • Deleted: Unused local packages aba1c5c
  • Add support for named Enum values in configs using the Display.Name attribute. d938ea3
  • Use default item priority for config items. 742d60d
  • Add example of named enum value to template. 7e12211
  • Made exception messageboxes more user friendly and moved stacktrace logging to log files c42c514
  • Added a blank line before the stacktrace message eb03c49
  • Removed the test exception 2fd6427
  • No longer prompts you to delete the dll 7f115ce
  • Requested changes. 7ae86a6
  • Miscellaneous Fixups before Merging 26d6f57
  • Cleanup: Stack Trace File Output now uses cleaner code. 31eb001
  • Added: Info of where to submit issues into stacktrace. bf5fc7c
  • Improved: Error for missing Loader Path 45364dc
  • Improved: Update Mod Template Config to Match Changelog a35685d
  • Errors: Use the new full error text. 270be3f
  • Changed to more user friendly 'View Error Details' text 062366b
  • Improved: Rendering of the error message d0954b0
  • Updated: The Changelog Template 0b45033
  • Publish: 1.29.0 update befdcfe

====

====

Available Downloads

(Below this text, on GitHub)

Setup.exe: This is a 1 click installer for Windows.
Setup-Linux.exe: This is a version of Setup.exe for easier use in WINE / Proton. Use Linux Setup Guide.
Release.zip: For people who prefer to install manually without an installer.
Tools.zip: Tools for mod authors and developers.

Other files are related to updates, you can ignore them.

1.28.8

23 Mar 21:48
Compare
Choose a tag to compare

If you are updating from version less than 1.28, install the following first


Read and Discuss in a Browser.
Previous Changelog.

1.28.8: A set of Bug fixes from @RyoTune

A fix for drag/drop:

  • Fixed: Drag and Drop now works everywhere on the main window for installing mods.

And various improvements to the Edit Mod dialog:

  • Fixed: unknown apps (games not added to Reloaded) being removed after a mod is edited via the GUI.
  • Added: Mods can now add support for unknown apps (games not added to Reloaded) via the UI.
  • Fixed: The view filter (search) in the Edit Mod dialog is reset on switching pages.
  • Added: You can now see the AppId of enabled games in the Edit Mod dialog.

And lastly, the default NuGet feed has been updated to https://packages.sewer56.moe/v3/index.json,
in both the documentation and program.

1.28.7: Fix Crash on Load Ordering with Keyboard/Controller

Moving a mod that was already at the end of the list further down (out of bounds) led to a crash.

This was somehow overlooked by everyone for years; it's fixed now.

1.28.6: Path/Location Warnings & Minor Theme Adjustment

image

image

OneDrive you want to avoid for performance reasons.
Special paths you want to avoid because some games don't support them well. Some games may fail to load custom assets out of the mod folders; Reloaded now warns about this indiscriminately.

image

Same as above. Sometimes people download old games through 'mysterious ways', place them in a special location and try to mod them before trying even an unmodded game. This way they'll hopefully know that the path may be a problem.

Before:

image

After:

image

In the interest of accessibility, and people using monitors with interesting contrast ratios; the following adjustment above was made.
The Reloaded theme was originally made on a cheap TN panel; however for some IPS displays and beyond, this change makes a lot of sense.


Complete Changes (Autogenerated)

1.28.8 - 2025-03-23

Merged

  • Enhancement: Better DragDrop behaviour and handling of unknown apps. #531

Commits

  • Fix DragDrop mod installing being blocked by other controls. e61218e
  • Improve handling of unknown supported apps in mods. db62509
  • Rename: Border_DragDropCapturer -> BorderDragDropCapturer fb6a07a
  • Fix mod DragDrop capturer blocking all drag events. 9516807
  • Implement unknown apps handling to ManageMods. 97f9edc
  • Fix DragDrop capturer name. 0be7de6
  • Fixed: MediatR Build for AutoIndexBuilder 91841a3
  • Changed: Hide invisible capture border only when the debugger is attached. 8014cab
  • Updated: Mod template to use new NuGet server 1be5d3e
  • Added: Changelog for latest version. bccd8a6
  • Bumped: Project Version(s) 1ad04ab
  • Changed: Default NuGet feed to https://packages.sewer56.moe/v3/index.json e561e16
  • Added: NuGet feed note to the changelog. 7b98aaf
  • Fixed: Remaining cases of old packages URL. 9eeaaa2
  • Fixed: Graphics Essentials test due to renames d3e6d33
  • Updated: Index Tests to use a newer NuGet Snapshot 1665eec

====

====

Available Downloads

(Below this text, on GitHub)

Setup.exe: This is a 1 click installer for Windows.
Setup-Linux.exe: This is a version of Setup.exe for easier use in WINE / Proton. Use Linux Setup Guide.
Release.zip: For people who prefer to install manually without an installer.
Tools.zip: Tools for mod authors and developers.

Other files are related to updates, you can ignore them.

1.28.7

13 Feb 23:54
Compare
Choose a tag to compare

If you are updating from version less than 1.28, install the following first


Read and Discuss in a Browser.
Previous Changelog.

1.28.7: Fix Crash on Load Ordering with Keyboard/Controller

Moving a mod that was already at the end of the list further down (out of bounds) led to a crash.

This was somehow overlooked by everyone for years; it's fixed now.

1.28.6: Path/Location Warnings & Minor Theme Adjustment

image

image

OneDrive you want to avoid for performance reasons.
Special paths you want to avoid because some games don't support them well. Some games may fail to load custom assets out of the mod folders; Reloaded now warns about this indiscriminately.

image

Same as above. Sometimes people download old games through 'mysterious ways', place them in a special location and try to mod them before trying even an unmodded game. This way they'll hopefully know that the path may be a problem.

Before:

image

After:

image

In the interest of accessibility, and people using monitors with interesting contrast ratios; the following adjustment above was made.
The Reloaded theme was originally made on a cheap TN panel; however for some IPS displays and beyond, this change makes a lot of sense.


Complete Changes (Autogenerated)

1.28.7 - 2025-02-13

Commits

  • Fixed: Crash when changing load order of mod with keyboard/controller (Ctrl+Arrow) beyond list bounds 7c92f44
  • Updated: Project Version to 1.28.7 a9d592b

====

====

Available Downloads

(Below this text, on GitHub)

Setup.exe: This is a 1 click installer for Windows.
Setup-Linux.exe: This is a version of Setup.exe for easier use in WINE / Proton. Use Linux Setup Guide.
Release.zip: For people who prefer to install manually without an installer.
Tools.zip: Tools for mod authors and developers.

Other files are related to updates, you can ignore them.

1.28.6

12 Dec 07:20
Compare
Choose a tag to compare

If you are updating from version less than 1.28, install the following first


Read and Discuss in a Browser.
Previous Changelog.

1.28.6: Path/Location Warnings & Minor Theme Adjustment

image

image

OneDrive you want to avoid for performance reasons.
Special paths you want to avoid because some games don't support them well. Some games may fail to load custom assets out of the mod folders; Reloaded now warns about this indiscriminately.

image

Same as above. Sometimes people download old games through 'mysterious ways', place them in a special location and try to mod them before trying even an unmodded game. This way they'll hopefully know that the path may be a problem.

Before:

image

After:

image

In the interest of accessibility, and people using monitors with interesting contrast ratios; the following adjustment above was made.
The Reloaded theme was originally made on a cheap TN panel; however for some IPS displays and beyond, this change makes a lot of sense.


Complete Changes (Autogenerated)

1.28.6 - 2024-12-12

Merged

  • Enhancement: Warn on R-II path in OneDrive/non-ascii on startup #518
  • Enhancement: AddApplication warns for OneDrive and non-ascii paths #516
  • Default Color Adjustments and Consistency for Accessibility #514
  • Chore: Update dependencies #497

Fixed

  • Enhancement: warn on R-II path in OneDrive/non-ascii on startup #502
  • Enhancement: AddApplication warns for OneDrive and non-ascii paths #503

Commits

  • Chore: upgrade dependencies 69c83e7
  • Updated: LoaderSettingsWarning style to TextblockWithColourChange f6be5c9
  • Updated: HalogenTheme update to themeBase 3.2.3 de03109
  • Updated: Reloaded.WPF & Theme.Default 3f0c7b9
  • Improved: Check Mods folder for OneDrive & specialchars df2bd58
  • Bumped: Project Version(s) ac6fd13

====

====

Available Downloads

(Below this text, on GitHub)

Setup.exe: This is a 1 click installer for Windows.
Setup-Linux.exe: This is a version of Setup.exe for easier use in WINE / Proton. Use Linux Setup Guide.
Release.zip: For people who prefer to install manually without an installer.
Tools.zip: Tools for mod authors and developers.

Other files are related to updates, you can ignore them.

1.28.5

30 Nov 15:41
Compare
Choose a tag to compare

If you are updating from version less than 1.28, install the following first


Read and Discuss in a Browser.
Previous Changelog.

1.28.5: More Miscellaneous Bug Fixes


Complete Changes (Autogenerated)

1.28.5 - 2024-11-30

Merged

  • Update: Link to 2022 C++ redists instead of 2019 #507
  • Enhancement: Fallback to SysDriveRoot on Install if OneDrive detected #504

Fixed

  • Enhancement: Fallback to SysDriveRoot on Install #477

Commits

  • Updated: Sanitize shortcut paths to ensure forward slashes & fix accidental slash removal e7f7b82
  • Improve: Also default to drive root if desktop path contains non-ASCII characters caeb468
  • Bumped: Version to 1.28.5 37c92e8

====

====

Available Downloads

(Below this text, on GitHub)

Setup.exe: This is a 1 click installer for Windows.
Setup-Linux.exe: This is a version of Setup.exe for easier use in WINE / Proton. Use Linux Setup Guide.
Release.zip: For people who prefer to install manually without an installer.
Tools.zip: Tools for mod authors and developers.

Other files are related to updates, you can ignore them.

1.28.4

29 Nov 14:27
Compare
Choose a tag to compare

If you are updating from version less than 1.28, install the following first


Read and Discuss in a Browser.
Previous Changelog.

1.28.4: Miscellaneous Bug Fixes


Complete Changes (Autogenerated)

1.28.4 - 2024-11-29

Merged

  • Fix: Sanitize AppName in MakeShortcutCommand #498
  • Enhancement: Confirm dialog for Mod Delete #499

Fixed

  • Enhancement: Confirm dialog for Mod Delete #269
  • Fix: Sanitize AppName in MakeShortcutCommand #481

Commits

  • Added: Sanitize file name for Protontricks shortcuts 8e01595
  • Added: some guidance in case installer fails to write shortcut. d1f32db
  • Bumped: Version to 1.28.4 67ce4f6

====

====

Available Downloads

(Below this text, on GitHub)

Setup.exe: This is a 1 click installer for Windows.
Setup-Linux.exe: This is a version of Setup.exe for easier use in WINE / Proton. Use Linux Setup Guide.
Release.zip: For people who prefer to install manually without an installer.
Tools.zip: Tools for mod authors and developers.

Other files are related to updates, you can ignore them.

1.28.3

13 Nov 04:20
Compare
Choose a tag to compare

Before installing this update, install the following first:

Normally Reloaded would do this automatically, but the Microsoft servers may be a bit behind again this year on release day.

We're now shipping with .NET 9, on day 1. The Runtime bug that blocked release last time is now fixed 👍.


Read and Discuss in a Browser.
Previous Changelog.

1.28.0: .NET 9 and Miscellaneous Improvements

Upgraded to .NET 9

Reloaded-II now ships with .NET 9 (currently RC2) as its runtime; given that no major issues have been reported thus far. This should give modders access to new APIs as well as performance improvements.

Improved: Running protontricks with certain Flatpak installs.

Many people running Protontricks via Flatpak rely on setting an alias to protontricks-launch via ~/.bashrc. In fact, the install guide recommends this.

However, the .desktop shortcuts generated by the installer previously did not account for this.

Exec=protontricks-launch --appid 3847140856 "/home/sewer/Desktop/Reloaded-II - Sonic Heroes/Reloaded-II.exe"

Because the command was not ran in a shell, ~/.bashrc was not being sourced; so the alias would not work for Flatpak users. Installs from the updated installer now create a shortcut that uses bash to invoke the command:

Exec=bash -ic 'protontricks-launch --appid 3847140856 "/home/sewer/Desktop/Reloaded-II - Sonic Heroes/Reloaded-II.exe"'

This should cause ~/.bashrc to be sourced; and hopefully the alias to work.

Note: Normally running a specific shell is not the best practice, however the whole installer itself is a hack and bash is ubiquitous enough that I can't name a distro that doesn't ship it out of the box.

Improved: Flickering on xwayland

Client side decorations (window glow) has been disabled by default on Linux; this reduces the amount of flicker encountered when running the application via Wine on Xwayland.

It also helps maximize screen real estate, the invisible border should no longer look 'weird' in tiling window managers.

Fixed: Auto Update Working Directory

Previously if you moved a game, you would need to move both the EXE Path and Working Directory in the Edit Application menu. This caused a lot of issues as users would not notice, and then get non-bootable games.

In this update, I've made the Working Directory adjust alongside the EXE Path. This preserves the relative path, in other words, if your working directory is 2 folders up, then the new working directory will also be 2 folders up.


Complete Changes (Autogenerated)

1.28.3 - 2024-11-13

Commits

  • Reapply "Merge branch 'test-net9'" e7c2a90
  • Bumped: Project Version to 1.28.3 0037b18

====

====

Available Downloads

(Below this text, on GitHub)

Setup.exe: This is a 1 click installer for Windows.
Setup-Linux.exe: This is a version of Setup.exe for easier use in WINE / Proton. Use Linux Setup Guide.
Release.zip: For people who prefer to install manually without an installer.
Tools.zip: Tools for mod authors and developers.

Other files are related to updates, you can ignore them.

1.28.2

18 Oct 17:49
Compare
Choose a tag to compare

If you are viewing on GitHub, you can find the downloads at the bottom of this post.

Read and Discuss in a Browser.
Previous Changelog.

1.28.0: .NET 9 and Miscellaneous Improvements

Upgraded to .NET 9

Reloaded-II now ships with .NET 9 (currently RC2) as its runtime; given that no major issues have been reported thus far. This should give modders access to new APIs as well as performance improvements.

Improved: Running protontricks with certain Flatpak installs.

Many people running Protontricks via Flatpak rely on setting an alias to protontricks-launch via ~/.bashrc. In fact, the install guide recommends this.

However, the .desktop shortcuts generated by the installer previously did not account for this.

Exec=protontricks-launch --appid 3847140856 "/home/sewer/Desktop/Reloaded-II - Sonic Heroes/Reloaded-II.exe"

Because the command was not ran in a shell, ~/.bashrc was not being sourced; so the alias would not work for Flatpak users. Installs from the updated installer now create a shortcut that uses bash to invoke the command:

Exec=bash -ic 'protontricks-launch --appid 3847140856 "/home/sewer/Desktop/Reloaded-II - Sonic Heroes/Reloaded-II.exe"'

This should cause ~/.bashrc to be sourced; and hopefully the alias to work.

Note: Normally running a specific shell is not the best practice, however the whole installer itself is a hack and bash is ubiquitous enough that I can't name a distro that doesn't ship it out of the box.

Improved: Flickering on xwayland

Client side decorations (window glow) has been disabled by default on Linux; this reduces the amount of flicker encountered when running the application via Wine on Xwayland.

It also helps maximize screen real estate, the invisible border should no longer look 'weird' in tiling window managers.

Fixed: Auto Update Working Directory

Previously if you moved a game, you would need to move both the EXE Path and Working Directory in the Edit Application menu. This caused a lot of issues as users would not notice, and then get non-bootable games.

In this update, I've made the Working Directory adjust alongside the EXE Path. This preserves the relative path, in other words, if your working directory is 2 folders up, then the new working directory will also be 2 folders up.


Complete Changes (Autogenerated)

1.28.2 - 2024-10-18

Commits

  • Fixed: I forgot to bump project version in emergency hotfix before sleep f8b85f9

====

====

Available Downloads

(Below this text, on GitHub)

Setup.exe: This is a 1 click installer for Windows.
Setup-Linux.exe: This is a version of Setup.exe for easier use in WINE / Proton. Use Linux Setup Guide.
Release.zip: For people who prefer to install manually without an installer.
Tools.zip: Tools for mod authors and developers.

Other files are related to updates, you can ignore them.

1.28.1

18 Oct 00:50
Compare
Choose a tag to compare

If you are viewing on GitHub, you can find the downloads at the bottom of this post.

Read and Discuss in a Browser.
Previous Changelog.

1.28.0: .NET 9 and Miscellaneous Improvements

Upgraded to .NET 9

Reloaded-II now ships with .NET 9 (currently RC2) as its runtime; given that no major issues have been reported thus far. This should give modders access to new APIs as well as performance improvements.

Improved: Running protontricks with certain Flatpak installs.

Many people running Protontricks via Flatpak rely on setting an alias to protontricks-launch via ~/.bashrc. In fact, the install guide recommends this.

However, the .desktop shortcuts generated by the installer previously did not account for this.

Exec=protontricks-launch --appid 3847140856 "/home/sewer/Desktop/Reloaded-II - Sonic Heroes/Reloaded-II.exe"

Because the command was not ran in a shell, ~/.bashrc was not being sourced; so the alias would not work for Flatpak users. Installs from the updated installer now create a shortcut that uses bash to invoke the command:

Exec=bash -ic 'protontricks-launch --appid 3847140856 "/home/sewer/Desktop/Reloaded-II - Sonic Heroes/Reloaded-II.exe"'

This should cause ~/.bashrc to be sourced; and hopefully the alias to work.

Note: Normally running a specific shell is not the best practice, however the whole installer itself is a hack and bash is ubiquitous enough that I can't name a distro that doesn't ship it out of the box.

Improved: Flickering on xwayland

Client side decorations (window glow) has been disabled by default on Linux; this reduces the amount of flicker encountered when running the application via Wine on Xwayland.

It also helps maximize screen real estate, the invisible border should no longer look 'weird' in tiling window managers.

Fixed: Auto Update Working Directory

Previously if you moved a game, you would need to move both the EXE Path and Working Directory in the Edit Application menu. This caused a lot of issues as users would not notice, and then get non-bootable games.

In this update, I've made the Working Directory adjust alongside the EXE Path. This preserves the relative path, in other words, if your working directory is 2 folders up, then the new working directory will also be 2 folders up.


Complete Changes (Autogenerated)

1.28.1 - 2024-10-18

Commits

  • Revert "Merge branch 'test-net9'" 670bd5d

====

====

Available Downloads

(Below this text, on GitHub)

Setup.exe: This is a 1 click installer for Windows.
Setup-Linux.exe: This is a version of Setup.exe for easier use in WINE / Proton. Use Linux Setup Guide.
Release.zip: For people who prefer to install manually without an installer.
Tools.zip: Tools for mod authors and developers.

Other files are related to updates, you can ignore them.