Skip to main content

Overview - Game client integration - (Unity module)

Last updated on March 12, 2025

Introduction

Typically, you need a backend service to act as a middleman to help your game client find a group of players and match those players with a game server. In this module, you learn how to use WebSocket to connect your game client to the sample matchmaking backend service we provided, which you can run locally.

However, if you intend to use your own backend service, you might need to modify the example code in this module. Alternatively, you can skip this tutorial altogether. Please refer to Claiming Dedicated Servers without AGS for what you need to do so your own backend service can be used with AMS.

Prerequisites

In order to complete this module, you need:

  • To have completed the following module:

  • The Byte Wars tutorialmodules-ams branch checked out in your local Byte Wars Unity project repository.

  • To force enable this module by adding the following code to the Assets/Resources/Modules/TutorialModuleConfig.json file:

    {
    "enableModulesOverride": true,
    "forceEnabledModules": ["CustomMatchmaking"],
    "forceDisabledOtherModules" : true
    }

Learning objectives

By the end of this module, you will learn how to:

  • Connect game client to the sample matchmaking backend service to perform matchmaking.

Preview

At the end of this module, your project will look like the image below:

Custom matchmaking demo Unity Byte Wars Client integration