v2025.10.1

Unity Plugin Release

Version 2025.10.1

HOTFIX

Fixed the below bugs (introduced in 2025.10):

• Not returning correct error codes (breaking first time users SSO)
• Reauthenticating on all 401 responses
• Not passing auth token to all methods
• Invalid User-Agent string

GitHub Unity - https://github.com/modio/modio-unity/releases/tag/v2025.10.1

v2025.10

Unity Plugin Release

Version 2025.10

New Features

• PC Logout & Login method selection with TUI. See the Modio Component UI Settings object to enable.
• User Creations have been added to the Library tab in TUI. In the Library, click Filters > User Creations to view all creations made by the user & that the user has been added as a tester to.
• Tools > mod.io > Open Cache has been added for developer convenience to inspect the installed mods on the file system.

Changes

• [Android] Google Play Games authentication service code has been wrapped in a precompile directive to avoid compile errors on platforms such as the Meta Quest. Please add MODIO_GOOGLE_PLAY_GAMES to precompiles to enable.
• [Nintendo Switch] Further optimizations have been made to Switch file storage, including the ability to store mods as a ZIP. Please see Modio Switch Settings object to enable.

Fixes

• Empty tags on a Mod would result in null reference exceptions when attempting to use the MobBuilder to edit the Mod.
• Visibility on the ModBuilder was inverted, incorrectly setting the visibility of mods.
• name-id was being set by the ModBuilder, causing issues when editing mods or making new mods with similar names.
• Install progress would inconsistently update on some large file sizes.
• If the User Data would become corrupted the plugin had no way of handling this.
• Expired tokens would not automatically be re-provisioned, requiring users to re-initialize the plugin/game to do so.
• Entering sleep mode with an active download would cause the install queue to become stuck, preventing any further mod installs until the plugin/game was re-initialized.

v2025.9.2

Unity Plugin Release

Version 2025.9.2

HOTFIX

Fixed the below bugs:

• Duplicate boundaries in create mod requests would result in validation errors when using the ModioApiUnityClient.
• Some more edge cases where duplicate bytes would be read when processing zips, resulting in errors and incomplete mod installs.

v2025.9.1

Unity Plugin Release

Version 2025.9.1

HOTFIX

Fixed the below bugs:

• Some edge cases where certain zips would fail to extract fully, resulting in errors and incomplete mod installs.
• Mods uploaded via the plugin would result in validation errors when using the ModioApiUnityClient.

v2025.9

Unity Plugin Release

Version 2025.9

Important
This release includes a substantial number of changes to prefabs for the TemplateUI. Please back up your projects if upgrading to this version.

New Features

• TemplateUI theme system, all colours and fonts can be conveniently configured with a single style sheet.
  • See Modio/Unity/UI/ThemeSheets/ and the new Theme System Settings in your mod.io config object to get started.
• Settings events, you can now listen out for changes to the mod.io config object during run-time.
• Supported Platforms is now accessible from the Mod class.

Changes

• Nintendo Switch Module now adheres to all guidelines, see documentation for more information.

Fixes

• [TemplateUI] Fixed controllers not scrolling down Filter Window.
• Various issues related to downloads.
• MetadataKVPs with multiple instances of keys, even with different values, were preventing the browser from showing mods.

v2025.8.2

Unity Plugin Release

Version 2025.8.2

New Features

• Nintendo Switch is now fully supported.
• iOS is now fully supported.
• Android is now fully supported.
• Web Secure Sockets is now available as an authentication method.
• Mod Deletion/Archiving has been added to the ModBuilder class.
• Mod Collections have been implemented, see ModCollection.GetCollections to get started with them.

Changes

• Android & Meta Quest files have been moved to the /UnityCache/ sub-directory. Both platforms will no longer back-up modfiles. Existing installs will be migrated to the new sub-directory.
  • Note: Users mods might not appear as installed on first start up with this patch as the plugin will be migrating mods to the new location.
• Subscribed mods will now show subscribed private mods.

Fixes

• Cancelling downloads mid operation occasionally caused the job to get stuck.
• [Marketplace] Token packs would not show correctly on the first launch of the game.
• The plugin was installing mods in the wrong directory in editor.
• GetUserCreations was not actually getting the user creations.
• Builds with the plugin would fail in unusual ways with higher AoT stripping.
• Steamworks.NET auth implementation failed to get the encrypted app ticket correctly.

v2025.6

Unity Plugin Release

Version 2025.6

LEGACY PLUGIN DEPRECATION

If you are currently using 2025.2 or older, please be aware there has been a major update requiring non-trivial code changes. Please see the readme for more details.

New Features

• Xbox Series X & Xbox One are now fully supported.
• PlayStation 4 & PlayStation 5 are now fully supported.
• Nintendo Switch is still undergoing QA.
• Linux is now fully supported.
• MacOS is now fully supported.
• Mods installed with V2 will be updated, with their data converted into V3 compatible data automatically.

Unity Asset Store

• V3 has now been pushed to the Unity Asset Store. The Asset Store page will now be automatically updated with each release.

Changes

• The compilation directives UNITY_STEAMWORKS & UNITY_FACEPUNCH have been replaced with MODIO_STEAMWORKS & MODIO_FACEPUNCH. A warning will appear in your console if the old directives are still present.
• When creating Modfiles using the ModfileBuilder class, the Platform value is now an enum with pre-defined constrained values. You will need to update your code.

Fixes

• [Meta Quest] Fixed an issue where the Mod Browser would get stuck on "Waiting..." when offline.
• [Meta Quest] Fixed an issue that would cause installs to always fail.
• Fixed an issue where a Mod's Mod.File.InstallLocation was incorrect.
• Fixed an issue where 'Retry Installing Mod' would bypass the disk space check, causing errors.
• Fixed a few issues with selection across the browser UI.

v2025.5

Unity Plugin Release

Version 2025.5

LEGACY PLUGIN DEPRECATION

If you are currently using 2025.2 or older, please be aware there has been a major update requiring non-trivial code changes. Please see the readme for more details.

Console Platforms

• QA is underway for full console support, reach out to us for a preview of these platform modules.

Documentation

• docs.mod.io/unity has been properly updated with new documentation.

Changes

• Shutdown is now silent, no longer throwing errors from modules shutting down correctly.
• ModfileBuilder Set & Append Platforms now takes a ModfileBuilder.Platforms enum value instead of raw strings.

Fixes:

• Fixed mod logo & media uploads through the ModBuilder class.
• Fixed the portal header not being correctly applied to web requests on some platforms.
• ModioUnityPlatformExampleLoader is no longer missing from the .unitypackage.
• Fixed temporary mods being uninstalled immediately after being installed.
• Fixed Mod.File.InstallLocation not being set
• Fixed location of installed mods not matching legacy location

v2025.4

Unity Plugin Release

Version 2025.4

LEGACY PLUGIN DEPRECATION

The old codebase (coined V2) is now deprecated and will only be receiving major bug fixes. You can find the legacy code base in the legacy/v2 branch on the main Repo. This and subsequent versions are not compatible with anything before version 2025.4.

TemplateUI & ComponentUI Move out of Experimental

TemplateUI & ComponentUI have been moved out of Experimental and are the primary UI interfaces to use with the plugin. Check out the Readmes in Modio/Unity/UI to learn more.

Optimized Mod Installing
We simplified how mods are installed with fewer IO operations needed. Mods will install considerably faster and with fewer writes to the file system to do so.

This can be optionally disabled with the older system still maintained.

Simplified and Intuitive Interfaces
No longer need to get the mod, the installed mod and the user installed mod all as separate requests. Just get a Mod class and you can do everything you need to from there.

Highly Modular and Extensible. Designed to be Customized.
Thanks to the Services system most core functionality can be overridden as independent modules, allowing developers to easily and cleanly modify the plugin's behavior and implementations. This especially benefits platform implementation, with decoupled interfaces giving you complete freedom to implement services to suit your needs (if the defaults don't!).

Better Settings
Settings are no longer all coupled together in one object, they’ve now been neatly broken up into the base settings required for any functionality, with settings modules that can be easily added and removed depending on your needs.

Advanced Debugging Menu
Included with the plugin is an advanced debug menu which can modify the plugin state and even produce dummy errors so you can see how the plugin and your implementation reacts.

This is dynamically built off of the modules bound in the Services system, meaning you shouldn’t have to do anything for this menu to work. Simply add the setting ‘Modio Enable Debug Menu’ and it should appear.

v2025.2

Unity Version Deprecation:

• Unity 2020 is now deprecated
• Unity 2023 is now deprecated

Unity LTS Version Support:
mod.io Unity version support matches Unity LTS support

• 2021.3
• 2022.3
• Unity 6

New Features:

• GOG Galaxy SSO Authentication

Deprecating:

• Browser UI is undergoing deprecation see the readme for more information.

Fixes:

• (Meta Quest) (TemplateUI) Token purchase error message buttons not doing anything.
• (Meta Quest) (TemplateUI) Wallet buttons on certain screens not doing anything.
• (Meta Quest) (TemplateUI) Cancelling purchases resulted in an error.
• (Meta Quest) (TemplateUI) Sometimes SSO would fail due to race condition
• (Steam Deck) (TemplateUI) Virtual keyboard wouldn't appear when entering a text field.
• (Consoles) (TemplateUI) Incorrect buttons were shown on certain screens.
• (TemplateUI) Filter options resetting when selection sort options.
• (TemplateUI) Duplicate mod tags.
• (TemplateUI) Fixed a crash when attempting to navigate the mod list without an authenticated account.
• (TemplateUI) Downloading/subscribing caused results to disappear from the Library tab.
• (TemplateUI) Filter options resetting when swapping between Trending & Recent pages.
• (TemplateUI) Missing icon for purchased mods