Multiplay SDK - Unity Testbed

Last updated: May 29, 2026

Set up and run the Multiplay Unity testbed, including client and server builds, Multiplay configuration, QoS testing, and direct connect.

Prerequisites

Before continuing, ensure the following are installed and available:

  • Linux Server Platform Build Module

  • Windows 10/11 or Linux development environment


Build the Executables

Build the executables for both the client and server.

Unity Client

Build Client

  1. Open the project.

  2. In the top task bar, select DedicatedGameServerSample → Builds.

  3. Select Toggle All Clients (or the specific client you want).

  4. Select Build Client(s).

  5. Navigate to: mp-Unity-Testbed\Experimental\DedicatedGameServer\Builds\Client\Windows

  6. Run Game.exe.

Unity Server

Build Server

  1. Open the project.

  2. In the top task bar, select DedicatedGameServerSample → Builds.

  3. Select Toggle All Servers (or the specific server you want).

  4. Select Build Server(s).

  5. The server build will be located at: mp-Unity-Testbed\Experimental\DedicatedGameServer\Builds\Server\Linux64


Configure Multiplay

Upload the server build to your Multiplay build configuration. After uploading, create a Build Configuration.

Note The first time the build is uploaded it may take up to 5 minutes to sync.

Example Launch Parameters

-port  -queryport  -logFile /Engine.log

Create Fleet

Create a Fleet for this Build Configuration in your local region.


Useful Unity Link

Unity Dedicated Server Sample: https://github.com/Unity-Technologies/com.unity.multiplayer.samples.bitesize/tree/main/Experimental/DedicatedGameServer


QoS

How to Run

  1. Open TestScene.

  2. Select the QosTestInit GameObject.

  3. In the Inspector, configure:runTest — run oncealwaysRun — run continuouslydelay — time between tests when running continuously

  4. Press Play.

Expected Output

Latency and packet loss values will appear in the console for the available regions.


Direct Connect

Purpose

Provides a basic UI to connect a client to a server via direct IP and port.

In Editor

  1. Open StartupScene.

  2. Select Client from the Multiplayer Role selector.

  3. Press Play.

  4. Click Join with Direct IP.

  5. Enter:Server IPServer Port

  6. If successful, the client will connect to the hosted server and transition to another scene.

From Client Build

  1. Navigate to your client build. Example location: mp-Unity-Testbed\Experimental\DedicatedGameServer\Builds\Client\Windows

  2. Run Game.exe.

  3. Click Join with Direct IP.

  4. Enter:Server IPServer Port

  5. If successful, the client will connect to the hosted server and transition to another scene.

Example Expected Successful Logs

Client started.
Unity services initialized