The Simpl plugin for Unreal is new. Expect it to change. The Simpl plugin lets your Unreal game use Simpl lobbies and matchmaking. You do not have to write web requests yourself.

What is in it

The plugin has two parts.
  • SimplClient runs in your players’ game. It creates and joins lobbies, enters the queue, listens for events, and gives your game the server address.
  • SimplServer runs in your game server. It reads its_simpl.json, tells Simpl when the server is ready, and ends the match.
Your game uses a client key for all of this. It never uses a server key.

Engine versions

  • Unreal 4.27.2 is the tested version. The client has been used in live matches on Simpl with it.
  • Unreal 5.7.x builds from source, but has not been used in a live match.
  • Other 5.x versions are untested.

Get the plugin

The plugin comes as source code, so your project must be a C++ project.
  1. Download the Simpl plugin zip from the Releases page. The current version is 0.2.0 (pre-release).
  2. Unpack it to Plugins/Simpl in your project.
  3. Right-click your .uproject file and generate the project files, then build.
  4. Open the project and check that Simpl is turned on in Edit > Plugins.

Use it from C++

Add the modules to your game module’s Build.cs:
You need SimplServer too, because the value type for player state lives there.

Where to go next

Setup

Add your client key and version tag.

Lobbies

Create, join and manage lobbies.

Queues and matches

Find a match and connect. Includes a short C++ example.

Server side

What the game server part does.
To build and upload your game server, see Unreal Engine. To set up queues, see Setting Up Matchmaking.