Clone and set up sample matchmaking backend service - Initial setup - (Unreal Engine module)

Last updated on March 12, 2025

Clone the sample matchmaking backend service​

Through out all of the Byte Wars AMS Unreal modules, you will use the sample matchmaking backend service. You will run this sample backend service locally on your computer to connect your game clients with your dedicated servers hosted on AMS.

The sample matchmaking backend service is available on AccelByte GitHub repository. You can use the Git command below to clone the project.

git clone https://github.com/AccelByte/ams-samples.git
info

Refer to this page if you want to know more about integrating AMS into a custom or third party services.

Setup the sample matchmaking backend service​

The sample matchmaking backend service requires some prerequisites for it to run which are listed in the requirements.txt. Follow the steps below to set them up:

  1. In your cloned sample matchmaking backend service, you will see a folder named matchmaking-server. Go inside of it and open a Command Prompt or Windows Powershell there.

  2. Install the prerequisites that are listed in the requirements.txt by using this command:

    python -m pip install -r requirements.txt
info

If you encountered issues installing the requirements, pay attention to the error. It usually have the exact command you need to run to fix it. But, there are some errors that are not so obvious. Here we provide a list of error that you may encountered and a fix for it:

  • The system cannot find the file specified: 'C:\\Python311\\Scripts\\wheel.exe' -> 'C:\\Python311\\Scripts\\wheel.exe.deleteme: the solution is to run this command: python -m pip install --upgrade wheel
info

If you know how to use docker and already have docker in you machine. We also have provided you dockerfile to setup a container for it with all the prerequisites. Read the README.md within the matchmaking-server folder to learn more.

Last updated on

On this page