Releases: Reloaded-Project/Reloaded-II
1.29.1
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
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
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
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,
}
Explicit Item Ordering by @RyoTune
[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
Launcher errors now give you the option to print the error details to a text file.
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.
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
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 theEdit 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
- @dreamsyntax added warnings for when Reloaded and/or the
Mods
folder are placed in OneDrive, or are placed in a special path.
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.
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:
After:
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
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
- @dreamsyntax added warnings for when Reloaded and/or the
Mods
folder are placed in OneDrive, or are placed in a special path.
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.
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:
After:
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
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
- @dreamsyntax added warnings for when Reloaded and/or the
Mods
folder are placed in OneDrive, or are placed in a special path.
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.
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:
After:
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
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
- @dreamsyntax added a fallback to
C:/Reloaded
if the user uses OneDrive for their desktop. - @dreamsyntax updated the code to download Visual C++ 2022 instead of 2019, if missing.
- I (Sewer) extended the fallback to
C:/Reloaded
to also apply if the user has non-ASCII characters as that causes problems with some games. - Fixed an accidental breaking change from yesterday that caused Proton shortcuts to not be correctly placed.
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
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
- @dreamsyntax added a confirmation dialog for mod deletes
- @dreamsyntax sanitized the Application name when creating a shortcut, which should fix making shortcuts for Metaphor.
- And just in case I (Sewer) sanitized the path for Proton shortcuts.
- If the installer fails to create a shortcut on Linux, it will hint to the user that their
protontricks
permissions may be incorrect.
Complete Changes (Autogenerated)
1.28.4 - 2024-11-29
Merged
Fixed
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
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
====
====
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
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
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.