Skip to content
/ modio-ue Public

Unreal Engine Plugin for easily integrating mod.io into your game - the UGC management service for game developers

License

Notifications You must be signed in to change notification settings

modio/modio-ue

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

53 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mod.io

mod.io Unreal Engine Plugin

License Discord Master Docs Unreal Engine

Welcome to the mod.io Unreal Engine plugin repository. This plugin allows developers to implement mod.io support into their games, allowing developers to host and manage user-created mods into their Unreal Engine games. Its part of the mod.io suite of products, which includes Component UI (for building in-game UIs for discovery and consumption of UGC) and Modio UGC for dynamic management of mods via PAK files.

You can find a sample project demonstrating all core mod.io functionality here.

Engine & Platform Compatibility

The mod.io plugin is generally maintained to support the 3 most recent versions of Unreal Engine. If you are using an older version of the engine, you can access the last supported release of the engine from the Releases page.

Engine compatibility

Engine Version Last Release
UE4.26 2023.11
UE4.27 2023.11
UE5.0 2023.11
UE5.1 2024.6
UE5.2 2025.2
UE5.3 2025.9
UE5.4 Current
UE5.5 Current
UE5.6 Current

Platform compatibility

The mod.io plugin supports Windows, Linux, LinuxArm64, Mac, iOS and Android as part of the public release.

For access to Windows (GDK), XBox, Playstation 4, Playstation 5 or Switch, please contact us.

Features

  • C++ and Blueprint support
  • User Authentication via Email or Platform SSO
  • Mod Browsing & Filtering
  • Mod subscription management, automatic downloading and updating
  • Submission & management tools for Creators
  • Async delegate-based interface
  • Non-blocking IO
  • Permissive MIT/BSL-license

Documentation

Comprehensive documentation for this plugin including installation, getting started, and more can be found here.

Installation

Adding plugin files to your project

As a git submodule

  1. Add this repository as a submodule to your repository in your project's Plugins/Modio directory

    In the directory with your .uproject file:

    git submodule add https://github.com/modio/modio-ue Plugins/Modio
  2. Initialize our submodules:

    git submodule update --init --recursive

NOTE: On first run, or any time you update the git submodule for the plugin, you must set the MODIO_DEVELOPMENT_MODE environment variable to 1. This will tell the plugin to regenerate the files it produces from the internal copy of the mod.io C++ SDK. This environment variable does not need to be set if you are using the standalone release zips, or during normal development when you have not updated the Plugin via git. Once these files are regenerated, simply leave the environment variable unset and the regenerated files can be added to your version control system. This allows you to update the plugin via Git without interfering with daily use of Perforce or similar version control that requires files be marked read-only.

In a non-git project, or without submodules

  1. Grab the latest release zip from the Releases section on this page, and extract the contents to your project's Plugins/Modio directory

Get Latest Release Get Latest Release 2

NOTE: The automatically generated zips on the release page, or the 'Code' dropdown here, will not work! They do not contain our submodule dependencies.

Enabling the plugin

Start the editor, then enable the Modio Core plugin in the Unreal Engine settings: Plugin Window

Once this is done, you can configure the plugin and get started.

Plugin Configuration

The plugin requires some configuration information to behave correctly. You can access the configuration settings in the Project Settings window:

Plugin Settings

The settings have the following parameters:

Parameter Description
Game Id Your mod.io-provided Game Id for the target environment
API Key Your mod.io-provided API key for the target environment
Environment Your current environment, Live or Test
Log Level The default logging level to use. Messages with a lower log level will be silently discarded.
Portal The default portal to use. This usually corresponds to the store your game will be distributed through.
Use Background Thread Run the mod.io plugin on a managed background thread.

NOTE: The Test environment is available for usage in limited circumstances. All games should be setup on the Live environment. If you require access to Test, please contact us.

mod.io Plugin Suite

This plugin is a part of the full suite of mod.io suite to support implementation of UGC support in Unreal Engine.

Component & Template UI

Component & Template UI is a plugin for building an in-game mod browser & discovery UI. This includes a template for mod browsing, searching, collection management etc, as well as a set of components for customizing or building your own in-game UI. Component UI is available at the Component UI repository.

Modio UGC

Modio UGC is a plugin that facilitates dynamic management of UGC in the form of PAK files. Modio UGC is available at the Modio UGC Repository.

Game studios and Publishers

If you need assistance with 1st party approvals, or require a private, white-label UGC solution, Contact us to discuss.

Contributions Welcome

Our Unreal Engine plugin is public and open source. Game developers are welcome to utilize it directly, to add support for mods in their games, or fork it for their games customized use. Want to make changes to our plugin? Submit a pull request with your recommended changes to be reviewed.

About

Unreal Engine Plugin for easily integrating mod.io into your game - the UGC management service for game developers

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •