Unity Plugin Release

Version 2026.3

New Features

• New and improved Template UI with Carousels designed from premium presentation of UGC. Check out the SearchSettings prefabs to configure Carousels.
• Uploading Mod Monetization Teams from ModBuilder. Check ModBuilder.SetTeamMemberSplit to create a monetization team on mod uplod.

Changes

• Improved performance of ModGrid displaying Mod Tiles.
• Premium User Creations are now Subscribe-able by owners.
• Terms of Use are more dynamic, will now display Monetization Terms for games that have it enabled.
• Monetization Options are now retrieved from the mod.io game data.

Fixes

• Mod subscription, purchasd, disabled & created states not updating on User Logout.
• Collections grid not navigable by keyboard
• Controller sprites disappearing on PC.
• User.GetUserCreations encountering indefinite loop.
• Steamworks VC Marketplace purchase overlay not opening.

Unity Plugin Release

Version 2026.1

New Features

• Collections feature now supported in TUI and Component UI
• Virtual Currency name now supports custom name. See MonetizationSettings for fallback settings.
• Introducing Switch 2 experimental support.
• Xbox Cloud Sync now supported for syncing mod information across devices.
• Epic SSO now supported as an authentication method.
• USD Marketplace Feature Support
  • Supported with Steam (Steamworks & Facepunch)
  • Supported with Epic Online Services

Changes

• Improved GameData to be more reusable.
• C# Core is now decoupled from Unity dependencies so it can be used in C# applications
• Improved Xbox UserManager to be better in line with async practices.
• Introduced support to delete all mod media.
• Add API Interface information to User Agent Header
• Command line log args now support alias -modio-log & -modio-logLevel
• Ratings can now be queried from the User class

Fixes

• EmbeddedError causing error when using ErrorRef
• Attempting to reauthenticate during unrelated errors
• Wss Auth not working when selected from Auth Picker
• Default search tags being discarded
• Consoles defaulting to WSS
• Error when binding an Error Message with ModioServices
• Not subscribing after purchase
• Expired email auth tokens not allowing reauthentication
• ModioApiUnityClient sending incorrect line endings on certain platforms causing POST & PUT requests to fail
• User creations weren't updating when Syncing authenticated user data

GitHub Unity - https://github.com/modio/modio-unity/releases/tag/v2026.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

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.

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.

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.

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.

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.

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.

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